inubit BPM Migratinsanleitung Versin 6.1 Bsch Sftware Innvatins Eurpa: Bsch Sftware Innvatins GmbH Schöneberger Ufer 89-91 10785 Berlin GERMANY Tel. +49 30 726112-0 inf-de@bsch- si.cm www.bsch-si.de Amerika: Bsch Sftware Innvatins Crp. 161 N. Clark Street Suite 3550 Chicag, Illinis 60601/USA Tel. +1 312 368-2500 inf@bsch-si.cm www.bsch-si.cm Asien: Bsch Sftware Innvatins c/ Rbert Bsch (SEA) Pte Ltd 11 Bishan Street 21 Singapre 573943 Tel. +65 6571 2220 inf-sg@bsch-si. cm www.bsch-si.sg
a1.5-0101-0000-6.1-mi09de Bsch Sftware Innvatins GmbH, 2015. Alle Rechte vrbehalten, auch bzgl. jeder Verfügung, Verwertung, Reprduktin, Bearbeitung, Weitergabe swie für den Fall vn Schutzrechtsanmeldungen.
Inhaltsverzeichnis Inhaltsverzeichnis 1 Überblick...4 2 Quellsystem sichern...5 3 inubit-sftware installieren und einrichten...6 3.1 Externe Einstellungen migrieren... 7 4 Migratinsskript ausführen...8 5 Remte Cnnectren migrieren... 10 6 inubit-sftware starten und testen... 11 7 Index... 12 Bsch Sftware Innvatins GmbH a1.5-0101-0000-6.1-mi09de 3
Überblick 1 Überblick Diese Anleitung beschreibt, wie Sie eine inubit BPM-Suite ab Versin 5.1 aufwärts zur aktuellen inubit-versin migrieren. Eine inubit BPM-Suite in einer älteren Versin (< 5.1) müssen Sie zunächst auf die Versin 5.3 migrieren. Lizenz aktualisieren Wenn Sie einen Wartungsvertrag mit der Bsch Sftware Innvatins GmbH abgeschlssen haben, benötigen Sie nicht z wingend eine neue Lizenz, sndern können bei Migratinen innerhalb eines Majr-Releases (4.x, 5.x der 6.x) die Lizenz des Quellsystems weiterverwenden. Um neue Features nutzen zu können, die in BPM-Services enthalten sind, die Sie bereits lizenziert haben, müssen Sie Ihre Lizenz auf die neue Versin aktualisieren lassen. Wenn Sie Ihre Lizenz um neue Features, die lizenzpflichtig sind, erweitern wllen, wenden Sie sich bitte an Ihren vertrieblichen Ansprechpartner bei der Bsch Sftware Innvatins GmbH der senden Sie eine E-Mail an insidesales@bsch-si.cm. Inkmpatibilitäten Mit den zahlreichen Verbesserungen und Neuerungen der aktuellen inubit-versin gehen für spezielle Anwendungsfälle relevante Inkmpatibilitäten einher. Die Inkmpatibilitätenliste finden Sie im Sftware Innvatins User Prtal unter https://user.bsch-si.cm > Sftware > BPM > readme.txt. Abkündigungen Eine vllständige Li ste der Abkündigungen finden Sie im Sftware Innvatins User Prtal unter https://user.bsch-si.cm > Sftware > BPM > readme.txt. Supprt Bei Fragen zur Migratin wenden Sie sich bitte an den Supprt der Bsch Sftware Innvatins GmbH: Telefn: +49.30.72 61 12-112 SupprtSystem: https://supprt.bsch-si.cm 4 a1.5-0101-0000-6.1-mi09de Bsch Sftware Innvatins GmbH
Quellsystem sichern 2 Quellsystem sichern Vr der Migratin müssen Sie die statischen Daten im Dateisystem (Benutzer, Wrkflws, Mdule, Rllen, Repsitry) sichern. Vraussetzungen Es darf keine Wrkflws geben, die den Status "Retry" haben. S gehen Sie vr 1. Aktivieren Sie den Wartungsmdus auf dem Quellsystem (Knfiguratin > Allgemeine Einstellungen > Verwaltung > Server > Wartungsmdus). Während der Migratin wird der Wartungsmdus auch auf dem Zielsystem aktiviert, damit Wrkflws nach dem Starten der Prcess Engine auf dem Zielsystem nicht sfrt frtgesetzt werden. 2. Stppen Sie den Integratin Server/die Prcess Engine. 3. Erstellen Sie mit Mitteln des Betriebssystems ein vllständiges Backup flgender Verzeichnisse: aktuelles inubit-installatinsverzeichnis Verzeichnisse, die Grafiken der Web-Applikatinen enthalten applikatinsspezifische Verzeichnisse Kpieren Sie dazu z. B. alle Verzeichnisse auf einen anderen Server der in einen anderen Bereich desselben Servers. 4. Sichern Sie die Startskripte, falls Sie diese angepasst haben, z. B. Firewall, Prtnummern, Prxy-Einstellungen, Speicherverhalten. 5. Erstellen Sie ein Backup der verwendeten Datenbanken: Mnitring-Datenbank Liferay-Datenbank Repsitry-Datenbank Bsch Sftware Innvatins GmbH a1.5-0101-0000-6.1-mi09de 5
inubit-sftware installieren und einrichten 3 inubit-sftware installieren und einrichten Dieser Abschnitt erläutert die flgenden Themen: Externe Einstellungen migrieren...7 Vraussetzungen Das Quell- und das Ziel-Datenbank-Managementsystem müssen identisch sein. S gehen Sie vr 1. Installieren Sie die inubit-sftware in ein neues Verzeichnis. 2. Spielen Sie Ihre Lizenz für die inubit-sftware ein. Die Lizenz für die Zielversin muss mindestens denselben Umfang abdecken wie die Lizenz für die Quellversin. 3. Falls Sie eine andere Datenbank als die mitgelieferte Datenbank für das inubit-mnitring, Tasks und für das Repsitry einsetzen möchten, führen Sie flgende Schritte durch: a. Setzen Sie die Datenbank neu auf der richten Sie einen neue n Wrkspace in der bisherigen Datenbank ein. Die auf dem Quellsystem vrhandenen Datenbanken/Wrkspaces müssen bi s zum Abschluss der Migratin erhalten bleiben! b. Wechseln Sie die inubit-mnitring-datenbank, die Task-Datenbank und die Repsitry-Datenbank aus. Siehe Managing inubit Databases Switching the Repsitry t a Database 6 a1.5-0101-0000-6.1-mi09de Bsch Sftware Innvatins GmbH
inubit-sftware installieren und einrichten 3.1 Externe Einstellungen migrieren Individuelle Knfiguratinsänderungen werden nicht autmatisch übernmmen und dürfen auch nicht direkt vm Quellsystem übernmmen werden. Übertragen Sie diese Anpassungen manuell auf das Zielsystem. Beispiele für individuelle Systemknfiguratinen sind JBOSS-Knfiguratinen, Startskripte und Prtalanpassungen: Startdateien mit Angabe der Größe des zu verwendenden JVM-Heaps (-Xmx) Anpassungen der Tmcat- der JBss-Knfiguratin, z. B.: server.xml in <inubit-installdir>/server/jbss/server/default/deply/jbssweb-tmca t55.sar jbss-service.xml in <inubit-installdir>/server/jbss/server/default/cnf/ angepasstes Servlet-Mapping in der Tmcat-Knfiguratin in der Datei web.xml Änderungen der Prtalserverknfiguratin, z. B. prtal-ext.prperties im Verzeichni s <inubit-installdir>/server/tmcat/webapps/root/web-inf/classes Dateien zur Knfiguratin vn Web Applikatinen, z. B. CSS-Dateien im Verzeichnis <inubit-installdir>/server/ibis_rt/cnf/frm Bsch Sftware Innvatins GmbH a1.5-0101-0000-6.1-mi09de 7
Migratinsskript ausführen 4 Migratinsskript ausführen Bei der Migratin werden fast alle Przesse, Artefakte und Knfiguratinen, die im Quellsystem erzeugt wurden, in das neue System übernmmen bzw. drt angepasst: Systemknfiguratin Z. B. Integratin Server-Knfiguratin, Custmer-Plug-Ins-Knfiguratin, Custmer-Biblitheken, Treiber, Repsitry, Zertifikate im Key Manager, Watchdg-Przesse des Cnnectin Managers, Applikatinsprfile, Prtalserver-bezgene Dateien und Prtalserver-Einstellungen Benutzer Z. B. Benutzer, Benutzergruppen, Przessrllen, Diagramme und Mdule Betriebszustände Z. B. Wrkflw und Systemknnektr-Aktivitätsstatus, Przess-Zustandsdaten (Waitings wie Timeuts, Tasks und Taskliste, Queued-Przesse, Retries), die kmplette inubit-mnitring-datenbank swie die aktuelle Wrkflw-ID Flgende Kmpnenten werden ni cht migriert: Tlset-Einstellungen und Tlset-Reprts PITR-Archiv Startskript des Applicatin Servers Ordner Glbal des Repsitrys Liferay Prtalserver ExtJS-Ordner extensins Ordner server/lib Flgende Kmpnenten werden erst ab einer bestimmten Versinen migriert: Tasks ab Versin 5.1 Tasklisten(layuts) ab Versin 5.1 Quellsysteme ab Versin 5.1.0.66, 5.2.0.95 der 5.3.0.55 S gehen Sie vr 1. Der Aktivitätsstatus der Wrkflws im Quellsystem wird bei der Migratin in das Zielsystem übernmmen. Passen Sie ggf. die Aktivitätsstatus der Wrkflws den Erfrderni ssen des Zielsystems an. 2. Stellen Sie sicher, dass die im Quellsystem verwendeten Datenbanktreiber i m Verzeichnis <inubit-installdir>/server/lib/system verfügbar sind. 3. Stppen Sie den Integratin Server des Quellsystems und die inubit Prcess Engine des Zielsystems. 4. Navigieren Sie im Zielsystem in das Verzeichnis <inubit-installdir>/server/migratin/ und rufen Sie das Migratinsskript migratin.bat bzw. migratin.sh auf. Geben Sie als Parameter den Pfad zum Serververzeichnis des zu migrierenden Systems an, z. B.: migratin.bat C:\Prgramme\inubit-Suite\5.3.0.55\server Falls der Pfad Leerzeichen enthält, müssen Sie den Pfad in Hchkmmas (unter Windws in Anführungszeichen) setzen, z. B.: "C:\inubit Suite\5.3.0.55\server" Wenn Sie die Migratin abbrechen, werden bereits durchgeführte Änderungen am Zielsystem nicht zurückgerllt. Sie können die Migratin später einfach neu starten. Quellsysteme mit einer Versin kleiner als 5.1.0.66, 5.2.0.95 der 5.3.0.55 S gehen Sie vr 1. Führen Sie mit dem Backup Cnnectr ein System-Backup durch. Siehe Administratr- und Entwickler-Guide der Quellversin. 2. Stppen Sie den Integratin Server des Quellsystems und die Prcess Engine des Zielsystems. 3. Navigieren Sie im Zielsystem in das Verzeichnis <inubit-installdir>/server/migratin/ und rufen Sie das Migratinsskript migratin.bat bzw. migratin.sh auf. Geben Sie als Parameter den Pfad zur System-Backup-Datei an. Beispiel: 8 a1.5-0101-0000-6.1-mi09de Bsch Sftware Innvatins GmbH
Migratinsskript ausführen migratin.bat C:\<inubit-installdir>\server\ibis_rt\ibis_data\backup\mySystemBack up.zip Falls der Pfad Leerzeichen enthält, müssen Sie den Pfad in Hchkmmas (unter Windws in Anführungszeichen) setzen, z. B.: "C:\inubit Suite\5.3.0.55\server" Die Sicherungsdatei wird in ein Standardverzeichni s geschrieben und bei jeder Ausführung des Backup Cnnectrs überschrieben. Dabei gehen die bereits enthaltenen Daten verlren. Bsch Sftware Innvatins GmbH a1.5-0101-0000-6.1-mi09de 9
Remte Cnnectren migrieren 5 Remte Cnnectren migrieren S gehen Sie vr 1. Installieren Sie die Remte Cnnectren mit dem inubit-setup erneut. 2. Übernehmen Sie die Knfiguratin der alten Knnektren aus der Datei remte_cnf.xml und der Startdatei. 3. Deinstallieren Sie die alten Remte Cnnectren. 10 a1.5-0101-0000-6.1-mi09de Bsch Sftware Innvatins GmbH
inubit-sftware starten und testen 6 inubit-sftware starten und testen Nach der Migratin sind nur die Wrkflws akti v, die bereits im Quellsystem aktiv waren. Bei Prduktivsystemen kann es sinnvll sein, das System schrittweise wieder in Betrieb zu nehmen. Dazu aktivieren Sie den Wartungsmdus, bevr Sie inubit Prcess Engine starten. S gehen Sie vr 1. Öffnen Sie die Datei <inubit-installdir>/server/ibis_rt/cnf/ibis_cnfig.xml. 2. Fügen Sie in der Sektin <Prperties versin="4.1"> das flgende Element ein: <Prperty name="servermaintenancemde" type="blean">true</prperty> Falls das Element bereits vrhanden ist und den Wert false hat, ändern Sie den Wert auf true. 3. Speichern Sie die Änderungen und schließen Sie die Datei. 4. Starten Sie die inubit Prcess Engine. 5. Aktivieren Sie den Prtalserver und deplyen Sie die Prtlets. 6. Publizieren Sie die Web-Services in das neue UDDI. 7. Testen Sie die Wrkflws und Systemanbindungen. 8. Prüfen Sie die Lgging- und Mnitring-Infrmatinen. 9. Testen Sie die Prtalfunktinalitäten. Bsch Sftware Innvatins GmbH a1.5-0101-0000-6.1-mi09de 11
Index 7 Index E Externe Einstellungen migrieren 7 I inubit-sftware installieren und einrichten 6 inubit-sftware starten und testen 11 M Migratinsskript ausführen 8 O Overview 4 Q Quellsystem sichern 5 R Remte Cnnectren migrieren 10 12 a1.5-0101-0000-6.1-mi09de Bsch Sftware Innvatins GmbH
Damit unsere Prdukte und die vrliegende Dkumentatin kntinuierlich verbessert werden können, sind wir sehr an Ihrem Feedback interessiert. Bitte schi cken Sie Ihre Fragen, Kmmentare und Verbesserungsvrschläge an supprt@bsch-si.cm.