Komponentenupgrades abschließen

Für bestimmte InterChange Server-Komponenten sind zusätzliche Tasks erforderlich, damit der Upgrade abgeschlossen werden kann. Die folgenden Abschnitte beschreiben, wie Sie diese Upgrades vollständig beenden:

Import in ICL ausführen

Wichtiger Hinweis:
Ob Sie die Schritte in diesem Abschnitt ausführen müssen, ist von der aktuellen Version von InterChange Server abhängig:

Ab Version 4.2.x erfolgt die Entwicklung von ICS-Komponenten nicht mehr (wie in der Version 4.1.1) in der ICS-Instanz, sondern lokal. Daher müssen Sie bei einem Upgrade ausgehend von Version 4.1.1 eine ICL in System Manager erstellen. Die ICL enthält die InterChange Server-Komponenten. Anweisungen zur Erstellung von ICLs enthält das Handbuch System Integration Guide. Nachdem Sie eine ICL (oder mehrere ICLs) erstellt haben, können Sie Komponenten aus dem InterChange Server-Repository importieren.

Anmerkung:
Es empfiehlt sich, die ICS-Komponenten einzeln zu importieren, da der Import eines großen Datenblocks viel Zeit in Anspruch nehmen und Speicherfehler in System Manager verursachen kann. Falls Sie ungewöhnlich viele Komponenten verwenden, kann eine weitere Untergliederung des Importprozesses ebenfalls sinnvoll sein. Die empfohlene Reihenfolge für den Komponentenimport ist in Tabelle 17 angegeben.

Tabelle 17. Importreihenfolge für ICS-Komponenten
Reihenfolge ICS-Komponente Importschritte
1 Geschäftsobjekte

Importieren Sie die bereits vorhandenen Geschäftsobjektdefinitionen aus dem ICS-Repository in System Manager in eine ICL. Detaillierte Angaben zum Importieren von Komponenten mit dem System Manager-Assistenten "Komponenten importieren" finden Sie im Handbuch Implementation Guide for WebSphere InterChange Server.

2 Zuordnungen Upgrades von Collaborationschablonen und Zuordnungen vornehmen
3 Collaborationschablonen und -objekte Upgrades von Collaborationschablonen und Zuordnungen vornehmen
4 Connectors Connector-Upgrades abschließen
5 Beziehungen

Importieren Sie die bereits vorhandenen Beziehungsdefinitionen aus dem ICS-Repository in System Manager in eine ICL. Detaillierte Angaben zum Importieren von Komponenten mit dem System Manager-Assistenten "Komponenten importieren" finden Sie im Handbuch Implementation Guide for WebSphere InterChange Server.

Upgrades von Collaborationschablonen und Zuordnungen vornehmen

Nach dem Upgrade des ICS-Repositorys können Sie den Upgrade von bereits vorhandenen Zuordnungen und Collaborationschablonen vornehmen. Dies umfasst die folgenden Schritte:

Upgrade für Klassendateien von Komponenten vornehmen

Sie müssen unbedingt Ihre bereits vorhandenen Java-Klassendateien (.class) für Zuordnungen und Collaborationschablonen prüfen, um sicherzustellen, dass der Code mit der neuen Version kompatibel ist.

Anmerkung:
Vergewissern Sie sich, dass sich die Klassendateien im geeigneten Verzeichnis der neuen Version befinden:

Prüfen Sie, ob die bereits vorhandenen Java-Klassendateien den folgenden Code enthalten:

Beim Ändern von Java-Klassendateien müssen Sie den Code erneut kompilieren und die zugeordnete Komponente im ICS-Repository erneut implementieren. Informationen zum Kompilieren von Zuordnungen enthält das Handbuch Map Development Guide. Angaben zur Kompilierung von Collaborationschablonen finden Sie im Handbuch Collaboration Development Guide.

Connector-Upgrades abschließen

Dieser Abschnitt beschreibt die Schritte für den Upgrade eines Connectors auf die Version 4.3 von InterChange Server:

  1. Installieren Sie die relevanten Adapter.
  2. Nehmen Sie einen Upgrade des Connectors auf den Integrationsbroker vor:
  3. Falls Sie Startscripts für Connectors angepasst haben, müssen Sie möglicherweise einen Upgrade dieser Scripts ausführen. Weitere Informationen finden Sie unter Upgrade der Connectorstartscripts vornehmen.
  4. Prüfen Sie den Connector-Upgrade. Weitere Informationen finden Sie unter Connectorkonfiguration prüfen.

