# SQUEEZE Admin FAQ

Sammlung von Hilfsartikeln, die keiner anderen Gruppe zugeordnet sind.

# 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

[![image-1584346136560.png](https://docs.squeeze.one/uploads/images/gallery/2020-03/scaled-1680-/image-1584346136560.png)](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584346136560.png)

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

#### 2. Aufgabe erstellen

[![image-1584346394020.png](https://docs.squeeze.one/uploads/images/gallery/2020-03/scaled-1680-/image-1584346394020.png)](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584346394020.png)

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

[![image-1584346802279.png](https://docs.squeeze.one/uploads/images/gallery/2020-03/scaled-1680-/image-1584346802279.png)](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584346802279.png)

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

[![image-1584347128210.png](https://docs.squeeze.one/uploads/images/gallery/2020-03/scaled-1680-/image-1584347128210.png)](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584347128210.png)

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**

<div id="bkmrk-die-vollst%C3%A4ndige-ang"><div><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div>Die vollständige Angabe der Argumente lautet also wie folgt:</div></div></div>**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:

<div id="bkmrk-d%3A%5Csqueeze%5Cmariadb%5Cb"><div><div><div>```
<span role="presentation">D:\SQUEEZE\mariadb\b<span class="cm-keyword">in</span>\mysqldump.exe <span class="cm-attribute">--user</span><span class="cm-operator">=</span>root <span class="cm-attribute">--password</span><span class="cm-operator">=</span><span class="cm-string">""</span> <span class="cm-attribute">--host</span><span class="cm-operator">=</span><span class="cm-number">127</span>.0.0.1 <span class="cm-attribute">--protocol</span><span class="cm-operator">=</span>tcp <span class="cm-attribute">--port</span><span class="cm-operator">=</span><span class="cm-number">3306</span> <span class="cm-attribute">--default-character-set</span><span class="cm-operator">=</span>utf8 <span class="cm-attribute">--routines</span> <span class="cm-attribute">--events</span> <span class="cm-attribute">--databases</span> <span class="cm-string">"datenbankname"</span> <span class="cm-attribute">--result-file</span><span class="cm-operator">=</span><span class="cm-string">"D:\Squeeze\Backup\datenbank.sql"</span></span>
```

</div></div><div></div><div><div>Der Schalter `--databases` ist nicht nur für die Selektion der Datenbank verantwortlich, sondern steuert ebenfalls, ob ein **Create Statement des Schemas** in den dump exportiert werden soll. Soll das Create Statement nicht erstellt werden, muss der Schalter</div></div></div></div>`--databases` entfernt werden.

##### Backup aller Datenbanken

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

<div id="bkmrk-mysqldump---user%3Droo"><div><div><div><div></div></div><div>```
<span role="presentation">mysqldump <span class="cm-attribute">--user</span><span class="cm-operator">=</span>root <span class="cm-attribute">--password</span><span class="cm-operator">=</span><span class="cm-string">""</span> <span class="cm-attribute">--host</span><span class="cm-operator">=</span><span class="cm-number">127</span>.0.0.1 <span class="cm-attribute">--protocol</span><span class="cm-operator">=</span>tcp <span class="cm-attribute">--port</span><span class="cm-operator">=</span><span class="cm-number">3306</span> <span class="cm-attribute">--default-character-set</span><span class="cm-operator">=</span>utf8 <span class="cm-attribute">--routines</span> <span class="cm-attribute">--events</span> <span class="cm-attribute">--all-databases</span> <span class="cm-attribute">--result-file</span><span class="cm-operator">=</span><span class="cm-string">"D:\Squeeze\Backup\alle_datenbank.sql"</span></span>
```

</div></div><div></div><div><div>Entscheidend ist der Schalter `--all-databases`</div></div></div><div>Dieser Schalter erfordert keine weiteren Parameter.  
<svg height="16" viewbox="0 0 24 24" width="16" xmlns="http://www.w3.org/2000/svg"></svg></div></div>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:

<p class="callout warning">Sollte die Datenbank bereits bestehen, werden hiermit alle vorhandenen Daten mit denen des Backups überschrieben.</p>

<div id="bkmrk-d%3A%5Csqueeze%5Cmariadb%5Cb-0"><div><div><div>```
<span role="presentation">D:\SQUEEZE\mariadb\b<span class="cm-keyword">in</span>\mysql.exe <span class="cm-attribute">-u</span> root <span class="cm-attribute">-p</span> <span class="cm-string">"datenbankname"</span> < <span class="cm-string">"D:\Squeeze\Backup\datenbank.sql"</span></span>
```

</div></div><div></div><div><div></div></div></div><div><svg height="16" viewbox="0 0 24 24" width="16" xmlns="http://www.w3.org/2000/svg"></svg></div></div><p class="callout info">Da jeder Mandant seine eigene Datenbank hat, ist die Aufgabe je Mandant/Datenbank zu planen.</p>

# Aufgabe: Periodischer Worker Neustart

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

<div data-lang="code highlight" id="bkmrk-%40echo-off-set-dienst"><textarea style="display: none;">@echo off set DIENSTNAME1="05\_SQUEEZE\_Worker" net stop %DIENSTNAME1% 2&gt;nul if errorlevel 2 ( echo Dienst ist bereits gestoppt . . . Starte %DIENSTNAME1% net start %DIENSTNAME1% ) net start %DIENSTNAME1% </textarea><div><div><textarea spellcheck="false" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;" tabindex="0">&lt;span id="mce\_marker" data-mce-type="bookmark"&gt;​&lt;/span&gt;&lt;span id="\_\_caret"&gt;\_&lt;/span&gt;&lt;span id="mce\_marker" data-mce-type="bookmark"&gt;​&lt;/span&gt;&lt;span id="\_\_caret"&gt;\_&lt;/span&gt;&lt;span id="mce\_marker" data-mce-type="bookmark"&gt;​&lt;/span&gt;&lt;span id="\_\_caret"&gt;\_&lt;/span&gt;</textarea></div><div><div>```
<span class="line" id="bkmrk-%40echo-off" lang="batchfile">@echo <span class="na">off</span></span>
<span class="line" id="bkmrk-set-dienstname1%3D%2205_" lang="batchfile"> <span class="kd">set</span> <span class="kd">DIENSTNAME1</span><span class="o">=</span><span class="s2">"05_SQUEEZE_Worker"</span></span>
<span class="line" id="bkmrk-net-stop-%25dienstname" lang="batchfile"> <span class="nb">net</span> <span class="kd">stop</span> <span class="vm">%DIENSTNAME1</span><span class="err">%</span> <span class="m">2</span><span class="o">></span><span class="kr">nul</span></span>
<span class="line" id="bkmrk-if-errorlevel-2-%28" lang="batchfile"> <span class="k">if</span> <span class="ow">errorlevel</span> <span class="m">2</span> <span class="o">(</span></span>
<span class="line" id="bkmrk-echo-dienst-ist-bere" lang="batchfile">   <span class="nb">echo</span> <span class="kd">Dienst</span> <span class="kd">ist</span> <span class="kd">bereits</span> <span class="kd">gestoppt</span> . . . <span class="kd">Starte</span> <span class="vm">%DIENSTNAME1</span><span class="err">%</span></span>
<span class="line" id="bkmrk-net-start-%25dienstnam" lang="batchfile">   <span class="nb">net</span> <span class="nb">start</span> <span class="vm">%DIENSTNAME1</span><span class="err">%</span></span>
<span class="line" id="bkmrk-%29" lang="batchfile"> <span class="o">)</span></span>
<span class="line" id="bkmrk-net-start-%25dienstnam-0" lang="batchfile"> <span class="nb">net</span> <span class="nb">start</span> <span class="vm">%DIENSTNAME1</span><span class="err">%</span></span>
```

</div></div><div></div><div><div><div></div></div></div></div></div>#### 1. Aufgabe erstellen

[![worker-restart-aufgabe-erstellen.png](https://docs.squeeze.one/uploads/images/gallery/2020-10/scaled-1680-/worker-restart-aufgabe-erstellen.png)](https://docs.squeeze.one/uploads/images/gallery/2020-10/worker-restart-aufgabe-erstellen.png)

[![5l4worker-restart-sys&prio.png](https://docs.squeeze.one/uploads/images/gallery/2020-10/scaled-1680-/5l4worker-restart-sys&prio.png)](https://docs.squeeze.one/uploads/images/gallery/2020-10/5l4worker-restart-sys&prio.png)

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

[![worker-restart-Neuer-Trigger.png](https://docs.squeeze.one/uploads/images/gallery/2020-10/scaled-1680-/worker-restart-Neuer-Trigger.png)](https://docs.squeeze.one/uploads/images/gallery/2020-10/worker-restart-Neuer-Trigger.png)

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

#### 3. Aktion festlegen

[![worker-restart-aktion.png](https://docs.squeeze.one/uploads/images/gallery/2020-10/scaled-1680-/worker-restart-aktion.png)](https://docs.squeeze.one/uploads/images/gallery/2020-10/worker-restart-aktion.png)

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:

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

[![image-1612455016437.png](https://docs.squeeze.one/uploads/images/gallery/2021-02/scaled-1680-/image-1612455016437.png)](https://docs.squeeze.one/uploads/images/gallery/2021-02/image-1612455016437.png)