...
| Hinweis |
|---|
Die Version 3.26 der PICTURE-Prozessplattform setzt den Einsatz folgender Drittanbieter-Software voraus:
|
Inhaltsverzeichnis
| Inhalt | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Voraussetzungen prüfen
Prüfen Sie, ob Sie derzeit eine Version der PICTURE-Prozessplattform in Betrieb haben, für welche ein direkter Migrationspfad zur neuesten für Selbsthoster vorliegenden Version 3.26.5 angeboten wird.
...
Achtung: Für den o.g. Update-Pfad wird eine Migration der bestehenden (Nutz-)Daten benötigt. Bitte führen Sie bei der Umstellung unbedingt die Arbeitsschritte "Probelauf der Bestandsdatenmigration durchführen" und "Bestandsdatenmigration durchführen" aus.
Download-Paket herunterladen und entpacken
Laden Sie das Download-Paket zur aktuellen Version aus unserem Download-Bereich herunter (https://download.prozessplattform.de/ppp/current.zip). Der Download-Bereich ist passwortgeschützt. Als registrierter On-Premise-Kunde verfügen Sie über einen individuellen Download-Zugang. Sollten Ihnen die Zugangsdaten hierfür nicht bekannt sein, wenden Sie sich bitte an support@picture-gmbh.de.
...
config_templates: Vorlagen für die Konfigurationsdateien der PICTURE-Prozessplattform-Webanwendung (wird für das Update eines vorhandenen Mandanten nicht benötigt)
db_template: Datenbankvorlage zum Einrichten eines neuen, "leeren" Mandanten (wird für das Update eines vorhandenen Mandanten nicht benötigt)
program_files: PPP-Webanwendung sowie Unterverzeichnis mit Datenbankmigrationstool für die Umstellung einer vorhandenen älteren PPP-Version
Probemigration durchführen
Datenbank, Dokumente und Versionshistorie für Probemigration sichern
Für die Probemigration der Produktivdaten ist es notwendig, Kopien der folgender Daten anzufertigen:
...
| Codeblock |
|---|
robocopy C:\PICTURE\data\uploads\ppp\documents C:\Windows\Temp\backup\documents /MIR |
Probelauf der Bestandsdatenmigration durchführen
Zur Durchführung der Bestandsdatenmigration steht ein Datenmigrationswerkzeug zur Verfügung. Mit dessen Hilfe können sämtliche mit der zuvor installierten Version der PICTURE-Prozessplattform verwalteten Daten ohne Informationsverlust in die neuen Datenstrukturen überführt werden.
| Hinweis |
|---|
Achtung: Mit dieser Bestandsdatenmigration wird eine automatische Datenkorrektur für einen Fehler vorgenommen, bei dem es unter bestimmten Umständen zu inkonsistenten Datenzuständen in Prozesskontext-Bäumen kommen konnte. Ist Ihr Mandant nicht betroffen, erfolgt keine gesonderte Log-Ausgabe. Sollte Ihr Mandant jedoch davon betroffen sein, so wird dies durch die im folgenden Beispiel dargestellte Log-Ausgabe signalisiert. |
| Codeblock |
|---|
2024-04-03 12:55:32,710 PICTURE INFO main picture.migration.R__MigrateProcessContexts - ---> Prüfe Prozesskontexte <---
2024-04-03 12:55:33,498 PICTURE INFO main picture.migration.R__MigrateProcessContexts - Anzahl Workspaces: 3
2024-04-03 12:55:33,499 PICTURE INFO main picture.migration.R__MigrateProcessContexts - --- Überprüfe Workspace Prozessregister Stadt Musterhausen ---
2024-04-03 12:55:34,580 PICTURE WARN main picture.migration.R__MigrateProcessContexts - 2 verwaiste Elemente im Baum Document gefunden
2024-04-03 12:55:34,652 PICTURE INFO main picture.migration.R__MigrateProcessContexts - korrigiere Baum Document
2024-04-03 12:55:34,652 PICTURE INFO main picture.migration.R__MigrateProcessContexts - füge 2 Document Elemente hinzu
2024-04-03 12:55:34,759 PICTURE INFO main picture.migration.R__MigrateProcessContexts - Füge neuen virtuellen Wurzelknoten im Baum Document zur Datenwiederherstellung ein. AB: Prozessregister Stadt Musterhausen
2024-04-03 12:55:35,039 PICTURE INFO main picture.migration.R__MigrateProcessContexts - --- Überprüfe Workspace Schulungs-/Testumgebung ---
2024-04-03 12:55:35,670 PICTURE INFO main picture.migration.R__MigrateProcessContexts - --- Überprüfe Workspace Querschnittsprozesse ---
2024-04-03 12:55:35,884 PICTURE INFO main picture.migration.R__MigrateProcessContexts - ---> Prozesskontexte Prüfung abgeschlossen <--- |
| Hinweis |
|---|
Bitte führen Sie dann die Bestandsdatenmigration trotzdem aus und informieren Ihren Fachadministrator, damit die manuellen Nacharbeiten, wie in diesem Artikel beschrieben Behobener Fehler (betraf v3.23.0-v3.26.3): Fehlerhafter Prozesskontext-Excel-Import mit "Datenquelle: anderer Arbeitsbereich/Plattform", durchgeführt werden können. |
Das Migrationsprogramm verfügt über einen integrierten Selbsttest, der im Anschluss an die Migration eine Konsistenzprüfung der Datenbank durchführt. Die ordnungsgemäße Funktionsfähigkeit des Releases können wir nur sicherstellen, wenn diese Konsistenzprüfung ohne Fehler abgeschlossen werden kann. Sollten bei der Prüfung Fehler gefunden werden, empfehlen wir Ihnen daher eine Rücksprache mit unserem Support zwecks Problembehebung.
Datenbank, Dokumente und Versionshistorie für Probelauf einspielen
An der Datenbank anmelden:
...
| Codeblock |
|---|
robocopy C:\Windows\Temp\backup\documents C:\PICTURE\data\uploads\ppp_probemigration\documents /MIR |
Datenbank-Migrationstool für den Probelauf konfigurieren
Zur Vereinfachung der Ausführung der Migration wurde das Skript "on-premise-db-migration.cmd" dem Download-Paket hinzugefügt. Vor dem Starten des Skripts müssen folgende Anpassungen für Ihr System vorgenommen werden.
Datenbank-Einstellung eintragen (db.config)
Öffnen Sie die Datenbank Konfigurations-Datei im Texteditor:
...
Variable | Bedeutung | Beispiel |
|---|---|---|
db.driver | Der Datenbank-Treiber, der verwendet werden soll | org.mariadb.jdbc.Driver |
db.hostname | Hostname des MySQL-Datenbank-Servers, auf dem das zu migrierende Datenbank-Schema betrieben wird | localhost |
db.port | Portnummer des MySQL-Servers auf dem o.g. Host | 3306 |
db.user | Name eines MySQL-Benutzerkontos, welches volle Privilegien für das o.g. Datenbank-Schema besitzt | ppp |
db.password | Passwort des o.g. MySQL-Benutzerkontos | GeheimesPasswort |
Datenbankschema in Datei databases.list eintragen
| Codeblock |
|---|
notepad databases.list |
...
Variable | Bedeutung | Beispiel |
|---|---|---|
DB_SCHEMA | Name des zu migrierenden Datenbankschemas (Achtung: Hier die Kopie für den Probelauf eintragen!) | ppp_probemigration |
Migrations-Skript anpassen (on-premise-db-migration.sh)
Im ersten Abschnitt des Scripts (gekennzeichnet durch den Kommentar "Skript Variablen - bitte passen Sie diese für Ihre individuelle Umgebung an") befinden sich Variablen, die Sie zur Vorbereitung der Probemigration ggf. an Ihre konkreten Gegebenheiten anpassen müssen. Öffnen Sie hierzu die o.g. Datei in einem Texteditor und passen Sie die u.g. Variablen an:
...
Variable | Bedeutung | Beispiel |
|---|---|---|
SOURCE_PPP_VERSION | Versionsnummer der zu migrierenden PPP-Installation | 3.26.4 |
TARGET_PPP_VERSION | Versionsnummer der Ziel-PPP-Installation | 3-26-5 |
JAR_PATH | Der Pfad unter dem die Jar-Dateien des Migrations-Tools abgelegt sind | C:\Windows\Temp\ppp_%TARGET_PPP_VERSION%\program_files\migration |
TOMCAT_UPLOADS_DIR | Der Pfad unter dem die Uploads der Prozessplattform abgelegt werden | C:\PICTURE\data\uploads\ppp_probemigration\documents |
Migration ausführen
Nun können Sie das Skript ausführen und somit die Probemigration starten:
...
Während der Migration protokolliert das Migrations-Skript per Konsolenausgabe den Bearbeitungsfortschritt:
Log-Auszug
| Codeblock |
|---|
Migration beendet. Die Migrations-Logs sind in der Log-Datei C:\Windows\Temp\ppp_3-26-5\program_files\migration\migration_to_3-26-5.log zu finden. |
| Tipp |
|---|
Wenn Sie sich während der längeren Wartezeit auf das Migrations-Ergebnis versichern möchten, dass das Migrations-Tool tatsächlich noch arbeitet und nicht etwa auf Grund eines technischen Fehlers abgestürzt ist, können Sie das Log-Level in der Logger-Konfiguration des Migrations-Tools auf das Level "debug" heraufsetzen (passen Sie hierzu die Vorlage-Datei “logback.xml” im Verzeichnis mit den Migrationstools an). Beobachten Sie dann in einem separaten Terminal-Fenster die verschiedenen Log-Dateien, die in das Log-Verzeichnis des Migrationstools geschrieben werden (z.B. mit dem Befehl "notepad LOGFILE"). |
Protokolldatei des Probelaufs der Datenbank-Migration auswerten
Während der Migration wird die Log-Datei "migration_to_3-26-5.log" angelegt. Sichten Sie diese Dateien nach Abschluss des Migrationslaufs jeweils mit einem Texteditor. Prüfen Sie, ob sich hier Hinweise auf Fehler bei der Datenmigration bzw. der anschließenden Konsistenzprüfung finden. Falls ein Migrationsschritt erfolgreich durchgeführt wurde, finden Sie in den Logdateien keine Java-Stacktraces und am Anfang bzw. Ende der Datei finden sich Log-Ausgaben folgender Art:
...
Bei dieser Datenmigration können ggf. Warnungen (vgl. folgender Auszug) ausgegeben werden, die keinen Einfluß Einfluss auf die korrekte Migration Ihrer Daten haben. Dies hat den Hintergrund, dass es sich hier um eine wiederholbare Migration handelt, die keiner konkreten Version zugeordnet ist.
| Codeblock |
|---|
2023-08-28 14:28:48,904 PICTURE WARN main org.flywaydb.core.internal.command.DbMigrate - Schema `ppp_probemigration` has a version (3.26.0.2) that is newer than the latest available migration (1) ! |
Update der Produktiv-Installation durchführen
Tomcat-Server herunterfahren
Nachdem Sie diesen Schritt durchgeführt haben, ist das Produktivsystem nicht mehr erreichbar. Führen Sie diese Arbeiten deshalb in einem geeigneten Wartungsfenster aus.
...
| Codeblock | ||
|---|---|---|
| ||
net stop Tomcat10 |
Bestandsdatenmigration durchführen
| Hinweis |
|---|
Mit dieser Bestandsdatenmigration wird eine automatische Datenkorrektur für den im Artikel Behobener Fehler (betraf v3.23.0-v3.26.3): Fehlerhafter Prozesskontext-Excel-Import mit "Datenquelle: anderer Arbeitsbereich/Plattform" dokumentierten Fehler vorgenommen. |
...
Während der Bestandsdatenmigration wird die Log-Datei "migration_to_3-26-5.log" für die Migration fortgeschrieben. Sichten Sie diese Datei nach Abschluss des Migrationslaufs nochmals mit einem Texteditor. Prüfen Sie, ob sich hier Hinweise auf Fehler bei der Bestandsdatenmigration bzw. der anschließenden Konsistenzprüfung finden.
WAR-Datei der Webanwendung einspielen
Kopieren Sie nun die neue WAR-Datei der PPP in das “webapps”-Verzeichnis des Tomcat-10-Servers. Führen Sie hierzu folgende Befehle aus:
| Codeblock |
|---|
copy C:\Windows\Temp\ppp_3-26-5\program_files\ppp.war "C:\Program Files\Apache Software Foundation\Tomcat 10.1\webapps" /y |
Tomcat-Server starten
Die Vorbereitungen zum Update der PPP sind damit abgeschlossen. Starten Sie nun den Tomcat-Server:
| Codeblock | ||
|---|---|---|
| ||
net start Tomcat10 |
"Smoke-Test" durchführen
Ca. 10 - 30 Sekunden nach dem Start des Tomcat-Servers sollte der Tomcat-Server das Deployment der PPP-Webanwendung abgeschlossen haben und Beim Aufruf der URL der Webanwendung im Webbrowser sollte der Login-Bildschirm zur Verfügung stehen.
...
Suche nach Prozessnamen im Prozessregister
Öffnen eines Prozesssteckbriefs zur Ansicht
Exportieren des Steckbriefs als PDF-Datei (=> Kann die heruntergeladene PDF-Datei in einem PDF-Reader geöffnet werden und enthält sie keine offensichtlichen Fehler?)
Öffnen einen Prozess-Detailmodells (Kopie eines "echten" Prozesses bzw. Testdaten) zum Bearbeiten, Änderung durchführen, anschließend speichern
Ausführen einer Analyse-App und Durchführung eines Excel-Exports (=> Kann die heruntergeladene Excel-Datei in Excel geöffnet werden?)
Aufräumarbeiten durchführen
Wenn alle Schritte durchgeführt wurden und die PICTURE-Prozessplattform - wie gewünscht - läuft, nehmen Sie sich nun noch die Zeit das Verzeichnis C:\Windows\Temp wieder aufzuräumen. Löschen Sie dazu das Verzeichnis C:\Windows\Temp\ppp_[Version] mithilfe des Windows Explorers.
...