Update-Guide
Diese Seite beschreibt, wie Sie eine bestehende BPC Installation (Version 4.0) auf eine neueres Patchlevel (ebenfalls Version 4.0) aktualisieren können.
Diese Seite beschreibt, wie Sie eine bestehende BPC 4.x-Installation auf eine neuere BPC 4.x-Version aktualisieren können.
Diese Anleitung ist allgemein gehalten. Bitte beachten Sie stets das Changelog zu den jeweiligen Versionen.
Sollten Sie das BPC zusammen mit INUBIT verwenden, dann ist auch der INUBIT Patch Guide zu beachten.
Zur Erklärung der Versionsnummerierung siehe Erläuterung zur Versionierung.
Die folgenden Schritte sind in folgende Kategorien unterteilt:
|
Nötige Schritte identifizieren
OBLIGATORISCH
Um alle nötigen Schritte für ein Update zu identifizieren, sollten Sie das Changelog überprüfen. Dabei sind insbesondere die Kommentare an den "Breaking Changes" zu berücksichtigen. Sie sollten dabei alle Changelogs sichten, die nach ihrer aktuell installierten Version bereitgestellt wurden.
Backup
EMPFOHLEN
Es wird empfohlen, ein Backup vom gesamten System durchzuführen. Dafür sind die Services von Karaf und Elasticsearch zu stoppen. Anschließend kann das Dateisystem gesichert werden.
BPC Update
Dieser Abschnitt beschreibt, wie Sie das BPC und seine Komponenten aktualisieren können.
Wurde das BPC über den Installer installiert, sollten Sie zum Abschnitt Update via Installer wechseln.
Dateien bereitlegen
OBLIGATORISCH
Die Download-Quelle(n) finden Sie unter Download - Virtimo Fileserver. Die für das Update benötigten Dateien hängen von Ihrer konkreten BPC-Installation und dem Versionssprung des BPC-Updates ab.
Für die von Ihnen genutzten BPC-Module benötigen Sie jeweils Frontend (bpc-fe-*.war) und Backend (bpc-be-*.jar) in der angestrebten, aktuelleren Version.
Falls in dem für Ihren konkreten Versionssprung relevanten Changelog Dateien angegeben sind, legen Sie die entsprechenden Dateien bereit.
Diese könnten bspw. das Elasticsearch-Plugin es-bpc-plugin.zip
oder die Technischen Workflows der INUBIT-Benutzergruppe BusinessProcessCenter
umfassen.
Falls Sie wegen Sicherheitsverbesserungen, Bugfixes oder ähnlichen Änderungen der JVM eine andere Version davon installieren möchten, legen Sie die entsprechenden Dateien bereit.
Falls Sie wegen Sicherheitsverbesserungen o.Ä. von Karaf oder Elasticsearch neuere Versionen installieren möchten, legen Sie die entsprechenden Dateien bereit.
Update Elasticsearch-Plugin
BEDINGT - Falls dies im Changelog empfohlen wird.
-
Stoppen Sie das BPC, falls noch nicht geschehen.
-
Entfernen Sie das alte Plugin.
ELASTICSEARCH/bin/elasticsearch-plugin remove es-bpc-plugin
-
Installieren Sie das neue Plugin.
ELASTICSEARCH/bin/elasticsearch-plugin install file:///PFAD/ZUM/PLUGIN/es-bpc-plugin.zip
-
Starten Sie das BPC.
Update BPC-Module
OBLIGATORISCH
Falls sie auch Karaf aktualisieren wollen, sollten Sie dies zuerst tun. |
-
Kopieren Sie die neuen BPC-Module in den Ordner
INSTALLATIONSVERZEICHNIS/karaf/deploy
. -
Warten Sie, bis alle BPC-Module erfolgreich deployt und im Status
Active
sind.
Update INUBIT-Workflows
BEDINGT - Falls Sie BPC INUBIT Workflows nutzen.
Für einige Funktionalitäten greift das BPC auf Technische Workflows (TWFs) in INUBIT zurück.
Standardmäßig liegen diese in der INUBIT-Benutzergruppe BusinessProcessCenter
.
Diese TWFs können Sie installieren bzw. aktualisieren, indem Sie das entsprechende Workflow-Paket über die Workbench importieren.
Nutzen Sie bitte das Workflow-Paket BusinessProcessCenter.workflow.inubit.integration.patch.protected.zip
aus dem Downloadbereich und importieren Sie es in die Benutzergruppe BusinessProcessCenter
des INUBIT.
Sollten Sie weitere Workflows für andere Module oder nur einen speziellen Workflow-Teil benötigen, so können Sie auch ein anderes Workflow-Paket auswählen. Die Dateinamen bzw. Teile dessen geben Aufschluss über den Inhalt.
-
Die Dateien mit
.setup.
im Namen enthalten alle TWFs des jeweiligen Pakets, während die mit.patch.
nicht die Hook-TWFs enthalten (die "_hook" als Namenssuffix bei Diagrammgruppe bzw. Workflow tragen).
Daher werden bei Import von.patch.
die Anpassungen an Hook-TWFs nicht verändert, aber je nach gewähltem Paket am Standard vorgenommene Veränderungen/Verbesserungen schon (wie beispielsweise in den Konfigurations-TWFs _BPC_199_BPC_Configuration_ etc.). -
.inubit.integration.
enthält die Workflow-Pakete.IdenityProvider.
,.Monitor.
und.Documentation.
(siehe folgende Punkte) -
.IdenityProvider.
sind notwendig, falls INUBIT oder Liferay als Identity Provider für BPC genutzt werden sollen -
.Monitor.
setzen Funktionen für den BPC Process Monitor um, bspw. Daten aus einem TWF ins Log zu schreiben, aus dem PM heraus den Status einer Prozessinstanz zu ändern oder eine Prozess-Aktion auszuführen. -
.pm.migration.
für die Migration des ehemaligen Bosch Process Monitors -
.DataManagement.
Workflows für das Data Management Modul -
.Documentation.
setzen in BPC Documentation den PDF-Export von Diagrammen um. Da dieses Paket keine Hook-TWFs enthält, gibt es hierbei keine Aufteilung in.setup.
und.patch.
Update via Installer
Haben Sie das BPC mittels Installer installiert, sollten Sie diesen auch für das Update nutzen. Ansonsten können Sie das BPC Update nutzen.
Laden Sie den Patch-Installer und den Patch Installation Guide aus dem User Portal herunter.
Weiterführende Informationen finden Sie unter INUBIT Patch Guide.
Patch-Installer und Patch-Installation-Guide durchlaufen
OBLIGATORISCH
Durchlaufen Sie die Schritte, die für Ihren Versionssprung bzgl. BPC im Changelog stehen. Im Zuge dessen führen Sie den Patch-Installer mit dem Installationssatz Business Process Center aus.
Sollten Sie auch INUBIT aktualisieren wollen, müssen Sie dafür den Patch-Installer mit dem Installationssatz INUBIT ausführen – dies gilt auch, wenn INUBIT und BPC nicht auf getrennten, sondern auf demselben System installiert sind.
Siehe auch INUBIT Patch Guide.
Update INUBIT-Workflows
OBLIGATORISCH
Für einige Funktionalitäten greift das BPC auf Technische Workflows (TWFs) in INUBIT zurück. Falls diese in Ihrer Installation genutzt werden, aktualisieren Sie diese bitte entsprechend der Anleitung Aktualisierung der BPC-Workflows.
Update Karaf
BEDINGT - Falls dies im Changelog empfohlen wird.
-
Stoppen Sie den Karaf-Prozess.
-
Sichern Sie das Verzeichnis
INSTALLATIONSVERZEICHNIS/karaf
(bzw. das Verzeichnis, auf das der Link zeigt). -
Entfernen Sie den Link
INSTALLATIONSVERZEICHNIS/karaf
und das Zielverzeichnis. -
Installieren Sie Karaf wie in der Installationsanleitung beschrieben.
-
Falls Sie Konfigurationen an der alten Installation vorgenommen haben, können Sie diese aus der Sicherung in das Verzeichnis
INSTALLATIONSVERZEICHNIS/karaf/etc
übertragen. -
Starten Sie den Karaf-Prozess.
-
Falls Sie zuvor JDBC-Treiber installiert haben, müssen Sie dies wiederholen (siehe Datenbanken).
-
Installieren Sie die BPC-Module wie in der Installationsanleitung beschrieben.
Das Update von Elasticsearch, Karaf und Java kann auch parallel durchgeführt werden. |
Update Elasticsearch
BEDINGT - Falls dies im Changelog empfohlen wird.
-
Stoppen Sie den Karaf-Prozess.
-
Stoppen Sie den Elasticsearch-Prozess.
-
Sichern Sie das Verzeichnis
INSTALLATIONSVERZEICHNIS/elasticsearch
(bzw. das Verzeichnis, auf das der Link zeigt). -
Entfernen Sie den Link
INSTALLATIONSVERZEICHNIS/elasticsearch
und das Zielverzeichnis. -
Installieren Sie Elasticsearch wie in der Installationsanleitung beschrieben.
-
Kopieren Sie das
data
-Verzeichnis aus dem gesicherten Elasticsearch-Verzeichnis in das neue VerzeichnisINSTALLATIONSVERZEICHNIS/elasticsearch
. -
Falls Sie Konfigurationen an der alten Installation vorgenommen haben, können Sie diese aus der Sicherung in die Datei
INSTALLATIONSVERZEICHNIS/elasticsearch/config/elasticsearch.yml
übertragen. -
Starten Sie den Elasticsearch-Prozess.
-
Starten Sie den Karaf-Prozess.
Das Update von Elasticsearch, Karaf und Java kann auch parallel durchgeführt werden. |
Update Java
BEDINGT - Falls dies im Changelog empfohlen wird.
Stoppen Sie alle Prozesse (z.B. Elasticsearch und Karaf), die die aktuelle Laufzeitumgebung ( |
-
Sichern und Entfernen Sie den Ordner
INSTALLATIONSVERZEICHNIS/jdk-*
sowie dem LinkINSTALLATIONSVERZEICHNIS/_jvm
. -
Installieren Sie Java erneut (siehe Installation - Java).
Das Update von Elasticsearch, Karaf und Java kann auch parallel durchgeführt werden. |