Wie kann man Versionsfixe beim Servicemanager einspielen?
Bitte immer in der release-info.json informieren, ob es Änderungen gibt, z. Bsp. JDK oder bit-Version. Falls ja, muss auch eine Anpassung der servicewatcher-sw.yml erfolgen und Neustart des Servicemanager.
Besonderheiten:
Repositorymanager:
Unbedingt darauf achten, ob in der release-info.json steht, ob sich die KGS-Komponenten geändert hat. Falls ja, ist eine Neukonfiguration nötig. Die KGS-Komponenten unterschiedlicher Versionen sind nicht kompatibel! Ist dies der Fall, sollte das Einspielen gut geplant werden und unser SAPS-Team hinzugezogen werden.RMA-Link (verfügbar ab enaio 11.00):
Die JAR-Datei heißt repositorymanager-al.jar. Beim Einfügen in das Update-Verzeichnis wird die Datei zusätzlich umbenannt in rmalink-app.jar.
Vor dem Einspielen empfiehlt es sich generell die vorherige Version zu sichern und die Konfiguration (Verzeichnisse: config und apps).
Bitte auf Schreibschutz achten. Es darf keinen geben im APPS- und im Update-Verzeichnis, sonst können die JAR-Dateien nicht verwendet werden.
Mögliche Wege zum Einspielen Servicemanager-Update:
Bei Punkt 1 und 2 wird der jeweilige Service automatisch entladen und ausgetauscht. Die Komponente servicewatcher-app.jar kann sich u.U. nicht selbst austauschen. Bei diesem Service ist Punkt 3 nötig (manueller Austausch).
Sind mehrere Servicemanager vorhanden, müssen diese Schritte bei allen Servicemanagern ausgeführt werden.
Schritt-für-Schritt-Anleitung
1. per Kopie der JAR-Datei in das Update-Verzeichnis des Servicemanagers
In das Servicemanager-Verzeichnis wechseln.
prüfen, ob das Verzeichnis "update" vorhanden ist. Falls nicht, bitte einfach anlegen.
Kopie der gewünschten JAR-Datei(en) in das Update-Verzeichnis des Servicemanagers. Beispiel: adminservice.jar
Nun wird der Servicemanager der Reihe nach alle Dateien verarbeiten. Nicht benötigte / nicht konfigurierte Komponenten sowie identische Versionen werden automatisch verworfen.
Ablauf des Einspielens durch den Servicemanager:Der jeweilige Service, der auszutauschen ist, wird entladen. Man sieht je eine *.LOCK-Datei im Update-Verzeichnis.
Die Version, die bei der Erst-Installation eingefügt wurde, wird gesichert im Verzeichnis DINST des Servicemanagers (für alle Fälle).
nach dem Austausch steht die neue JAR im Apps-Verzeichnis:
2. per Aufruf enaio_services_versionfix.exe
Bitte beachten: Es fügt alle JAR-Dateien ein, die im Verzeichnis Service-Manager-Update der Installationsressource liegen.
Auf den Server gehen, auf dem der Servicemanager läuft.
In der Installationsressource das Verzeichnis Service-Manager-Update wechseln und enaio_services_versionfix.exe explizit mit "als Administrator ausführen" starten.
Normalerweise wird das Verzeichnis des Servicemanagers automatisch ermittelt und das Update-Verzeichnis wird angelegt (falls nicht vorhanden). Es werden alle JAR-Dateien in das Update-Verzeichnis eingefügt, auch die JSON-Dateien mit den Release-Infos.
Nun wird der Servicemanager der Reihe nach alle Dateien verarbeiten. Nicht benötigte / nicht konfigurierte Komponenten sowie identische Versionen werden automatisch verworfen.
Ablauf des Einspielens durch den Servicemanager:Der jeweilige Service, der auszutauschen ist, wird entladen. Man sieht je eine *.LOCK-Datei im Update-Verzeichnis.
Die Version, die bei der Erst-Installation eingefügt wurde, wird gesichert im Verzeichnis DINST des Servicemanagers (für alle Fälle).
nach dem Austausch steht die neue JAR im Apps-Verzeichnis:
3. einzeln/manuell einfügen
Dazu den enaio Servicemanager beenden und in das entsprechende Apps-Verzeichnis wechseln. Bitte beachten: Einige JAR-Dateien heißen in der config anders und müssen umbenannt werden, z. Bsp. RMA-Link.
Welches Verzeichnis das genau ist, findet man über die servicewatcher-sw.yml heraus.
Einzige Ausnahme ist die servicewatcher-app.jar. Dies ist der Servicemanager selbst. Er wird nicht separat konfiguriert.
Beispiel: Das Versionsfix heißt ocrservice-app.jar.Die JAR-Datei in der servicewatcher-sw.yml suchen.
Steht bei Instance 1, sollte die JAR-Datei in das angegebene Verzeichnis kopiert werden.
Im Beispiel steht 0, d.h. der Service ist inaktiv. Das Einspielen ist nicht unbedingt nötig.
Sofern Anpassungen nötig sind, z. Bsp. Anpassung der JDK-Version oder von 32bit auf 64bit oder der JAR-Name selbst muss geändert werden, dann dies ebenfalls vornehmen.
Sind alle gewünschten JAR-Dateien kopiert, den Servicemanager neu starten.
Es empfiehlt sich das services.log zu prüfen. Zuletzt die Admin-Oberfläche aufrufen und prüfen, ob das Versionsfix verfügbar ist.
Dies sieht man bereits in der "Applications"-Übersicht oder auch dem Wallboard. Genauer steht es beim jeweiligen Service, wenn man ihn anklickt.
Beispiel: Licenseservice hat Versionsfix 2
Vor dem Einspielen empfiehlt es sich generell die vorherige Version zu sichern. Ein Downgrade (= vorherige Version einfügen) ist jederzeit möglich.
Verwandte Artikel