Aktualisierung von Allegra#

Dieses Kapitel beschreibt, wie Allegra auf Ubuntu/Debian-Systemen aktualisiert wird, die mit der ZIP-Paket-Methode installiert wurden.

Achtung

Bevor Sie aktualisieren, stellen Sie sicher, dass Sie ein vollständiges Backup Ihrer Datenbank und Ihres $ALLEGRA_HOME -Verzeichnisses besitzen (dieses enthält Anhänge, Vorlagen und Konfigurationsdateien — definiert während der Installation und in der Regel getrennt vom Installationsverzeichnis).

Vorbereitung#

Bevor Sie beginnen, stellen Sie Folgendes sicher:

Allegra ist gestoppt (siehe „Zusammenfassung“ unten)
Backups der Datenbank und des $ALLEGRA_HOME-Verzeichnisses sind erstellt
Java 21 JRE/JDK ist installiert und im System-PATH verfügbar
Sie verfügen über sudo-Rechte (wenn Allegra als systemd-Dienst läuft)
Es steht genügend freier Speicherplatz im <INSTALLATION_DIRECTORY> zur Verfügung

Zusammenfassung#

Führen Sie im <INSTALLATION_DIRECTORY> (z. B. /opt/allegra oder /home/ubuntu/allegra) die folgenden Befehle der Reihe nach aus:

# Allegra stoppen (Standalone)
./allegra.sh stop

# Wenn als systemd-Dienst installiert:
# sudo systemctl stop allegra

# Allegra aktualisieren
./allegra.sh update

# Allegra starten (Standalone)
./allegra.sh start

# Wenn als systemd-Dienst installiert:
# sudo systemctl start allegra

# Version prüfen
./allegra.sh version

Bemerkung

Das <INSTALLATION_DIRECTORY> enthält die Programmdateien und Skripte von Allegra. Während der Einrichtung wurde außerdem ein separates $ALLEGRA_HOME-Verzeichnis erstellt, in dem Allegra alle Anhänge und Konfigurationsdateien speichert. Sichern Sie Datenbank und $ALLEGRA_HOME immer, bevor Sie eine Aktualisierung durchführen.

Aktualisierung des Verwaltungsskripts#

Eine Aktualisierung des Verwaltungsskripts (allegra.sh) ist nur selten erforderlich. Wenn eine neuere Version benötigt wird, weist Allegra in der Regel automatisch während des normalen Update-Vorgangs darauf hin.

Sie können auch manuell prüfen und aktualisieren:

Nach Skript-Updates suchen
```
./allegra.sh check-script-updates
```
Skript aktualisieren
```
./allegra.sh update-script
```
Dieser Befehl lädt die neueste Version des Skripts herunter und installiert sie, überprüft dabei die Prüfsummen und erstellt vor dem Ersetzen eine Sicherungskopie (allegra.sh.backup).

Bemerkung

Das Aktualisieren des Skripts erfordert kein Stoppen von Allegra. Das Skript wird nur für administrative Aufgaben verwendet, nicht für den Serverprozess selbst.

Fehlerbehebung#

Häufige Probleme und deren Lösungen:

Update-Download schlägt fehl – Internetverbindung oder Firewall prüfen; ggf. manuell herunterladen
Allegra startet nicht – Überprüfen Sie allegra-startup.log und $ALLEGRA_HOME/log/catalina.out
Datenbankverbindungsfehler – Sicherstellen, dass der Datenbankserver läuft und erreichbar ist; Zugangsdaten mit ./allegra.sh show-config prüfen
Speicherfehler (Out of Memory) – Speicher mit ./allegra.sh setup-memory erhöhen
Dienst startet nicht (systemd) – sudo systemctl status allegra und sudo journalctl -u allegra prüfen

Nächste Schritte#

Nach erfolgreicher Aktualisierung führen Sie folgende Prüfungen durch, um sicherzustellen, dass die Installation korrekt funktioniert:

Anwendungsstart überprüfen Vergewissern Sie sich, dass Allegra korrekt startet und im Browser erreichbar ist.
Protokolle überprüfen Prüfen Sie $ALLEGRA_HOME/log/catalina.out auf Fehler oder Warnungen.
Datenbankverbindung prüfen Stellen Sie sicher, dass Allegra erfolgreich eine Verbindung zur konfigurierten Datenbank herstellen kann.
Benutzer informieren Benachrichtigen Sie die Benutzer, sobald das Update abgeschlossen und getestet ist.

Bewährte Vorgehensweisen#

Führen Sie regelmäßige Updates durch (z. B. monatlich)
Lesen Sie die Release Notes vor jeder Aktualisierung
Sichern Sie immer Datenbank und $ALLEGRA_HOME
Testen Sie Updates, wenn möglich, zuerst in einer Staging-Umgebung
Bewahren Sie mindestens 7 Tage an Backups auf und testen Sie regelmäßig deren Wiederherstellung