XELOS 9 Update
Vorbereitung
Von SQL auf Elastic wechseln
Wenn die SQL-Suche noch aktiv ist, kann kein Upgrade ausgeführt werden. Es muss vor dem Update eine Umstellung auf Elastic Search und falls noch nicht erfolgt auf Docker durchgeführt werden.
Backup anlegen
Es muss sichergestellt werden, dass ein Backup vorhanden ist
Fehlende Version 8 Pakete
Bevor ein Update auf Version 9 durchgeführt werden kann, müssen alle verfügbaren XELOS 8 Pakete installiert werden.
PHP Version aktualisieren mit Docker
Für XELOS 9 ist PHP 7.4 notwendig. Sollte die nicht schon vorhanden sein, kann die Version einfach über Docker aktualisiert werden.
Schritte zur Aktualisierung:
Öffnen Sie die Datei docker-compose.yml und passen sie das image auf xelos-9 an:
[...] services: web: image: xelos/xelos-server:xelos-9 [...]
Sie finden die aktuelle Docker-Referenz-Datei unter https://bitbucket.org/blueend/xelos-docker/ falls Sie weitere Fragen zum Aufbau haben. Es wird empfohlen beim Update auch andere Container, falls noch nicht geschehen zu aktualisieren.
Danach laden Sie die Updates aller Container und erstellen diese mit folg. Befehlen neu:
docker-compose pull docker-compose up -d
Update ausführen
Nach dem das Image erfolgreich aktualisiert wurde, kann das Update ausgeführt werden.
Update und Lizenz Upgrade
Modul anpassen
Suche
Eventuell muss unter Suche Maintenance der Suchindex aktualisiert werden.
Tasks
System Status
Eventuell hat sich beim Update ein vorheriger Check reaktiviert, der wieder deaktiviert werden soll.
Laufen nach dem Update alle Dienste (Achtung: Cron-Fehler können durch das Update angezeigt werden, dieser Status sollte auch 24 Stunden nach dem Upgrade nochmal überprüft werden. Falls der Shell-Plugin-Cron Fehler anzeigt, kann dieser deaktiviert werden.)
System PWA
Zur Installation und Verwendung Benachrichtigungen
XELOS 9 Theme
Benachrichtigungen
Nach dem Update auf 9 sind alle Benachrichtigungen aktiv, sollte dies nicht gewünscht sein, muss dies angepasst werden.
Hilfestellung für Probleme
Sollte das Update unterbrochen werden oder ein Fehler in der Suche oder im DMS angezeigt werden, mit xf update die Abhängigkeiten aktualisieren.
docker-compose exec web bash php xf update
Ist das System nach kurzer Wartezeit noch nicht erreichbar
php xf update:abort
den aktuellen Prozess einmal abbrechen und anschließend über die Weboberfläche neustarten. (Hintergrund: Normalerweise sind zum o.g. Zeitpunkt schon alle XELOS Apps aktualisiert und es ist eine interne Bibliothek [Composer], die einen Fehler wirft. Dieser Fehler tritt in der Wiederholung normal nicht mehr auf)