Aktualisierung von Allegra

Aktualisierung von Allegra#

Dieses Kapitel beschreibt, wie Allegra auf Windows-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 standardmäßig im Installationsverzeichnis abgelegt).

Vorbereitung#

Bevor Sie beginnen, stellen Sie Folgendes sicher:

  • Allegra ist gestoppt (siehe 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 Administratorrechte

  • Im <INSTALLATION_DIRECTORY> steht ausreichend freier Speicherplatz zur Verfügung

Zusammenfassung#

Führen Sie im <INSTALLATION_DIRECTORY> die folgenden Befehle in dieser Reihenfolge aus:

# Allegra stoppen
allegra.bat stop
# oder, falls als Dienst installiert, über die Windows-Diensteverwaltung stoppen.

# Allegra aktualisieren
allegra.bat update

# Allegra starten
allegra.bat start
# oder, falls als Dienst installiert, über die Windows-Diensteverwaltung starten.

# Version prüfen
allegra.bat version

Bemerkung

Das <INSTALLATION_DIRECTORY> enthält die Programmdateien und Skripte von Allegra. Während der Einrichtung erstellt Allegra außerdem ein separates <ALLEGRA_HOME>-Verzeichnis, in dem alle Anhänge und Konfigurationsdateien gespeichert werden. Erstellen Sie vor jeder Aktualisierung stets Sicherungen beider Verzeichnisse.

Aktualisierung des Verwaltungsskripts#

Eine Aktualisierung des Verwaltungsskripts (allegra.ps1) 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 das Skript bei Bedarf auch manuell prüfen und aktualisieren:

  1. Nach Skript-Updates suchen

    allegra.bat check-script-updates

  2. Skript aktualisieren

    allegra.bat update-script

    Dieser Befehl lädt die neueste Version des Skripts herunter und installiert sie, wobei vor dem Ersetzen eine Sicherungskopie (allegra.ps1.backup) erstellt wird.

Bemerkung

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

Fehlerbehebung#

Häufige Probleme und deren Lösungen:

  • Update-Download schlägt fehl – Internetverbindung oder Firewall-Einstellungen prüfen

  • Allegra startet nicht – allegra-startup.log auf Fehler überprüfen

  • Datenbankverbindungsfehler – Sicherstellen, dass der Datenbankserver läuft und erreichbar ist

  • Speicherfehler (Out of Memory) – Speicherzuteilung mit allegra.bat setup-memory erhöhen

Nächste Schritte#

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

  1. Anwendungsstart überprüfen

    Vergewissern Sie sich, dass Allegra korrekt startet und im Browser erreichbar ist.

  2. Protokolle prüfen

    Überprüfen Sie <ALLEGRA_HOME>\log\allegra.log auf Fehler oder Warnungen.

  3. Datenbankverbindung prüfen

    Stellen Sie sicher, dass Allegra erfolgreich eine Verbindung zur konfigurierten Datenbank herstellen kann.

  4. Benutzer informieren

    Benachrichtigen Sie die Benutzer, sobald die Aktualisierung abgeschlossen und getestet wurde.