Voraussetzungen
❗Bevor Sie die neue Version der STP Common Services installieren, sichern Sie bitte Ihr gesamtes System. So können Sie im Fehlerfall die gesamte Umgebung wiederherstellen.
❗Damit die Installation ordnungsgemäß abläuft, muss das Homedrive auf ein lokales Laufwerk (in der Regel C:) zeigen. Überprüfen Sie dies in der Eingabeaufforderung. Wird ein Netzlaufwerk angezeigt, können Sie einen lokalen Administrator anlegen und die folgenden Update-Schritte mit diesem durchführen.
- Die neue STP.CommonServices.Main.Setup-1.6.530.0.exe ist verfügbar.
- Das Update kann mit einem Administratorkonto durchgeführt werden.
- Das Update kann während einer Downtime erfolgen, da alle STP-Client-Apps und STP-Services gestoppt werden müssen.
Schritt-für-Schritt-Update
Alle Clients stoppen
Alle STP-Client-Anwendungen müssen gestoppt werden
Beachten Sie, dass der DMS LCAS im Hintergrund laufen und automatisch gestartet werden kann. Es muss sichergestellt sein, dass auch alle LCAS-Instanzen gestoppt sind.
Alle Cloud-Connectoren müssen gestoppt werden
Durch das Stoppen aller Clients und Connectoren wird verhindert, dass Nachrichten an die lokalen STP-Anwendungsdienste gesendet werden.
Sicherstellen, dass alle persistenten Queues in RabbitMq leer sind
Permanente Queues sind in der RabbitMq Management Console als "durable" gekennzeichnet.
Öffnen Sie die RabbitMq Management Console und prüfen Sie die Anzahl der Nachrichten!
>Die Konsole kann entweder über http://localhost:15672 (auf dem Rechner, auf dem RabbitMq installiert ist) oder über http://SERVERNAME:15672 geöffnet werden.
>Der Benutzer ist „stpuser“, das Passwort finden Sie z. B. in der Konfigurationsdatei des STP.UserManagement („C:\Program Files (x86)\STP AG\STP UserManagement Service\STP.Common.Services.exe.config“) oder in Ihrem Installationsbericht.
Auf der Übersichtsseite muss die Gesamtanzahl der Nachrichten 0 sein. Wenn noch Nachrichten angezeigt werden, gehen Sie auf die Seite „Queues“:
Hier sehen Sie die verbleibenden Queues. Die mit einem „D“ unter Features gekennzeichneten sind die persistenten Queues. Unter „Total“ sehen Sie die aktuelle Nachrichtenanzahl dieser Queues. Für Queues, die noch Nachrichten enthalten, versuchen Sie, den zugehörigen Dienst neu zu starten und prüfen Sie, ob die Nachrichten verarbeitet werden (Anzahl = 0 oder nimmt ab, weil Nachrichten verarbeitet werden). Nachdem die Queues keine Nachrichten mehr enthalten, können auch die STP-Anwendungsdienste gestoppt werden. Nun sollte nichts mehr mit RabbitMq verbunden sein.
STP-Services stoppen
Je nach installierten Produkten gibt es eine entsprechende Liste von Diensten, die alle gestoppt werden müssen.
> Bitte beachten Sie, dass diese Abbildung nur ein Beispiel ist und auf Ihrem System auch andere Dienste wie beA Desk und winsolvenz vorhanden sein können. Diese sollten ebenfalls beendet werden.
RabbitMq stoppen
Unter Dienste finden Sie den RabbitMq-Dienst und können ihn stoppen.
Alte RabbitMq-Version deinstallieren
Achtung: Es wurde festgestellt, dass manchmal die epdm.exe von Erlang während der Deinstallation blockiert ist. Gehen Sie in diesem Fall zum Task-Manager (als Administrator ausführen), suchen Sie nach epdm.exe und beenden Sie diesen Prozess.
Falls der Deinstallationsprozess weiterhin Probleme macht, gehen Sie in den Erlang-Ordner und benennen Sie die epdm.exe um:
Gehen Sie zum Erlang-Installationsordner C:\Program Files\Erlang OTP\erts-14.2.5.9\bin und benennen Sie die epdm.exe Datei um (z. B. epdem.exe_old).
Je nach Installation kann sich der Erlang-Installationsordner auch unter C:\Program Files\erl-23.3\erts-11.2\bin befinden.
Achtung: Gelegentlich erkennt Windows das Ende eines Installations- oder Deinstallationsvorgangs nicht korrekt. In diesem Fall können Sie keine neue Installation/Deinstallation starten und Windows meldet, dass noch ein anderer Prozess läuft. Um dieses Problem zu beheben, ist ein Neustart des Systems erforderlich.
Öffnen Sie zuerst „Apps und Features“.
Die Deinstallation erfolgt in drei Schritten.
- Suchen Sie nach „RabbitMq Server 3.8.14“, wählen Sie „Entfernen“ und bestätigen Sie die folgenden Deinstallationsseiten.
- Suchen Sie nach „Erlang OTP 23“ und wählen Sie „Entfernen“.
Bestätigen Sie die folgenden Deinstallationsseiten:
- Suchen Sie nach „STP.Common.Services“ und wählen Sie „Entfernen“. Bestätigen Sie die folgenden Deinstallationsseiten:
Aktuellen RabbitMq-Datenordner umbenennen
Unter C:\programdata\STP AG\ befindet sich der Ordner „LEXolution Service Bus“. Benennen Sie diesen um (z. B. „LEXolution Service Bus_old“), um zu verhindern, dass er während der Installation der neuen RabbitMq-Version verändert wird.
Die Ordner für Erlang (oft „Erlangen“ genannt) und RabbitMq können gelöscht werden. Andernfalls kann es bei der Neuinstallation zu Problemen kommen.
Registry-Eintrag löschen
In seltenen Fällen kann es notwendig sein, den Registry-Schlüssel „Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\Erlang“ manuell zu löschen.
STP-Startskripte deaktivieren
Während des Updates sollten Sie die Aufgabe „STP-Dienste_sicher-starten“ im Aufgabenplaner (Verwaltung/Aufgabenplanung) im Ordner „STP“ deaktivieren, bevor Sie das Serversystem neu starten. Diese muss zu einem späteren Zeitpunkt wieder aktiviert werden.
Serversystem neu starten
Bevor Sie mit der Installation der neuen Version fortfahren, empfehlen wir, das Serversystem neu zu starten.
Neue RabbitMq-Version installieren
❗Damit die Installation ordnungsgemäß abläuft, muss das Homedrive auf ein lokales Laufwerk (in der Regel C:) zeigen. Überprüfen Sie dies in der Eingabeaufforderung:
Geben Sie „set“ ein, um eine Liste aller Umgebungsvariablen zu erhalten. Die Variable „HOMEDRIVE“ sollte auf C: zeigen (HOMEDRIVE=C:). Zeigt sie auf einen anderen Ort (z. B. ein Netzlaufwerk) und wurde das Netzlaufwerk von einem lokalen Administrator erstellt, muss das Update mit diesem Benutzer durchgeführt werden. Falls dies nicht funktioniert, konfigurieren Sie es vor der Installation um. Bitte befolgen Sie zuerst die vorherigen Anweisungen, bevor Sie diese Methode verwenden.
Führen Sie die Datei STP.CommonServices.Main.Setup-1.6.530.0.exe aus und gehen Sie die Setup-Seiten durch:
Bitte beachten Sie, dass für das Setup Administratorrechte erforderlich sind.
Willkommensseite
Drücken Sie „Weiter“ …
STP LEXolution Bus Konfiguration
In den meisten Fällen kann die Standardkonfiguration (Benutzername und Passwort) verwendet werden. Falls das Passwort in der alten Konfiguration abwich, sollten Sie es wiederverwenden (es steht in der Installationsdokumentation).
Nach der Konfiguration auf „Weiter“ klicken …
Bestätigen Sie die Installation von Erlang und seinen Komponenten
Drücken Sie „Weiter“ …
Der Standard-Installationsort sollte verwendet werden.
Der Standard-Menüordner sollte verwendet werden.
Nach der Installation von Erlang wird RabbitMq installiert. Bestätigen Sie alle Seiten des RabbitMq-Setups.
Die Standardkomponenten sollten verwendet werden.
Der Standard-Installationsort sollte verwendet werden.
Abschließend startet eine Konsolenanwendung und konfiguriert RabbitMq entsprechend der eingegebenen Konfiguration. >❗Diese Konsolenanwendung dient zur Konfiguration von RabbitMQ und kann mehrere Minuten dauern. Das Fenster schließt sich automatisch, sobald der Vorgang abgeschlossen ist. Bitte schließen Sie es auf keinen Fall manuell, da dies zu einem inkonsistenten Zustand führt und das System unbrauchbar macht.
Die Installation endet mit der Seite „Installation abgeschlossen“, die bestätigt werden kann.
Bestätigen
RabbitMq-Installation validieren
Anschließend sollte die RabbitMq-Installation überprüft werden. Öffnen Sie die RabbitMq Management Console in einem Browser und melden Sie sich mit dem für die Konfiguration vergebenen Benutzernamen und Passwort an.
Achtung: Da die Management Console zuvor im Browser mit der alten RabbitMq-Version geöffnet wurde, werden im Browser vermutlich noch alte Artefakte zwischengespeichert. Öffnen Sie die Management Console daher am besten in einem privaten Browserfenster oder in einem anderen Browser.
Die RabbitMq Management Console sollte eine Seite ähnlich dieser anzeigen:
STP-Startskripte reaktivieren
Nun sollte im Aufgabenplaner (Verwaltung/Aufgabenplanung) die Aufgabe „STP-Dienste_sicher-starten“ im Ordner „STP“ wieder aktiviert werden.
Serversystem neu starten
Sobald die vorherigen Schritte abgeschlossen sind, empfehlen wir, das Serversystem neu zu starten.
Wenn etwas schiefgelaufen ist
Trotz aller Sorgfalt kann nicht ausgeschlossen werden, dass ein Fehler auftritt. Falls das Update nicht fehlerfrei abgeschlossen werden kann und RabbitMq nicht lauffähig ist, muss der Vorgang wiederholt werden. Starten Sie den Computer neu und führen Sie das Update erneut Schritt für Schritt gemäß Anleitung durch. Sollte auch der zweite Versuch scheitern, empfehlen wir, das System aus dem System-Backup wiederherzustellen und es auf dem frisch gestarteten System erneut zu versuchen.
Dieser Artikel wurde automatisch von einer KI übersetzt und kann daher Fehler enthalten.
Verknüpfung mit