inubit Suite 6 Migrationsanleitung

inubit Suite 6 Migrationsanleitung

Copyright inubit AG Schöneberger Ufer 89-91 10785 Berlin Deutschland Phone: +49.30.72 61 12-0 Fax: +49.30.72 61 12-100 E-Mail: contact@inubit.com URL: www.inubit.com inubit AG 2011 Rechtliche Bestimmungen Die in diesen Unterlagen enthaltenen Angaben und Daten, einschließlich URLs und anderer Verweise auf Internetbasis, können ohne vorherige Ankündigung geändert werden. Die Produktdokumentation wurde sorgfältig erstellt. Die darin enthaltenen Angaben können jedoch nicht als Zusicherung von Eigenschaften der inubit Suite 6 gelten. Die Haftung der inubit AG umfasst nur die in den Verkaufs- und Lieferbedingungen festgelegten Bestimmungen. Die Benutzer sind verantwortlich für das Einhalten aller anwendbaren Urheberrechtsgesetze. Unabhängig von der Anwendbarkeit der entsprechenden Urheberrechtsgesetze darf ohne ausdrückliche schriftliche Erlaubnis der inubit AG kein Teil dieses Dokuments für irgendwelche Zwecke vervielfältigt oder übertragen werden, unabhängig davon, auf welche Art und Weise oder mit welchen Mitteln, elektronisch oder mechanisch, dies geschieht. Die inubit AG kann Inhaber von Patenten, Marken, Urheberrechten oder anderen Rechten an geistigem Eigentum sein, die den Inhalt dieses Dokuments betreffen. Die Bereitstellung dieses Dokuments erteilt keinerlei Lizenzrechte an diesen Patenten, Marken, Urheberrechten oder anderem geistigen Eigentum, ausgenommen, dies wurde explizit durch einen schriftlich festgelegten Lizenzvertrag mit der inubit AG vereinbart. Die von der inubit AG angebotene Software kann Softwarekomponenten anderer Hersteller enthalten. inubit ist eine eingetragene Marke der inubit AG. Alle sonstigen in diesem Dokument aufgeführten Produkt- und Firmennamen sind möglicherweise eingetragene Marken der jeweiligen Inhaber.

