Upgrade von Avantra Server

Ab Avantra 24.0 Server wird nur Java 17 unterstützt.

Bevor Sie Ihr Avantra-System aktualisieren, lesen Sie bitte die Upgrade-Hinweise, die Seite mit Änderungen in den Release Notes und die Seite mit bekannten Problemen. Wenn Sie Fragen zu einer dieser Änderungen haben, wenden Sie sich bitte an den Avantra-Support. Wenn Sie mehrere Haupt-/Nebenversionen auf einmal aktualisieren, lesen Sie auch die Hinweise und Änderungen für alle übersprungenen Versionen.

Wenn Sie ein Upgrade Ihres Avantra-Servers planen, stellen Sie bitte sicher, dass Sie zuerst ein Datenbank-Backup durchführen. Viele (aber nicht alle) Avantra-Server-Upgrades und -Patches führen Änderungen an der zugrunde liegenden Datenbankstruktur durch, was ein Downgrade im Falle eines Problems verhindert.

Da ein Downgrade des Avantra-Servers nicht möglich ist, kann eine Datenbankwiederherstellung erforderlich sein. Es liegt in Ihrer Verantwortung sicherzustellen, dass ein verfügbares Datenbank-Backup bereitsteht, um im Falle eines Problems darauf zurückzugreifen.

Upgrade des Avantra-Servers (Linux)

Verfahren: Upgrade des Avantra-Servers unter Linux

  1. Melden Sie sich am Server an und stoppen Sie die Avantra-Dienste. Sie können Ihre Avantra-Dienste entweder mit systemd oder über die Avantra-RC-Dateien stoppen (systemctl wird empfohlen).

    $ sudo systemctl stop avantra-server
$ sudo systemctl stop avantra-ui

    ODER

    $ /opt/avantra/master/rc.master stop
$ /opt/avantra/xangui/rc.xangui stop

  2. Wechseln Sie zum Dienstbenutzer, der Ihre Avantra-Dienste ausführt, und wechseln Sie in das Avantra-Verzeichnis. Im folgenden Beispiel wird davon ausgegangen, dass der Dienstbenutzer avantra heißt und Avantra im Verzeichnis /opt/avantra installiert ist.

    $ sudo su avantra
avantra$ cd /opt/avantra/

  3. Laden Sie avantra-server-24.0.n-linux.bin vom Avantra Customer Hub herunter und stellen Sie sicher, dass die Datei ausführbar ist:

    avantra$ curl -o avantra-server-24.0.n-linux.bin 'https://........link...from...customer...hub....'
avantra$ chmod +x avantra-server-24.0.n-linux.bin

  4. Führen Sie das Upgrade Ihrer Avantra-Dienste durch

    Beachten Sie, dass wir in diesem Fall das Flag --no-start verwenden, damit wir unsere Avantra-Dienste nach dem Upgrade manuell mit systemctl neu starten können. Wenn Sie die Dateien rc.master oder rc.xangui zum Starten und Stoppen Ihrer Dienste verwenden, benötigen Sie das Flag --no-start nicht.

    avantra$ ./avantra-server-{product-release-n}-linux.bin -- --no-start

  5. Starten Sie Ihre Avantra-Dienste neu

    Zuerst wechseln wir mit exit zurück zu einem sudo-fähigen Benutzer.

    avantra$ exit
$ sudo systemctl start avantra-server
$ sudo systemctl start avantra-ui

    ODER

    avantra$ /opt/avantra/master/rc.master start
avantra$ /opt/avantra/xangui/rc.xangui start
Nachdem Ihr Upgrade abgeschlossen ist, müssen Sie sich als Administrator in die UI einloggen, um den Abschluss aller Datenbankmigrationen auszulösen. Bis Sie dies tun, können sich nicht-administrative Benutzer möglicherweise nicht anmelden.

Upgrade des Avantra-Servers (Windows)

Folgen Sie diesen Schritten, um Ihre Avantra Server-Komponenten auf Version 24 zu aktualisieren:

Procedure: Ausführen des Avantra Windows Installers

  1. Laden Sie avantra-server-24.0.n-win64.exe vom Avantra Customer Hub herunter.

  2. Öffnen Sie den Installer, drücken Sie Weiter auf dem Begrüßungsbildschirm und akzeptieren Sie die Lizenz mit der Option Ich stimme zu auf dem Lizenzbildschirm.

  3. Sie werden aufgefordert, entweder den Avantra Server, die UI oder beides zu installieren. Normalerweise belassen Sie die Standardeinstellung und installieren beides. Drücken Sie Weiter, um fortzufahren.

  4. Wählen Sie einen geeigneten Installationsort und drücken Sie Weiter.

  5. Wählen Sie die Ports für eingehende HTTP- und/oder HTTPS-Verbindungen der Web-UI. Sie können die Schaltfläche Ports überprüfen drücken, um zu überprüfen, ob die Ports frei sind. Drücken Sie Weiter.

  6. Überprüfen Sie die Konfigurationsregeln der Windows Firewall, die in Ihrem System hinzugefügt/aktualisiert werden. Drücken Sie Weiter, um fortzufahren.

  7. Wählen Sie den (Windows)-Benutzer aus, unter dem die Windows-Dienste ausgeführt werden sollen. Wenn Sie die Windows-Authentifizierung für den Microsoft SQL Server verwenden (was in Schritt 4 der Procedure: Installing Microsoft SQL Server Express Edition standardmäßig ist), stellen Sie sicher, dass Sie hier denselben Benutzer verwenden wie für den Microsoft SQL Server.

    Wenn Sie den Befehl in Schritt 4 der Procedure: Installing Microsoft SQL Server Express Edition nicht geändert haben, belassen Sie es hier bei LocalSystem. Wenn Ihr Microsoft SQL Server mit einem anderen Benutzer läuft, geben Sie denselben Benutzer ein. Drücken Sie Weiter, um fortzufahren.

  8. Drücken Sie Installieren.

  9. Stellen Sie auf dem letzten Bildschirm sicher, dass UI und Server installieren aktiviert ist, und drücken Sie Fertigstellen.