Installation 

Einsatzmöglichkeiten

Sie installieren die Adapter-Engine einschließlich der zur Verfügung stehenden Adapter, um die Adapter anschließend zu konfigurieren und für die benötigte Konvertierung der jeweiligen Message-Formate einsetzen zu können. Je nach Bedarf können Sie die Adapter einzeln oder gemeinsam installieren, und zwar jeweils getrennt für den Eingang (Sender-Adapter) und Ausgang (Empfänger-Adapter) der Integration Engine.

Voraussetzungen

Um Adapter erfolgreich installieren zu können, benötigen Sie folgendes:

●      Ein Java Development Kit (JDK) 1.3 oder 1.4

●      Das Optional-Package Java Servlet Version 2.3 oder höher (servlet.jar), zu finden zum Beispiel auf dem SAP Web Application Server oder direkt im Internet unter http://java.sun.com/products/servlet/index.html (Download von servlet.jar). Das Package kann direkt in das Installationsverzeichnis des Adapters (tech_adapter) kopiert werden; andernfalls muss es sich im Java-CLASSPATH befinden.

·        Zusätzlich für den Betrieb des JMS-Adapters:

○       Das Optional-Package Java Messaging Service (jms.jar), zu finden zum Beispiel auf dem SAP Web Application Server oder direkt im Internet unter http://java.sun.com/products/jms/index.html (Download von jms.jar).

¡        Eine JMS-Treiber-Installation für das zu konnektierende Queue-System (z.B. WebSphereMQ). Die benötigten Java-Bibliotheken sind produktspezifisch und vom Hersteller bzw. externen Anbietern zu beziehen. Sie müssen sich nach der Installation im Java-CLASSPATH befinden, damit der JMS-Adapter zur Laufzeit die benötigten Java-Klassen finden kann.

·        Zusätzlich für den Betrieb des JDBC-Adapters:

Eine JDBC-Treiber-Installation (Version 2.0) für das zu konnektierende Datenbankprodukt. Die benötigten Java-Bibliotheken sind produktspezifisch und vom Datenbankhersteller bzw. externen Anbietern zu beziehen. Sie müssen sich nach der Installation im Java-CLASSPATH befinden, damit der JDBC-Adapter zur Laufzeit die benötigten Java-Klassen finden kann.

·        Zusätzlich für das HTTPS-Protokoll