Upgrade von Connectors auf neue ICS-Version vornehmen

Damit WebSphere Business Integration Adapters mit InterChange Server verwendet werden kann, müssen Sie Version 2.4 von WebSphere Business Integration Adapter installieren. Bei einer neuen Installation können Sie jedoch nicht einfach alle vorhandenen Adapterverzeichnisse (die Verzeichnisse in den Unterverzeichnissen des Verzeichnisses PRODUKTVERZ\connectors) kopieren, da es sich hierbei um gemeinsam genutzte Komponenten handelt, die vom Installationsprogramm für WebSphere Business Integration Adapters bereitgestellt werden. Weil nicht mehr alle Adapter mit einem einzigen Installationsprogramm installiert werden können, müssen Sie jeden relevanten Adapter mit seinem eigenen Installationsprogramm installieren.

Anmerkung:
Wenn Sie InterChange Server als Integrationsbroker verwenden, müssen Sie das Produkt für das Adapter-Framework installieren.

Ausführlichere Anweisungen zur Installation von Adaptern finden Sie in den einzelnen Adapterhandbüchern.

Wenn die ICS-Konfigurationsdatei (InterchangeSystem.cfg) Informationen zu Connectoragenten enthält, wird für jeden angegebenen Connector eine separate connectorspezifische Konfigurationsdatei erstellt.

  1. Geben Sie die lokale Konfigurationsdatei an, die für den jeweiligen Connector aktualisiert wurde:

    1. Navigieren Sie auf "Start > Programme > IBM WebSphere Integration Adapters > Adapter > Connectors > connectorname.
    2. Klicken Sie mit der rechten Maustaste auf den Connectornamen, und wählen Sie "Eigenschaften" aus.
    3. Fügen Sie den Befehl -c dateiname am Ende des Pfads für das Zielfeld hinzu. Hierbei steht dateiname für den vollständig qualifizierten Pfad der Konfigurationsdatei, die Einträge für diesen Connector enthält.
  2. Um eine Connectordefinition nach dem Upgrade in das Repository aufzunehmen, öffnen Sie die neue Connectordefinitionsdatei, die mit Ihrem Connector bereitgestellt wird (normalerweise lautet der Name der Datei connectorname.txt) im Connector Configurator.

    Legen Sie bei geöffneter Datei im Connector Configurator die Connectoreigenschaften fest, und wählen Sie dann die Option für das Speichern als Projekt aus, um die Konfiguration in System Manager zu speichern. Von System Manager aus können Sie die neue Connectorkonfiguration in InterChange Server implementieren. Dieser Vorgang ist im Handbuch Implementation Guide for WebSphere InterChange Server beschrieben.

    Anmerkung:
    Um sicherzustellen, dass die neuesten Eigenschaften für den Connector nach dem Upgrade verwendet werden, lesen Sie die Angaben im entsprechenden Adapterhandbuch nach.

Fall Sie einen Upgrade des Produkts "WebSphere Business Integration Adapters" vornehmen und ICS als Integrationsbroker verwenden, müssen Sie alle Anpassungen der Adapterdirektaufrufe erneut anwenden. Die Direktaufrufe werden beim Adapterupgrade überschrieben.

WebSphere-Nachrichtenbroker auf ICS migrieren

