Voraussetzungen
❗Bevor Sie die Installation der neuen Version von STP Common Services durchführen, machen Sie bitte eine Sicherung des gesamten Systems. Diese dient im Fehlerfall zur Wiederherstellung der gesamten Umgebung.
❗Damit die Installation ordnungsgemäß ausgeführt werden kann, muss das Homedrive auf ein lokales Laufwerk (in der Regel C:) verweisen. Überprüfen Sie dies in einer Eingabeaufforderung. Sollte in diesem Zuge ein Netzlaufwerk angezegt werden, können Sie einen lokalen Administrator anlegen und mit diesem dann zwigend die anschließenden Update-Schritte durchführen.
- Neues STP.CommonServices.Main.Setup-1.6.530.0.exe ist verfügbar.
- Das Update kann mit einem administrativen Benutzer durchgeführt werden.
- Das Update kann während einer Ausfallzeit durchgeführt werden, da alle STP-Client-Apps und STP-Dienste angehalten werden müssen..
Schritt für Schritt Aktualisierung
Alle Clients stoppen
Alle STP-Client-Anwendungen müssen beendet werden
Beachten Sie, dass der DMS LCAS im Hintergrund laufen und automatisch gestartet werden kann. Es muss sichergestellt werden, dass auch alle LCAS-Instanzen gestoppt werden.
Alle Cloud-Konnektoren müssen gestoppt werden
Durch das Beenden aller Clients und Konnektoren wird verhindert, dass Nachrichten an die lokalen STP-Anwendungsdienste gesendet werden.
Stellen Sie sicher, dass alle persistenten Warteschlangen in RabbitMq leer sind
Persistente Warteschlangen werden in der RabbitMq-Verwaltungskonsole als “durable” gekennzeichnet.
Öffnen Sie die RabbitMq-Verwaltungskonsole und überprü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 von 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 Gesamtzahl der Nachrichten 0 sein. Wenn noch Nachrichten aufgelistet sind, gehen Sie zur Seite „Warteschlangen“:
Hier sieht man die verbleibenden Warteschlangen. Die mit einem „D” unter
„Features” gekennzeichneten sind die persistenten Warteschlangen. Unter
„Total” sieht man die aktuelle Nachrichtenanzahl dieser Warteschlangen.
Bei Warteschlangen, die noch Nachrichten enthalten, versuchen Sie, den
entsprechenden Dienst neu zu starten und zu überprüfen, ob die
Nachrichten verarbeitet werden (Anzahl = 0 oder abnehmend, weil die
Nachrichten verarbeitet werden). Nachdem die Warteschlangen keine
Nachrichten mehr enthalten, können auch die STP-Anwendungsdienste
gestoppt werden. Nun sollte nichts mehr mit RabbitMq verbunden sein.
Stop STP Services
Je nach den installierten Produkten gibt es eine entsprechende Liste
von Diensten, die alle beendet werden müssen.
>Bitte beachten Sie, dass diese
Illustration nur ein Beispiel ist und auf Ihrem System ggf. weitere
Dienste wie z.B. beA Desk und winsolvenz vorhanden sein können. Diese
sollten ebenfalls beendet werden.
Stop RabbitMq
Unter „Services“ findet man den RabbitMq-Dienst und kann ihn dort beenden.
Deinstallieren Sie die alte RabbitMq-Version
Achtung: Wir haben festgestellt, dass die Datei „epdm.exe” von Erlang manchmal während der Deinstallation blockiert wird. In diesem Fall öffnen Sie den Task-Manager (Als Administrator ausführen) , suchen Sie nach „epdm.exe” und beenden Sie den Prozess.
Falls der Deinstallationsvorgang weiterhin Probleme verursacht, gehen Sie zum Erlang-Ordner und benennen Sie die Datei „epdm.exe“ um:
Gehen Sie zum Erlang-Installationsordner C:\Program Files\Erlang OTP\erts-14.2.5.9\bin und benennen Sie die Datei epdm.exe um (z. B. in epdem.exe_old).
Je nach Installation kann es vorkommen, das der Erlang-Installationsordner unter C:\Program Files\erl-23.3\erts-11.2\bin liegt.
Achtung: Gelegentlich kann es vorkommen, dass Windows den Abschluss eines Installations- oder Deinstallationsvorgangs nicht korrekt erkennt. In diesem Fall können Sie keine neue Installation/Deinstallation starten und Windows meldet, dass noch ein anderer Prozess ausgeführt wird. Um dieses Problem zu beheben, ist ein Neustart des Systems erforderlich.
Öffnen Sie zunächst „Apps und Funktionen“
Die Deinstallation muss in drei Schritten erfolgen.
- Suchen Sie nach „RabbitMq Server 3.8.14”, wählen
Sie es zum Entfernen aus und bestätigen Sie die folgenden
Deinstallationsseiten.
- Suchen Sie nach „Erlang OTP 23” und wählen Sie es
aus, um es zu 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 ihn um (z. B. in „LEXolution Service Bus_old“), um zu verhindern, dass er während der Installation der neuen RabbitMq-Version verändert wird.
Die Ordner zu Erlang (oft “Erlangen” genannt), als auch zu RabbitMq können gelöscht werden. Dies kann sonst Probleme bei der Neuinstallation hervorrufen.
Registry-Eintrag löschen
Es kann in seltenen Fällen notwendig werden, dass der Registry-Key “Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\Erlang” manuell gelöscht werden muss.
Deaktivieren von STP-Startskripten
Im Zuge des Updates sollten Sie vor einem Neustart des Serversystems im Bereich der Aufgabenplanung (Verwaltung/Aufgabenplanung) im Ordner “STP” den Task “STP-Dienste_sicher-starten” deaktivieren. Dieser muss zu einem späteren Zeitpunkt wieder aktiviert werden.
Neustart des Serversystems
Bevor Sie mit der Installation der neuen Version fortfahren, empfehlen wir einen Neustart des Serversystems durchzuführen.
Installieren Sie das neue RabbitMq
❗Damit die Installation ordnungsgemäß ausgeführt werden kann, muss das Homedrive auf ein lokales Laufwerk (in der Regel C:) verweisen. Überprüfen Sie dies in einer Eingabeaufforderung:
Geben Sie „set” ein, um eine Liste aller Umgebungsvariablen anzuzeigen. Die Variable „HOMEDRIVE” sollte auf C: verweisen (HOMEDRIVE=C:).
Wenn sie auf einen anderen Ort verweist (z. B. ein Netzlaufwerk) und das Netzlaufwerk von einem lokalen Administrator angelegt worden sein, muss das Update mit diesem Benutzer durchgeführt werden. Wenn dies kein Erfolg hat, konfigurieren Sie sie neu, bevor Sie mit der Installation fortfahren. Beachten Sie bitte die vorherige Anweisung zwingend zuerst, bevor die diesen Weg nutzen.
Starten Sie die Datei STP.CommonServices.Main.Setup-1.6.530.0.exe und gehen Sie durch die Setup-Seiten:
Beachtens Sie bitte, dass das Setup administrative Rechte erfordert.
Willkommensseite
Weiter auswählen…
STP LEXolution Bus Konfiguration
In den meisten Fällen kann die Standardkonfiguration (Benutzername und
Passwort) verwendet werden. Wenn in der alte Konfiguration das Passwort
anders war, sollten Sie dieses wiederverwenden (zu finden in der
Installationsdokumentation).
❗Bitte überprüfen Sie den Pfad zur Datenbank (Common.db). Bei einer Update-Installation durch einen anderen Benutzer als bei der initialen Installation kann der Pfad ggf. zurückgesetzt werden. Bitte überprüfen Sie dies auch nach Abschluss der Installation in der Konfigurationsdatei “STP.Common.Services.exe.config” unter dem Pfad z.B. “C:Files (x86)AGUserManagement Service” mit dem Wert “add key=”DataSource” value=“IHR-PFAD”.
Wenn Sie fertig sind, klicken Sie auf „Weiter“…
Bestätigen Sie die Installation von Erlang und seinen Komponenten
Weiter auswählen…
Der Standardinstallationsort sollte verwendet werden.
Der Standard-Menüordner sollte verwendet werden.
Nach der Installation von Erlang wird RabbitMq installiert. Bestätigen Sie alle Seiten der RabbitMq-Einrichtung.
Die Standardkomponenten sollten verwendet werden.
Der Standardinstallationsort sollte verwendet werden.
Schließlich wird eine Konsolenanwendung gestartet, die RabbitMq entsprechend der eingegebenen Konfiguration neu konfiguriert. >❗Dieses Konsolenanwendung dient zur Konfiguration des RabbitMq und kann mehrere Minuten in Anspruch nehmen. Das Fenster wird automatisch geschlossen, sobald der Prozess abgeschlossen ist. Bitte schließen Sie diese unter keinen Umständen manuell, da sonst ein inkonsistenter Zustand erzeugt wird und das System anschließend nicht lauffähig ist.
Die Installation endet mit der Seite „Installation
abgeschlossen“, die bestätigt werden kann.
Weiter auswählen…
RabbitMq-Installation überprüfen
Anschließend sollte die RabbitMq-Installation validiert werden. Öffnen Sie die RabbitMq-Verwaltungskonsole in einem Browser und melden Sie sich mit dem Benutzernamen und dem Passwort an, die für die Konfiguration bereitgestellt wurden.
Achtung: Da die Verwaltungskonsole zuvor mit der alten RabbitMq-Version im Browser geöffnet wurde, speichert der Browser höchstwahrscheinlich noch alte Artefakte im Cache. Verwenden Sie zum Öffnen der Verwaltungskonsole eine private Browserseite oder einen anderen Browser.
Die RabbitMq-Verwaltungskonsole sollte eine Seite ähnlich der folgenden anzeigen:
Erneutes Aktivieren von STP-Startskripten
Nun sollte im Bereich der Aufgabenplanung (Verwaltung/Aufgabenplanung) im Ordner “STP” der Task “STP-Dienste_sicher-starten” wieder aktiviert werden.
Erneutes Neustart des Serversystems
Mit dem Abschluss der vorherigen Schritte, empfehlen wir einen erneuten Neustart des Serversystems durchzuführen.
Sollte etwas schief gegangen sein
Bei aller Sorgfalt ist nicht auszuschließen, dass sich ein Fehler einschleicht. Sollte das Update nicht fehlerfrei abgeschlossen werden können und RabbitMq nicht lauffähig sein, muss der Vorgang wiederholt werden. Bitte starten Sie den Rechner neu und führen Sie das Update anhand der Anleitung ein weiteres Mal Schritt für Schritt durch. Sollte auch der zweite Versuch fehlschlagen, empfehlen wir das System aus der Systemsicherung zurückzusetzen und es auf dem frisch gestarteten System erneut zu versuchen.
Verknüpfung mit