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.

Schritte

1. Datenbankbackup erstellen!
2. SQUEEZE Dienste beenden
3. htdocs Verzeichnis sichern
4. neues htdocs Verzeichnis im SQUEEZE Verzeichnis entpacken
5. Im htdocs\Worker-Verzeichnis muss die umzug.json enthalten sein, sie muss aus dem gesicherten htdocs Verzeichnis kopiert werden.
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:

   

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

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

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

2. Update von anderen Komponenten

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.

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:

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. 

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]

Der Inhalt des Downloads 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.