Update-Guide

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:

EMPFOHLEN - Dieser Schritt ist nicht notwendig, allerdings empfohlen.
BEDINGT - Dieser Schritt ist nicht bei jedem Update, sondern nur bei expliziter Erwähnung im Changelog nötig.
OBLIGATORISCH - Dieser Schritt muss bei jedem Update durchgeführt werden.

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

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 Verzeichnis INSTALLATIONSVERZEICHNIS/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 (INSTALLATIONSVERZEICHNIS/_jvm) nutzen.

Sichern und Entfernen Sie den Ordner INSTALLATIONSVERZEICHNIS/jdk-* sowie dem Link INSTALLATIONSVERZEICHNIS/_jvm.
Installieren Sie Java erneut (siehe Installation - Java).

Das Update von Elasticsearch, Karaf und Java kann auch parallel durchgeführt werden.

Keywords: