SQUEEZE Admin FAQ

Sammlung von Hilfsartikeln, die keiner anderen Gruppe zugeordnet sind.

• Email-Verarbeitung (Windows)
• Datenbank Backup und Restore (Windows)
• Aufgabe: Periodischer Worker Neustart
• ElasticSearch Speicher erweitern

Email-Verarbeitung (Windows)

Um regelmäßig auf neue Emails zu prüfen, muss eine geplante Aufgabe eingerichtet werden.
Unter Windows können dafür die geplanten Tasks genutzt werden.
Unter Linux erfolgt die Einrichtung mit Hilfe von cron Jobs.

Einrichtung unter Windows

Unter Windows kann ein geplanter Task zur Regelmäßigen Prüfung der konfigurierten Postfächer genutzt werden.
Um einen neuen Task einzurichten müssen folgende Schritte durchgeführt werden:

1. Aufgabenplanung öffnen

Es kann eine eigener Unterordner für Squeeze aufgaben erstellt werden, wenn dies gewünscht ist

Auf der rechten Seite kann über den Menüpunkt "Aufgabe erstellen..." die Aufgabe für den Import der Emails angelegt werden.

2. Aufgabe erstellen

Der Name und die Beschreibung ist natürlich frei wählbar.

Damit die Aufgabe unabhängig von der Anmeldung eines Benutzers ausgeführt wird und auch unabhängig von eventuellen Passwortänderungen ist, hat sich bewährt, das System Konto auszuwählen. 

Die Aufgabe "mit höchsten Privilegien" zu starten hat sich ebenfalls bewährt.

3. Trigger/Zeitpunkt festlegen

Das Intervall in dem die Emails abgerufen werden sollen ist ebenfalls frei definierbar.
Bewährt hat sich ein Intervall von 5 Minuten im Produktivsystem. Für Testsysteme kann dieser Intervall natürlich auch kleiner gewählt werden, wenn schnell und viel getestet werden soll. 

4. Aktion festlegen

Als Programm muss die php.exe der Squeeze Installation ausgewählt werden. 
Als Argumente müssen zwei Werte angegeben werden:

• - Pfad zur EmailProcessing.php z.B. C:\SQUEEZE\htdocs\jobs\EmailProcessing.php
• - Mandant für den die Emails abgerufen werden sollen z.B. client.squeeze.net

C:\SQUEEZE\htdocs\jobs\EmailProcessing.php client.squeeze.net

Datenbank Backup und Restore (Windows)

Backup

Das sichern der SQUEEZE Datenbank(en) ist ein wichtiger Punkt der Administration. Um Sicherzustellen, dass im Fehlerfall nicht alle Daten verloren gehen, muss eine regelmäßiges Backup der Datenbanken durchgeführt werden.

Für MariaDB und MySQL kann folgender Befehl genutzt werden:

D:\SQUEEZE\mariadb\bin\mysqldump.exe --user=root --password="" --host=127.0.0.1 --protocol=tcp --port=3306 --default-character-set=utf8 --routines --events --databases "datenbankname" --result-file="D:\Squeeze\Backup\datenbank.sql"

--databases entfernt werden.

Backup aller Datenbanken

Um alle Datenbanken eines Servers zu sichern kann der folgende Befehl genutzt werden

mysqldump --user=root --password="" --host=127.0.0.1 --protocol=tcp --port=3306 --default-character-set=utf8 --routines --events --all-databases --result-file="D:\Squeeze\Backup\alle_datenbank.sql"

Die Aufgabe des Backups sollte zeitlich geplant werden. Dazu kann die Aufgabenplanung des Betriebssystems genutzt werden.
Die Parameter sind natürlich entsprechend der Installation anzupassen.

Restore

Um eine Datenbank aus einer Sicherung wiederherzustellen kann dieser Befehl genutzt werden:

Sollte die Datenbank bereits bestehen, werden hiermit alle vorhandenen Daten mit denen des Backups überschrieben.

D:\SQUEEZE\mariadb\bin\mysql.exe -u root -p "datenbankname" < "D:\Squeeze\Backup\datenbank.sql"

Da jeder Mandant seine eigene Datenbank hat, ist die Aufgabe je Mandant/Datenbank zu planen.

Aufgabe: Periodischer Worker Neustart

Für einen periodischen Neustart des Workers benötigen wir folgendes Script, welches als ".bat" gespeichert wird.

@echo off
 set DIENSTNAME1="05_SQUEEZE_Worker"
 net stop %DIENSTNAME1% 2>nul
 if errorlevel 2 (
   echo Dienst ist bereits gestoppt . . . Starte %DIENSTNAME1%
   net start %DIENSTNAME1%
 )
 net start %DIENSTNAME1%

1. Aufgabe erstellen

Der Name und die Beschreibung ist natürlich frei wählbar.

Damit die Aufgabe unabhängig von der Anmeldung eines Benutzers ausgeführt wird und auch unabhängig von eventuellen Passwortänderungen ist, hat sich bewährt, das System Konto auszuwählen. 

Die Aufgabe "mit höchsten Privilegien" zu starten hat sich ebenfalls bewährt.

2. Trigger/Zeitpunkt festlegen

Das Intervall in dem der Worker neu gestartet werden soll ist frei definierbar.

3. Aktion festlegen

Als Programm wird die Oben erstellte ".bat" (worker restart.bat) ausgewählt. 

ElasticSearch Speicher erweitern

Windows

Unter Windows kann eine kleine GUI Anwendung genutzt werden, um die Parameter des ElasticSearch Dienstes anpassen zu können:

C:\SQUEEZE\elasticsearch\bin\elasticsearch-service.bat manager 03_SQUEEZE_SearchEngine