Sollen die Adapter über HTTPS kommunizieren, werden zusätzliche Bibliotheken zur Implementierung des SSL-Protokolls benötigt. Die Java Bibliotheken iaik_jce.jar und iaik_ssl.jar können Sie – unter Einhaltung der dort beschriebenen Ausfuhrkontrollvorschriften – vom Software Distribution Center des SAP Service Marketplace (http://service.sap.com) unter SAP Cryptograhic Software herunter geladen.

Die beiden Bibliotheken müssen Sie nach der Installation in den Java-CLASSPATH aufnehmen.

○       Sollen die Sender-Adapter mit dem Integration Server über HTTPS kommunizieren, genügt es, wenn Sie bei XI.TargetURL das HTTPS-Protokoll anstelle von HTTP verwenden (also https:// anstatt http://).

○       Sollen die Empfänger-Adapter vom Integration Server über das HTTPS-Protokoll angesprochen werden, müssen Sie den HTTP-Server für die Adapter entsprechend konfigurieren. Dies geschieht mit dem Dienst HttpServer.

○       Soll die Browser-Verbindung zur Konfigurationsoberfläche der Adapter-Engine über das HTTPS-Protokoll erfolgen, müssen Sie den Dienst GuiBrowserEngine entsprechend konfigurieren.

●      Zusätzlich für UNIX-Betriebssysteme

Auf UNIX-Betriebssystemen muss eine Bash-Shell installiert sein, um das Skript run_adapter.sh benutzen zu können. Sonst kann das Skript run_adapter.cmd zum Starten der Plain-J2SE-Adapter-Engine verwendet werden.

Die Java Runtime (java.exe) muss sich im Suchpfad befinden, was bei einer korrekten Installation der Fall sein sollte.

Die gepackte Adapter-Installationsdatei haben Sie in ein frei wählbares Verzeichnis entpackt und die Pfadstruktur haben Sie beibehalten.

Ablauf

Neuinstallation

Unter dem beim Entpacken der Installationsdatei gewählten Verzeichnis befindet sich das Unterverzeichnis tech_adapter mit weiteren Unterverzeichnissen, wie Administration, Configuration und LogFiles.

Zur Adapter-Installation wechseln Sie in das Verzeichnis tech_adapter.

·        Wenn Sie den File/FTP-Adapter installieren möchten, starten Sie auf

○       Windows: install_fileadapter.bat

¡        UNIX: install_fileadapter.cmd

·        Wenn Sie den JDBC-Adapter installieren möchten, starten Sie auf

○       Windows: install_jdbcadapter.bat

¡        UNIX: install_jdbcadapter.cmd

·        Wenn Sie den JMS-Adapter installieren möchten, starten Sie auf

○       Windows: install_jmsadapter.bat

¡        UNIX: install_jmsadapter.cmd

·        Wenn Sie den SOAP-Adapter installieren möchten, starten Sie auf

○       Windows: install_soapadapter.bat

¡        UNIX: install_soapadapter.cmd

Diese Skripte erzeugen die Standardkonfiguration im Adapter-Menu für den jeweiligen Adapter-Typ. Wenn Sie keines der Skripte aufrufen, befinden sich die Standardkonfigurationen aller Adapter im Adapter-Menu. Die Konfiguration des Adapter-Menus kann über die dort vorhandenen Funktionen aber in jedem Fall modifiziert werden.

Nach der Installation der J2SE-Adapter-Engine sind die x-bits für die Skripte wie install_fileadapter.cmd, run_adapter.sh oder run_adapter.cmd nicht gesetzt. Ändern Sie das mit den folgenden Kommandozeilen:

chmod 755 *.cmd

chmod 755 *.sh

·        Wenn Sie die Adapter-Engine starten möchten, starten Sie auf

○       Windows: run_adapter.bat

¡        UNIX: run_adapter.cmd bzw. run_adapter.sh

Nach dem Ausführen von run_adapter.bat bzw. run_adapter.cmd können Sie die Adapter-Engine über einen Browser aufrufen. Die entsprechende Adresse lautet standardmäßig http://<hostname>:8200, die Anmeldung beim ersten Aufruf geschieht über den User sap mit Kennwort init. Dieser initiale Benutzer sollte nach dem Anlegen neuer Benutzer baldmöglichst gelöscht werden.

Sollte der Standard-Port 8200 der Adapter-Engine bereits belegt sein, müssen Sie in der Datei GuiBrowserEngine.properties unter port= einen freien Port eintragen.

Ist dieser Port ebenfalls bereits belegt, gibt die Adapter-Engine in dem Fenster, in dem sie gestartet wurde, die folgende Fehlermeldung aus und beendet sich:

ERROR starting Adapter engine base service ´GUI´

Damit ist die Installation abgeschlossen. In der Konfigurationsoberfläche der Adapter-Engine finden Sie jeweils zwei Adapter (Sender und Empfänger) des gewählten Adapter-Typs (bzw. einen SOAP-Adapter), die Sie dort konfigurieren können.

Beim SOAP-Adapter legen Sie den Unterschied zwischen Sender und Empfänger bei der Konfiguration fest, das heißt, es gibt nach der Installation immer nur einen SOAP-Adapter, von dem Sie dann gegebenenfalls zwei unterschiedliche Instanzen konfigurieren müssen.

Möchten Sie mehrere Adapter des gleichen Adapter-Typs oder verschiedene Adapter-Typen parallel betreiben, oder möchten Sie Adapter automatisch starten, können Sie dies über die Konfigurationsoberfläche der Adapter-Engine konfigurieren.

Upgrade der Installation

Wenn Sie eine neuere Adapter-Version installieren oder aus anderen Gründen die Installation wiederholen wollen, sind zwei Fälle zu unterscheiden:

·        Die bestehenden Adapter-Konfigurationen sollen nicht gesichert werden.

In diesem Fall löschen Sie die bestehende Installation unterhalb des Installationsverzeichnisses komplett und führen eine Neuinstallation wie oben beschrieben durch; die Adapter-Engine hält keinerlei Daten außerhalb dieser Verzeichnisstruktur.

·        Die bestehenden Adapter-Konfigurationen sowie die Benutzerverwaltung sollen gesichert werden.

...

                            a.      Wechseln Sie in das Verzeichnis tech_adapter unterhalb des Installationsverzeichnisses und führen Sie dort die folgende Datei aus:

Windows: save_configuration.bat

Unix: save_configuration.cmd

Dadurch wird neben dem Verzeichnis tech_adapter das Verzeichnis adapter_configuration.backup erzeugt, das alle relevanten Dateien der Adapter Konfigurationen und der Benutzerverwaltung enthält.

Sind zusätzlich Konfigurationen der Dienste geändert worden und sollen diese Konfigurationen ebenfalls gesichert werden, führen Sie zusätzlich die folgende Datei aus:

Windows: save_baseconfiguration.bat

Unix: save_baseconfiguration.cmd

                            b.      Löschen Sie das Verzeichnis tech_adapter unterhalb des Installationsverzeichnisses.

                            c.      Führen Sie eine Neuinstallation wie oben beschrieben durch. Anstelle der Installationsskripts führen Sie im Verzeichnis tech_adapter die folgende Datei aus

Windows: restore_configuration.bat

Unix: restore_configuration.cmd

Hierdurch werden die Konfigurationen der Adapter wieder hergestellt, einschließlich der Benutzerverwaltung. Haben Sie zusätzlich die Konfigurationen der Dienste gesichert, erhalten Sie auch diese Konfigurationen wieder. Ansonsten sind die Dienste in ihrer initialen Konfiguration vorhanden, wie nach einer Neuinstallation.

Upgrade der Installation von einer XI 2.0 Adapter Engine

Möchten Sie XI 2.0 Adapter-Konfigurationen in eine XI 3.0 Adapter-Engine übernehmen, beachten Sie, dass die XI 3.0 Adapter-Engine Konfigurationen der XI 2.0 Adapter-Engine erkennt und wie folgt behandelt:

●      Gleichnamige Parameter werden gleich interpretiert

●      Parameter mit dem Namensraum XMB gibt es in der XI 3.0 Adapter-Engine nicht mehr. Soweit es gleichnamige Parameter mit Namensraum XI gibt, werden sie so wie diese interpretiert.

●      Die Parameter XMB.SenderBusinessSystem und XMB.ReceiverBusinessSystem werden als XI.SenderService bzw. XI.ReceiverService interpretiert.

●      Die Parameter XMB.SenderInterfaceNamespace und XMB.SenderInterfaceName werden als XI.InterfaceNamespace bzw. XI.Interface interpretiert.

●      Die Parameter  XMB.SenderAdapterForBusinessSystem und XMB.ReceiverAdapterForBusinessSystem werden als XI.SenderAdapterForService bzw. XI.ReceiverAdapterForService interpretiert.

●      Die Parameter XMB.ContentType und XMB.ContentKind haben keine Entsprechung und werden ignoriert. Beim File/FTP-Sender-Adapter gibt es stattdessen den Parameter file.type. XMB.ContentKind wird entsprechend als Binär- bzw. Textdatei-Typ im Sinne von file.type interpretiert. Dies gilt entsprechend für die Angaben bei zusätzlichen Dateien in einer Message (siehe hierzu die Beschreibung zu XI.AdditionalPayloads in File/FTP-Sender-Adapter konfigurieren).

Dauerbetrieb

Um einen Dauerbetrieb der Adapter-Engine zu ermöglichen, gibt es folgende, betriebssystemabhängige Installationsmöglichkeiten:

·        WindowsNT

Im Installationsverzeichnis der Adapter-Engine befindet sich im Verzeichnis tech_adapter das Programm SAPAdapterService.exe, mit dem die Adapter-Engine als NTService gestartet werden kann. Zur Installation bzw. Deinstallation des NTService benutzen Sie die Skripte install_service.bat bzw. uninstall_service.bat. Die Aufrufkonventionen hierzu lauten:

¡        install_service.bat [ServiceName] [JavaVM]

¡        uninstall_service.bat [ServiceName]

Hierbei ist [ServiceName] ein logischer Name, unter dem der Service angelegt wird, und [JavaVM] der Name der DLL der Java Virtual Machine mit kompletter Pfadangabe. Entsprechende Beispiele befinden sich im Skript.

Alle jar-Dateien (zum Beispiel der JDBC- oder JMS-Treiber), die von den Adaptern gegebenenfalls zusätzlich benötigt werden, müssen sich hierbei im Java-Classpath befinden, wenn install_service.bat aufgerufen wird. Nachfolgende Änderungen des Classpath wirken sich auf den angelegten NTService nicht aus.

Nach der Installation müssen Sie die Adapter-Engine als NTService im Services-Menü von Windows starten bzw. wie jeden NTService konfigurieren (StartUp Type, Logon Information, etc.).

In der Ereignisanzeige von Windows werden im Anwendungsprotokoll unter dem vergebenen Servicenamen Informationen und Fehlermeldungen des Services ausgegeben. Die Konsolen- und Fehlerausgabe der Adapter-Engine wird in die beiden Dateien stdout.log bzw. stderr.log im Unterverzeichnis LogFiles umgeleitet.

·        Unix

Für Unix-Betriebssysteme befindet sich im Verzeichnis tech_adapter das Skript run_adapter.sh. In diesem Skript müssen Sie die Variable ADAPTER_HOME dem Installationspfad anpassen. In der Variable EXTLIBS können Sie alle Jar-Dateien spezifizieren, die zusätzlich von der Adapter-Engine benötigt werden, um beispielsweise einen JDBC- oder JMS-Treiber laden zu können. Weitere Details finden sich im Abschnitt USAGE des Skripts. Sie können das Skript dann in die Boot-Prozedur des Betriebssystems einfügen.

Zugang zum System Landscape Directory

Die Adapter-Engine verfügt über einen Zugang zum System Landscape Directory (SLD). Hiermit kann sich beim Starten die Adapter-Engine am SLD anmelden und wird so in der Runtime Workbench als Komponente der Exchange Infrastructure aufgenommen und zugreifbar.

Optional werden auch Assoziationen zwischen einzelnen Empfänger-Adaptern und Business-Systemen angelegt, wenn ein Business-System in der Konfiguration eines Empfänger-Adapter angegeben ist. Die Adressen der assoziierten Adapter werden dann beim Anlegen von Endpunkten für das Business-System vom Integration Directory automatisch als Vorschlagswert übernommen.

Darüber hinaus können mit Business-Systemen verbundene Informationen ausgelesen werden. Details zur Konfiguration dieses Dienstes finden Sie unter SLDaccessor bei den Diensten.

Der Dienst ist optional, was bedeutet, dass die Adapter-Engine auch ohne einen Zugang zum SLD betrieben werden kann.

Monitoring durch die Runtime Workbench

Die Adapter-Engine verfügt über einen Monitoring-Eingang für die Runtime Workbench. Der Aufruf erfolgt hierbei über den gleichen HTTP-Eingang wie die Konfiguration. Zur Anmeldung wird der technische Benutzer XIRWBUSER mit Kennwort XIPASS ohne weitere Berechtigung benötigt. Dieser Benutzer wird bereits bei der Installation der Adapter-Engine automatisch angelegt. Der Benutzer muss das selbe Kennwort haben wie im ExchangeProfile und in ABAP.

Wird dieser Benutzer gelöscht (zum Beispiel durch das Einspielen einer älteren Konfiguration nach der Installation), oder benötigt die Runtime Workbench einen anderen Benutzer, müssen Sie einen entsprechenden Benutzer anlegen. Hierzu genügt die Berechtigungsgruppe Gesperrt. Nähere Informationen zum Anlegen von Benutzern finden Sie unter Benutzerverwaltung.