# Update auf Windows

Diese Seite dokumentiert, wie Updates von Squeeze auf Windows durchzuführen sind.

Die Update-Schritte sind i. d. R. gleich, je nach Produktversion können allerdings einzelne Sonder-Tätigkeiten wie z. B. das aktivieren einer PHP-Extension notwendig sein.

### Grundsätzliches Vorgehen

#### 1. Update des htdocs Ordners

Der htdocs enthält den Programmcode von Squeeze und stellt i. d. R. die einzige zu aktualisierende Komponente dar.

[![image-1658235368553.png](https://docs.squeeze.one/uploads/images/gallery/2022-07/scaled-1680-/image-1658235368553.png)](https://docs.squeeze.one/uploads/images/gallery/2022-07/image-1658235368553.png)

##### Schritte

1. Datenbankbackup erstellen!
2. SQUEEZE Dienste beenden
3. htdocs Verzeichnis sichern
4. neues htdocs Verzeichnis im SQUEEZE Verzeichnis entpacken / <span data-teams="true">SQUEEZE-Update-2.xx.x.exe als Administrator auf dem Server ausführen</span>
5. Im htdocs\\Worker-Verzeichnis muss die umzug.json enthalten sein, sie muss aus dem gesicherten htdocs Verzeichnis kopiert werden.  
    [![image-1641982910834.png](https://docs.squeeze.one/uploads/images/gallery/2022-01/scaled-1680-/image-1641982910834.png)](https://docs.squeeze.one/uploads/images/gallery/2022-01/image-1641982910834.png)
6. Ggf. sicherstellen ob Jobs aus dem alten htdocs\\jobs Verzeichnis in das neue htdocs\\jobs Verzeichnis kopiert werden müssen.
7. SQUEEZE Dienste wieder starten
8. Datenbankmigration über die Web-Oberfläche ausführen: [![image-1658235122650.png](https://docs.squeeze.one/uploads/images/gallery/2022-07/scaled-1680-/image-1658235122650.png)](https://docs.squeeze.one/uploads/images/gallery/2022-07/image-1658235122650.png)

Zur Durchführung einer Datenbankmigration muss unter dem Reiter Migrationen das Symbol "Migration Ausführen" angeklickt werden.

[![image-1650887454008.png](https://docs.squeeze.one/uploads/images/gallery/2022-04/scaled-1680-/image-1650887454008.png)](https://docs.squeeze.one/uploads/images/gallery/2022-04/image-1650887454008.png)

Tragen Sie nun den Mandantennamen in das angegebene Feld ein und klicken Sie auf "Speichern" um die Migration auszuführen.

[![image-1650887530401.png](https://docs.squeeze.one/uploads/images/gallery/2022-04/scaled-1680-/image-1650887530401.png)](https://docs.squeeze.one/uploads/images/gallery/2022-04/image-1650887530401.png)

Nun kann über den Reiter "System" die aktuelle Version des Systems angezeigt werden.

[![image-1658235236599.png](https://docs.squeeze.one/uploads/images/gallery/2022-07/scaled-1680-/image-1658235236599.png)](https://docs.squeeze.one/uploads/images/gallery/2022-07/image-1658235236599.png)

<div id="bkmrk-"></div>#### 2. Update von anderen Komponenten

<p class="callout info">Die folgenden Schritte sind nicht bei jedem Update notwendig. Sie müssen nur beachtet werden, falls eine der vermerkten Versionen zum Einsatz kommt und die notwendigen Voraussetzen nicht erfüllt sind.</p>

##### PHP Extension - sodium (ab Squeeze Version 2.3.0)

Ab Squeeze 2.3.0 wird die PHP Extension Sodium benötigt.

Die Datei kann unter  **\\Squeeze\\php\\php.ini** gefunden werden. In der Datei nach "Sodium" suchen und in der entsprechenden Zeile das Semikolon entfernen:

[![image-1671027876113.png](https://docs.squeeze.one/uploads/images/gallery/2022-12/scaled-1680-/image-1671027876113.png)](https://docs.squeeze.one/uploads/images/gallery/2022-12/image-1671027876113.png)

<p class="callout info">Auf manchen Windows Systemen reicht es nicht aus die sodium Extension hinzuzufügen. In diesem Fall muss zusätzlich das PHP Verzeichnis z.B. D:\\SQUEEZE\\php in die PATH Umgebungsvariable aufgenommen werden. </p>

Anschließend muss der Webserver einmal neu gestartet werden.

##### OpCache deaktivieren (jede Squeeze Version)

1. opcache für CLI Prozesse deaktivieren (opcache.enable\_cli=0 in der php.ini)

##### Chromium (ab Squeeze Version 1.7.0)

**Ab Squeeze 1.7.0** wird Chromium für das PDF-Rendering von E-Mails verwendet. \[[Download](https://github.com/macchrome/winchrome/releases/download/v111.5563.71-M111.0.5563.71-r1097615-Win64/ungoogled-chromium-111.0.5563.71-1_Win64.7z)\]

Der Inhalt des [Downloads](https://github.com/macchrome/winchrome/releases/download/v111.5563.71-M111.0.5563.71-r1097615-Win64/ungoogled-chromium-111.0.5563.71-1_Win64.7z) muss in den Ordner **htdocs\\lib\\chromium** kopiert werden. Hierbei handelt es sich um eine "google-freie" Version von Chromium in der Version **111.0.5563.71**. Die Funktionalität wurde mit dieser Chromium-Version getestet und nur in dieser Version kann eine fehlerfreie Ausführung gewährleistet werden.

**Ab Squeeze 2.4.0**: Wenn Chromium erfolgreich eingebunden ist, kann dies in der in der Systemprüfung unter dem Punkt "**CLI Services - Health Checks for availability**" eingesehen werden. Ansonsten wird hier ein Fehler angezeigt.

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