So können Sie Ihre Connectors von einem WebSphere-Nachrichtenbroker (entweder MQ Integrator, MQ Integrator Broker oder Business Integration Message Broker) auf das InterChange Server-System migrieren:

  1. Kopieren Sie die connectorspezifische Konfiguration und die Geschäftsobjektdefinitionsdateien (.xsd) aus dem Verzeichnis des WebSphere-Nachrichtenbrokers in das Verzeichnis von InterChange Server.
  2. Überprüfen Sie, ob alle in der lokalen Konfiguration angegebenen Warteschlangen für InterChange Server gültig sind.
  3. Ändern Sie die Connectoreigenschaft DeliveryTransport mit dem Tool "Connector Configurator" von "WebSphere Message Broker-JMS" in JMS.
  4. Ändern Sie die Eigenschaft RepositoryDirectory mit dem Tool "Connector Configurator" in REMOTE.
  5. Nehmen Sie einen Upgrade der Connectoreigenschaften vor:
  6. Nehmen Sie mit dem Tool "Business Object Designer" einen Upgrade der Geschäftsobjektdefinitionsdateien (.xsd) vor, damit die Informationen zur Ländereinstellung enthalten sind.
  7. Erstellen Sie mit dem Tool "System Manager" ein Projekt, das die connectorspezifische Konfiguration und die Geschäftsobjektdefinitionsdateien enthält.
  8. Implementieren Sie das Projekt im ICS-Repository. Informationen zum Implementieren des Projekts finden Sie im Handbuch Implementation Guide for WebSphere InterChange Server.

Upgrade der Connectorstartscripts vornehmen

Alle Startscripts von InterChange Server wurden geändert, damit die Migration vom VisiBroker-ORB auf den IBM Java ORB ermöglicht wird. Falls Sie Startscripts für Connectors einer Vorgängerversion von 4.3 geändert haben, müssen Sie an den neuen Startscripts ebenfalls entsprechende Änderungen vornehmen.

Dieses Release führt eine Struktur für die Startscripts ein, die im Wesentlichen in den folgenden Punkten geändert wurde:

Anmerkung:
Die meisten von IBM gelieferten Adapter verwenden diese neue Struktur noch nicht für ihre Startscripts. Die Startscripts dieser von IBM gelieferten Adapter müssen nicht geändert werden. Sie sollten nur die Startscripts für angepasste Adapter ändern.

Falls Sie in einem Vorgängerrelease Connectorstartscripts angepasst haben, sollten Sie diese Scripts erneut untersuchen und sicherstellen, dass die Anpassungen in dieser neuen Struktur der Startscripts in der korrekten Datei angegeben sind.

Anmerkung:
Vergewissern Sie sich, dass in den Connectorstartscripts die Dateien ".jar" in den Variablen CLASSPATH (oder JCLASSES) für alle angepassten Datenhandler enthalten sind, die vom Connector verwendet werden. Achten Sie insbesondere auf die Reihenfolge, in der die Datenhandler in der Variablen CLASSPATH aufgelistet sind. Falls Sie z. B. den XML-Datenhandler verwenden, achten Sie darauf, dass die Datei CwXMLDataHandler.jar vor der Datei CwDataHandler.jar angegeben ist. Beide dieser Dateien ".jar" enthalten eine Datei xml.class, und es muss sichergestellt sein, dass die in CwXMLDataHandler.jar enthaltene Datei ausgeführt wird.

Connectorkonfiguration prüfen

Nachdem Sie alle Connectoränderungen oder -Upgrades vorgenommen haben, müssen Sie sicherstellen, dass der Connector für die neue Umgebung korrekt konfiguriert ist. Gehen Sie hierzu folgendermaßen vor:

Upgrade für Zugriffsclients vornehmen

Da VisiBroker seit Version 4.2.2 durch IBM ORB ersetzt wurde, ist VisiBroker in Version 4.3.0 von InterChange Server möglicherweise nicht vorhanden. Der mit der Installation von 4.3.0 ausgelieferte IBM ORB ist der einzige unterstützte Zugriffsclient. Damit die alten Zugriffsclients mit Version 4.3 weiterhin verwendet werden können, sind einige wenige Änderungen erforderlich. Der Code muss folgendermaßen geändert werden:

...
 Properties orbProperties=new java.util.Properties();
 orbProperties.setProperty("org.omg.CORBA.ORBClass", "com.inprise.vbroker.orb.ORB");
 orbProperties.setProperty("org.omg.CORBA.ORBSingletonClass", 
 "com.inprise.vbroker.orb.ORBSingleton");
 org.omg.CORBA.ORB orb = org.omg.CORBA.ORB.init((String[])null, orbProperties);
 ...
 