Überblick 3 1 Überblick Diese Anleitung beschreibt, wie Sie eine inubit BPM-Suite ab Version 5.1 aufwärts zu der inubit Suite 6 migrieren. Eine inubit BPM-Suite in einer älteren Version (< 5.1) müssen Sie zunächst auf die Version 5.3 migrieren. Lizenz aktualisieren Wenn Sie einen Wartungsvertrag mit der inubit AG abgeschlossen haben, benötigen Sie nicht zwingend eine neue Lizenz, sondern können bei Migrationen innerhalb eines Major-Releases (4.x, 5.x oder 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, senden Sie eine E-Mail an support@inubit.com, um Ihre Lizenz auf die neue Version aktualisieren zu lassen. Wenn Sie Ihre Lizenz um neue Features, die lizenzpflichtig sind, erweitern wollen, wenden Sie sich bitte an Ihren vertrieblichen Ansprechpartner bei inubit oder senden Sie eine E-Mail an insidesales@inubit.com. Inkompatibilitäten Mit den zahlreichen Verbesserungen und Neuerungen der inubit Suite 6 gehen für spezielle Anwendungsfälle relevante Inkompatibilitäten einher. Die Inkompatibilitätenliste finden Sie im inubit User-Portal unter www.inubit-user.com > Register Software" > readme.txt. Abkündigungen Eine vollständige Liste der Abkündigungen finden Sie im inubit User- Portal unter www.inubit-user.com > Register User-Forum > Datei readme.txt. Support Bei Fragen zur Migration wenden Sie bitte sich an den inubit Support: Telefon: +49.30.72 61 12-112 E-Mail: support@inubit.com URL: www.inubit.com/support inubit Suite 6: Migrationsanleitung 16.12.2011

4 Quellsystem sichern 2 Quellsystem sichern Vor der Migration müssen Sie die statischen Daten im Dateisystem (Benutzer, Workflows, Module, Rollen, Repository) sichern. 1. Stoppen Sie den Integration Server. 2. Erstellen Sie mit Mitteln des Betriebssystems ein vollständiges Backup folgender Verzeichnisse: - is-installationsverzeichnis - Verzeichnisse, die Grafiken oder Web-Applikationen enthalten - Applikationsspezifische Verzeichnisse Kopieren Sie dazu z. B. alle Verzeichnisse auf einen anderen Server oder in einen anderen Bereich desselben Servers. 3. Sichern Sie die Startskripte, falls Sie diese angepasst haben, z. B. Firewall, Portnummern, Proxy-Einstellungen, Speicherverhalten. 4. Erstellen Sie ein Backup der verwendeten Datenbanken: - is-monitoring- und Task-Datenbank - Liferay-Datenbank - Repository-Datenbank 3 inubit Suite 6 installieren und einrichten 1. Installieren Sie die inubit Suite 6 in ein neues Verzeichnis. 2. Spielen Sie Ihre Lizenz für die inubit Suite 6 ein. Die Lizenz für die inubit Suite 6 muss mindestens denselben Umfang abdecken wie die Lizenz für die Version 5.3. 3. Falls Sie eine andere Datenbank als die mitgelieferte Datenbank für das is-monitoring, Tasks und für das Repository einsetzen möchten, führen Sie folgende Schritte durch: a. Setzen Sie die Datenbank neu auf oder richten Sie einen neuen Workspace in der bisherigen Datenbank ein. Die auf dem Quellsystem vorhandenen Datenbanken/Workspaces müssen bis zum Abschluss der Migration erhalten bleiben! b. Wechseln Sie die is-monitoring-datenbank, die Task- Datenbank und die Repository-Datenbank aus. Siehe 16.12.2011 inubit Suite 6: Migrationsanleitung

Migrationsskript ausführen 5 - is-datenbanken verwalten (Process Engine: Administratorund Entwickler-Guide, Kap. 8, S. 113) - Repository auf Oracle-Datenbank umstellen (Workbench: Benutzer-Guide, Kap. 19.1, S. 487) Möchten Sie Ihr Liferay-Portal migrieren, setzen Sie sich mit dem inubit Support in Verbindung. 4 Migrationsskript ausführen Bei der Migration werden fast alle Prozesse, Artefakte und Konfigurationen, die im Quellsystem erzeugt wurden, in das neue System übernommen bzw. dort angepasst: Systemkonfiguration Z. B. Integration Server-Konfiguration, Customer-Plug-Ins- Konfiguration, Customer-Bibliotheken, Treiber, Repository, Zertifikate im Key Manager, Watchdog-Prozesse des Connection Managers, Applikationsprofile, Portalserver-bezogene Dateien und Portalserver-Einstellungen Benutzer Z. B. Benutzer, Benutzergruppen, Prozessrollen, Diagramme und Module Betriebszustände Z. B. Workflow und Systemkonnektor-Aktivitätsstatus, Prozess- Zustandsdaten (Waitings wie Timeouts, Tasks und Taskliste, Queued-Prozesse, Retries), die komplette is-monitoring- Datenbank sowie die aktuelle Workflow-ID Folgende Komponenten werden nicht migriert: Toolset-Einstellungen und Toolset-Reports PITR-Archiv Datei-Versionen des Repositorys Startskript des Application Servers Ordner Global des Repositorys Liferay Portal-Server ExtJS-Ordner extensions Ordner server/lib Folgende Komponenten werden erst ab einer bestimmten Versionen migriert: Tasks ab Version 5.1 Tasklisten(layouts) ab Version 5.1 inubit Suite 6: Migrationsanleitung 16.12.2011

6 Migrationsskript ausführen Quellsysteme ab Version 5.1.0.66, 5.2.0.95 oder 5.3.0.55 1. Der Aktivitätsstatus der Workflows im Quellsystem wird bei der Migration in das Zielsystem übernommen. Passen Sie ggf. die Aktivitätsstatus der Workflows den Erfordernissen des Zielsystems an. 2. Stellen Sie sicher, dass die im Quellsystem verwendeten Datenbanktreiber im Verzeichnis <is-installdir>/server/ lib/system verfügbar sind. 3. Stoppen Sie den Integration Server des Quellsystems und die inubit Process Engine des Zielsystems. 4. Navigieren Sie im Zielsystem in das Verzeichnis <isinstalldir>/server/migration/ und rufen Sie das Migrationsskript migration.bat bzw. migration.sh auf. Geben Sie als Parameter den Pfad zum Serververzeichnis des zu migrierenden Systems an, z. B. migration.bat C:\Programme\inubit-Suite\5.3.0.55\server. Falls der Pfad Leerzeichen enthält, müssen Sie den Pfad in Hochkommas setzen, z. B.: 'C:\inubit Suite\5.3.0.55\server' Wenn Sie die Migration abbrechen, werden bereits durchgeführte Änderungen am Zielsystem nicht zurückgerollt. Sie können die Migration später einfach neu starten. Quellsysteme mit einer Version kleiner als 5.1.0.66, 5.2.0.95 oder 5.3.0.55 1. Führen Sie mit dem Backup Connector ein Systembackup durch. Siehe Administrator- und Entwickler-Guide der Quellversion. 2. Stoppen Sie den Integration Server des Quellsystems und die Process Engine des Zielsystems. 3. Navigieren Sie im Zielsystem in das Verzeichnis <isinstalldir>/server/migration/ und rufen Sie das Migrationsskript migration.bat bzw. migration.sh auf. Geben Sie als Parameter den Pfad zur Systembackup-Datei an. Beispiel: migration.bat C:\inubit- IS\server\ibis_root\ibis_data\backup\mySystemBac kup.zip Falls der Pfad Leerzeichen enthält, müssen Sie den Pfad in Hochkommas setzen, z. B. 'C:\inubit Suite\5.3.0.55\server' Die Sicherungsdatei wird in ein Standardverzeichnis geschrieben und bei jeder Ausführung des Backup Connectors überschrieben. Dabei gehen die bereits enthaltenen Daten verloren. 16.12.2011 inubit Suite 6: Migrationsanleitung

Remote Connectoren migrieren 7 5 Remote Connectoren migrieren 1. Installieren Sie die Remote Connectoren mit dem Setup der inubit Suite 6 erneut. 2. Übernehmen Sie die Konfiguration der alten Konnektoren aus der Datei remote_conf.xml und der Startdatei. 3. Deinstallieren Sie die alten Remote Connectoren. 6 Externe Einstellungen migrieren Individuelle Konfigurationsänderungen werden nicht automatisch übernommen und dürfen auch automatisch direkt vom Quellsystem übernommen werden. Übertragen Sie diese Anpassungen manuell auf das Zielsystem. Beispiele für individuelle Systemkonfigurationen sind JBOSS- Konfigurationen, Startskripte und Portalanpassungen: Startdateien mit Angabe der Größe des zu verwendenden JVM- Heaps (-Xmx) Anpassungen der Tomcat- oder JBoss-Konfiguration, z. B.: - server.xml in <is-installdir>/server/jboss/ server/default/deploy/jbossweb-tomcat55.sar - jboss-service.xml in <is-installdir>/server/ JBoss/server/default/conf/ - angepasstes Servlet-Mapping in der Tomcat-Konfiguration in der Datei web.xml Änderungen der Portalserverkonfiguration, z. B. portalext.properties im Verzeichnis <is-install-dir>/ server/tomcat/webapps/root/web-inf/classes Dateien zur Konfiguration von Web Applikationen, z. B. CSS- Dateien im Verzeichnis <is-installdir>/server/ ibis_root/conf/form inubit Suite 6: Migrationsanleitung 16.12.2011

8 inubit Suite 6 starten und testen 7 inubit Suite 6 starten und testen Nach der Migration sind nur die Workflows aktiv, die bereits im Quellsystem aktiv waren. Bei Produktivsystemen kann es sinnvoll sein, das System schrittweise wieder in Betrieb zu nehmen. Dazu aktivieren Sie den Wartungsmodus, bevor Sie inubit Process Engine starten. 1. Öffnen Sie die Datei <is-installdir>/server/ibis_root/ conf/ibis_config.xml. 2. Fügen Sie in der Sektion <Properties version="4.1"> das folgende Element ein: <Property name="servermaintenancemode" type="boolean">true</property> Falls das Element bereits vorhanden 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 Process Engine. 5. Aktivieren Sie den Portalserver und deployen Sie die Portlets. 6. Publizieren Sie die Web-Services in das neue UDDI. 7. Testen Sie die Workflows und Systemanbindungen. 8. Prüfen Sie die Logging- und Monitoring-Informationen. 9. Testen Sie die Portalfunktionalitäten. 16.12.2011 inubit Suite 6: Migrationsanleitung