Konfiguration

Einsatzmöglichkeiten

Sie konfigurieren die zur Verfügung stehenden Adapter, um sie für die benötigte Konvertierung der jeweiligen Message-Formate einsetzen zu können. Mit der dafür vorgesehenen Adapter-Engine können Sie die Adapter je nach Bedarf einzeln oder gemeinsam konfigurieren, und zwar jeweils getrennt für den Eingang (Sender-Adapter) und Ausgang (Empfänger-Adapter) der Integration Engine.

Folgende Adapter können konfiguriert werden:

Darüber hinaus stellt Ihnen die Adapter-Engine eine Reihe von Diensten zur Verfügung, die von allen Adaptern gemeinsam genutzt werden und die teilweise ebenfalls konfigurierbar sind. Dies sind

ein HTTP(S)-Server für die browser-basierte Konfiguration
eine zentrale Benutzerverwaltung
eine zentrale Ablage von Kennwörtern , die in den Adapter-Konfigurationen benötigt werden
eine Zertifikatverwaltung , die Voraussetzung dafür ist, um sich an Datenbanken, Dateisystemen, etc. über Zertifikat anzumelden.
eine Anzeige zusätzlicher Protokolldateien zur Fehlersuche
eine Testumgebung
Zugriffsmöglichkeiten auf das System Landscape Directory
ein HTTP(S)-Server für die Empfänger-Adapter

Voraussetzungen

Sie haben die Adapter-Engine sowie die gewünschten Adapter erfolgreich installiert , die Adapter-Engine gestartet und anschließend über Ihren Web Browser aufgerufen, und befinden sich jetzt in der Übersicht der Konfigurationsoberfläche der Adapter-Engine.

Ablauf

Das Hauptmenü der Konfigurationsoberfläche der Adapter-Engine besteht aus folgenden Menüpunkten, die Sie per Mausklick aufrufen können:

Adapter
Dokumentation (siehe unten)
Benutzerverwaltung
Kennwortverwaltung
Zertifikatverwaltung
Dienste
Protokolldateien (siehe unten)
Testumgebung
Über die Adapter-Engine
Aktuellen Benutzer abmelden (siehe unten)
Adapter-Engine abschalten (siehe unten)

Dokumentation

Hier werden die verfügbaren Sprachversionen der Dokumentation zur Adapter-Engine als PDF-Dateien zur Verfügung gestellt. Per Mausklick können Sie die gewünschte Datei öffnen, sofern ein entsprechender Viewer installiert ist.

Protokolldateien

Der Menüpunkt ist freigegeben für Benutzer mit der Rolle Administrator.

Hier können die internen Protokolldateien der Adapter-Engine angezeigt werden. Die Inhalte in diesen Dateien sind im Wesentlichen zur Detailanalyse bei Problemen oder anderen Fragen durch die SAP-Hotline gedacht und werden im laufenden Betrieb nicht benötigt; das Format ist undokumentiert.

In der Standardkonfiguration werden wechselseitig fünf Dateien von je ca. 2 MB geschrieben. Die aktuelle Datei ist jeweils am Zeitstempel zu identifizieren. Im Bedarfsfall stehen so die letzten ca. 10 MB Protokollinformationen der Adapter-Engine zur Verfügung. Die Größe bzw. Anzahl dieser Dateien wie auch der Umfang der Informationen wird durch die Datei

logging.propertiestech_adapter

im Verzeichnis gesteuert. Sie sollten nur nach Aufforderung der SAP-Hotline geändert werden.

Die Anzeige wird per Mausklick auf den Dateinamen aktiviert. Die Dateien werden als Dokumente vom Typ Text/Plain übertragen. Die Anzeige erfolgt dann abhängig von der Browser-Konfiguration in einem Text-Viewer oder direkt im Browser.

Über die Adapter-Engine

Hier werden Informationen zur installierten Version der Adapter-Engine und zur verwendeten Java-Laufzeitumgebung angezeigt.

Benutzer mit der Rolle Administrator können hier die Voreinstellung für die Ansicht der grafischen Benutzungsoberfläche der Adapter-Engine vornehmen. Zur Auswahl stehen SAP Web oder SAP GUI. Die hier gewählte Einstellung wird für jeden Benutzer zur Standardansicht, solange in den Benutzereinstellungen nicht explizit eine andere Oberflächenansicht gewählt wird.

Hinweis

Eine Änderung der grafischen Benutzungsoberfläche wird sofort aktiviert. Abhängig von den Cache-Einstellungen des Browsers können allerdings Teile der alten Ansicht sichtbar bleiben, bis diese Teile neu geladen werden oder bis der Browser neu gestartet wird.

Aktuellen Benutzer abmelden

Hier kann sich der aktuelle Benutzer abmelden. Damit wird lediglich die Anmeldung an der Konfigurationsoberfläche beendet; die Adapter verbleiben in ihrem aktuellen Status.

Adapter-Engine abschalten oder neustarten

Dieser Menüpunkt ist freigegeben für Benutzer mit der Rolle Administrator.

Adapter-Engine abschalten
Ein Neustart muss über das Skript
```
run_adapter
```
erfolgen, wie in der Installation beschrieben. Da hierzu eine lokale Anmeldung auf dem Host der Adapter-Engine notwendig ist, kann das Abmelden auch nur in einem auf dem gleichen Host gestarteten Browser durchgeführt werden. Als Bestätigung des Abmeldens wird folgender Text ausgegeben:
```
Adapter-Engine abgeschaltet, Restart mit Skript XXX
```
Hierbei ist
```
XXX
```
der Skript-Name einschließlich des kompletten Pfads.
Alle weiteren Aktionen in den Menüs führen nun zu dem folgenden HTTP-Fehler, da der zur Adapter-Engine gehörende HTTP-Server nicht mehr existiert:
```
The page cannot be displayed
```
Adapter Engine neustarten
Der laufende Adapter-Engine Prozess wird beendet und ein neuer Prozess gestartet.

Dabei werden die Adapter in den gleichen Zustand versetzt, den sie beim Beenden der Adapter-Engine hatten. Zuvor initialisierte und gestoppte Adapter werden initialisiert, zuvor gestartete Adapter werden wieder gestartet.

Melden Sie sich nach dem Neustart der Adapter Engine bei der ersten Aktion im Browser an.

Achtung
Für den Neustart der Adapter-Engine müssen Sie die Adapter-Engine mit den mitgelieferten Scripten run_adapter.bat oder run_adapter.sh betreiben. Die Scripte führen den Neustart durch, nicht der Adapter-Engine Prozess selbst.

Starten Sie die Adapter-Engine mit anderen Scripten oder beispielsweise als Windows-Service, steht die Funktion zum Neustart nicht zur Verfügung und wird auf der Oberfläche nicht angeboten.

Ergebnis

Sie haben die gewünschten Adapter konfiguriert und können nun über die Funktion Testumgebung in der Übersicht die zur Verfügung stehende Testumgebung verwenden, um die Konvertierung der jeweiligen Message-Formate zu testen.