Überblick

Diese Anleitung beschreibt, wie Sie eine ältere INUBIT-Installation zur neuesten INUBIT 8.0 Version migrieren. Bevor Sie zur neuesten INUBIT 8.0 Version migrieren können, müssen Sie Ihre derzeitige INUBIT-Installation auf den letzten unterstützten Patch-Level Ihres Minor-Releases patchen, zum Beispiel von INUBIT 7.2.x auf INUBIT 7.2.0.59 und von INUBIT 7.3.x auf INUBIT 7.3.0.44. Danach können Sie zur nächsten unterstützten INUBIT-Version oder zur neuesten INUBIT 8.0 Version migrieren.

Sie müssen alle Zwischenschritte befolgen.

Migrations-Matrix

Ihre INUBIT-Installationn Mögliche INUBIT-Zielversionen

<= 7.0.x

7.1.x

7.1.x

7.2.x / 7.3.x

7.2.x

7.3.x / 7.4.x / 8.0.x

7.3.x

7.4.x / 8.0.x

7.4.x

8.0.x

Empfehlung für die Migration von INUBIT 7.1.x zu INUBIT 8.0.x: Patchen Sie zunächst Ihre INUBIT 7.1.x‑Installation auf INUBIT 7.1.0.63 und migrieren Sie danach zu INUBIT 7.3.0.44. Machen Sie ein Backup Ihrer INUBIT 7.3.‑Installation bevor Sie zur neuesten INUBIT 8.0 Version migrieren.

Die Migration einer INUBIT-Installation unter JBoss nach INUBIT 8.0 wird nicht mehr unterstützt. Wechseln Sie auf den Apache Tomcat Applikationsserver.

Ab INUBIT 7.4.0.43 wird AdoptOpenJDK ausgeliefert und in das Verzeichnis _jvm unterhalb des Verzeichnisses <inubit‑installdir> installiert. AdoptOpenJDK wird standardmäßig automatisch verwendet. Alternativ dazu können Sie ein anderes unterstütztes JDK verwenden (siehe Softwareanforderungen). In diesem Fall müssen Sie die Umgebungsvariablen entsprechend setzen, siehe Umgebungsvariable JAVA_HOME setzen.

Ablauf der Datenmigration

Die Migration erfolgt weitgehend automatisiert über ein Skript (siehe Migrationsskript ausführen). Welche Daten dieses Skript automatisiert migriert bzw. welche Daten Sie manuell migrieren müssen und welche Einstellungen Sie auf dem Zielsystem vornehmen müssen, ist im Folgenden beschrieben.

Welche weiteren manuellen Schritte erforderlich sind, um zum Beispiel Datenbanktreiber zu installieren und den Application Server zu konfigurieren, siehe Datenbanktreiber auf dem Zielsystem installieren und siehe Externe Einstellungen migrieren.

Vor der Migration größerer Datenmengen, bei Nutzung einer Oracle Datenbank, sollte für den Undo Tablespace die Option AUTOEXTEND gesetzt werden.

Die Datenmigration erfolgt in folgenden Schritten:

  1. Sicherung der Daten des Quellsystems (Backup)

  2. Optional: Manuelle Migration der EDI-ID-Listen (siehe EDI-Migration)

  3. Wiederherstellen der Daten des Quellsystems auf dem Zielsystem (Restore)

Folgende Daten werden für die Migration automatisch gesichert

  • externe Bibliotheken im Verzeichnis <inubit-installdir>/server/lib/ext (beinhaltet u.a. Plugins und Bibliotheken von Drittanbietern)

  • System-Bibliotheken im Verzeichnis <inubit-installdir>/server/lib/system (beinhaltet u.a. Datenbanktreiber für die Workflowausführung)

  • Konfigurationsdateien

    • ibis_config.xml

      In der neuen Version obsolet gewordene Features und Propertys werden weggelassen. Für jede nicht migrierte Property wird ein "Info"-Eintrag in die Migrationslogdatei geschrieben.

    • plugin.xml

    • profile.xml

    • tool_profiles.xml

    • Applikationsprofile (Verzeichnis app)

  • EDI (Rules, Qualifier, Schemas)

    Für die Migration von EDI-IDs sind manuelle Schritte nötig (siehe EDI-Migration).

  • Monitoring-Datenbank

  • Tasks und Tasklisten

    • Delegierte Tasks, wenn die Delegation ab INUBIT 7.4.0.47 erfolgte

  • Tags

  • Benutzerspezifische Repositorydaten

  • Process-Id-Bereich (process_id.xml)

Folgende Daten werden NICHT migriert

  • Toolset-/Workbench-Einstellungen und Toolset-/Workbench-Reports

  • Datenbanktreiber für die Monitoring- und Repository-Datenbank

  • Point-In-Time-Recovery-Archiv

  • Startskript des Application-Servers

  • Ordner Global des Repositorys (inklusive EDI-Regeln)

  • Delegierte Tasks, wenn die Delegation vor INUBIT 7.4.0.47 erfolgte

  • Portalserver

  • ExtJS-Ordner extensions

  • Portalordner <inubit-installdir>/server/ibis_root/conf/portal (wegen möglicher Inkompatibilitäten mit der installierten Liferay-Version)

  • Konfigurationsdateien

    • logsDBConfig.xml

    • taskDBConfig.xml

    • repository.xml

    • ibis_deploy.xml

    • systemdiagram_config.xml

    • partnermanagement_config.xml

      Die Konfigurationsdateien ibis_deploy.xml, systemdiagram_config.xml und partnermanagement_config.xml müssen Sie über das Menü Konfiguration der INUBIT Workbench (Konfiguration > Deployment, Konfiguration > Systemdiagramme, bzw. Konfiguration > Partnermanagement) anpassen.

  • INUBIT-Bibliotheken: ibis.jar, ibis_tools.jar

  • Tomcat-Logdateien (Verzeichnis <inubit-installdir>/server/process_engine/logs)

  • Tutorial-Benutzer

Vor dem Wiederherstellen der Daten auf dem Zielsystem werden alle dort vorhandenen Daten (Benutzer, Prozesse, Repository, Logs etc.) gelöscht.

Lizenz aktualisieren

Zum Starten der INUBIT Process Engine auf dem Zielsystem benötigen Sie eine neue Lizenz, die der Version entspricht, zu der Sie migrieren wollen. Sie beantragen die neue Lizenz beim Support der Virtimo AG support@virtimo.de.

Siehe Lizenz anfordern.

Inkompatibilitäten

Mit den zahlreichen Verbesserungen und Neuerungen der aktuellen INUBIT-Version gehen für spezielle Anwendungsfälle relevante Inkompatibilitäten einher. Die Inkompatibilitätenliste finden Sie in der Datei readme-DE.txt im Installationsordner von INUBIT oder hier.

Abkündigungen

Eine vollständige Liste der Abkündigungen finden Sie in der Datei readme-DE.txt im Installationsordner von INUBIT oder hier.

Support

Bei Fragen zur Migration wenden Sie sich bitte an den Support der Virtimo AG:

Press Esc to exit full screen
Modal image placeholder
Press Esc to exit full screen