Entfernen Sie die beiden Zeilen, die Methodenaufrufe von "setProperty()" mit Verweisen auf VisiBroker-Klassen (com.inprise.vborker.org.*) enthalten, damit das Framework anstelle von VisiBroker die ORB-Standardimplementierung von JDK verwendet.

Zugriffsclients können mit jedem Standard-ORB verwendet werden, der zu CORBA 2.3 konform ist. Bei ORB anderer Hersteller als IBM wenden Sie sich hinsichtlich möglicher Kompatibilitätsanforderungen an den Hersteller des jeweiligen ORB.

Wie im Folgenden gezeigt, kann ein Zugriffsclient weiterhin die Methode "IgetInterchangeAccessSession()" verwenden, um seine Zugriffssitzung zu erhalten:

accessSession = accessEngine.IgetInterchangeAccessSession(userName, passWord);
 

Aufgrund der in Version 4.3 eingeführten Sicherheitsmechanismen empfiehlt es sich, die Zugriffssitzung stattdessen durch die Verwendung von "SecureLoginUtility" zu erhalten:

Properties props = new Properties();
 props.put("username", "admin");
 props.put("password", "admin");
 accessSession = SecureLoginUtility.login(accessEngine , props);
 

Auf diese Weise werden der Benutzername und das Kennwort verschlüsselt. So wird verhindert, dass vertrauliche Informationen während der Übertragung ausgespäht werden können.

Upgrade anderer Komponenten vornehmen

Falls Sie weitere Komponenten erstellt haben, die angepasste JAR-Dateien enthalten (z. B. Datenhandler), müssen Sie die angepassten JAR-Dateien in die entsprechende Position der neuen Verzeichnisstruktur kopieren. Normalerweise befinden sich angepasste JAR-Dateien im Unterverzeichnis lib des Produktverzeichnisses.

Anmerkung:
Sie müssen außerdem sicherstellen, dass diese angepassten JAR-Dateien in den entsprechenden Startscripts aufgeführt sind. Weitere Informationen finden Sie unter Upgrade der Serverstartscripts vornehmen.

Benutzerprojekte verarbeiten

Wichtiger Hinweis:
Ob Sie die Schritte in diesem Abschnitt ausführen müssen, ist von der aktuellen Version von InterChange Server abhängig:

Vorhandene Benutzerprojekte importieren

Falls Sie Ihre vorhandenen Benutzerprojekte exportiert hatten, können Sie sie importieren, sobald ICS aktiv ist. Stellen Sie eine Verbindung von System Manager zu Ihrer ICS-Instanz her, und gehen Sie folgendermaßen vor:

  1. Erweitern Sie den Ordner "Benutzerprojekte", klicken Sie mit der rechten Maustaste auf "InterChange Server - Projekte", und wählen Sie die Option "Lösung importieren" aus.
  2. Wählen Sie die Ordnerposition aus, die Sie beim Export aus der Vorgängerversion von 4.3 erstellt haben.
  3. Prüfen Sie, ob alle Benutzerprojekte erfolgreich importiert worden sind.

Projekte erstellen

Es empfiehlt sich, für jede Schnittstelle ein Projekt sowie ein separates Projekt für allgemeine Komponenten (z. b. Metaobjekte und Connectors) zu erstellen. Stellen Sie eine Verbindung von System Manager zu Ihrer ICS-Instanz her, und gehen Sie folgendermaßen vor:

  1. Klicken Sie mit der rechten Maustaste auf "Benutzerprojekte", und wählen Sie die Option "Neues Benutzerprojekt" aus.
  2. Ordnen Sie dem Benutzerprojekt einen Namen zu. Dieser Name sollte die Schnittstelle eindeutig kennzeichnen.
    Anmerkung:
    Der Name eines Benutzerprojektes kann nicht mit dem Namen eines vorhandenen Benutzerprojekts oder eines vorhandenen ICL-Projekts identisch sein.
  3. Wählen Sie die Komponenten für das Benutzerprojekt aus. Bei diesem Schritt wird für jede erforderliche Komponente ein Direktaufruf erstellt. Die Komponenten selbst verbleiben in der ICL.

Weitere Informationen zur Erstellung von Projekten finden Sie im Handbuch Implementation Guide for WebSphere InterChange Server.

Copyright IBM Corp. 1997, 2004