Zum Inhalt springen

Konfiguration des Jitterbit Design Studio SAP Event Listener

Einführung

Während des Installationsprozesses des SAP Event Listener werden Sie aufgefordert, den SAP Event Listener zu konfigurieren.

Sie können den SAP Event Listener auch nach Abschluss des Installationsprozesses neu konfigurieren. Bei der Neukonfiguration des SAP Event Listener wird empfohlen, den Dienst nach der Konfiguration neu zu starten (siehe Neustart des SAP Event Listener-Dienstes in Installation des SAP Event Listener).

Diese Aktivitäten, die mit der Konfiguration des SAP Event Listener verbunden sind, werden auf dieser Seite im Detail beschrieben:

Wie später auf dieser Seite beschrieben, können Sie beim ersten Konfigurieren des SAP Event Listener den Abschnitt Ereignisdaten der Konfiguration noch nicht ausfüllen. Stattdessen können Sie diesen Abschnitt der Konfiguration leer lassen, bis Sie die erforderlichen Eingaben für dieses Feld erhalten haben. Die erforderlichen Eingaben werden wie in Erstellen einer SAP IDoc-Ereignisoperation und Abrufen von Ereignisdaten in Konfiguration und Verwendung des SAP Event Listener im Design Studio beschrieben.

Für die empfohlene Reihenfolge aller Schritte, die erforderlich sind, um den SAP Event Listener zu konfigurieren und zu verwenden, siehe den SAP Event Listener Einstiegsguide.

Zugriff auf die SAP Event Listener-Konfiguration

Die Methode, mit der auf die SAP Event Listener-Konfiguration zugegriffen wird, hängt davon ab, ob der SAP Event Listener unter Windows oder Linux installiert ist. Da die Konfigurationsfelder für Windows und Linux ähnlich sind, werden sie im nächsten Abschnitt zusammen beschrieben: Eingabe in die SAP Event Listener-Konfiguration.

Windows

Die Konfiguration des SAP Event Listener erfolgt über den Konfigurationsbildschirm des SAP Event Listener.

Um nach der ersten Konfiguration zum Konfigurationsbildschirm zurückzukehren, verwenden Sie das Windows-Startmenü, um Jitterbit SAP Event Listener zu finden, und wählen Sie Jitterbit SAP Listener konfigurieren:

attachment

Der Bildschirm SAP Event-Konfigurationen wird angezeigt:

attachment

Alternativ zur grafischen Eingabe der Konfiguration können Sie die Konfigurationsdatei des SAP Event Listener an folgendem Speicherort manuell bearbeiten:

C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml

Linux

Die Konfiguration des SAP Event Listener über eine direkte Verbindung erfolgt durch Ausführen eines Shell-Skripts in der Befehlszeile. Wechseln Sie in das entsprechende Verzeichnis und führen Sie dann das Skript aus:

# cd /opt/jitterbitsap/bin

# ./runconfig.sh

Das Skript durchläuft die anfänglichen Konfigurationsfelder, in denen Sie Eingaben zur Konfiguration des SAP Event Listener bereitstellen:

*SAP Event Configurations*
Sap Connection Properties
    UserName [] : wxyz
    Password [] :
    Application Host [] : ecc99.sapaccess.com
    System Number [] : 00
    Client [] : 800
    Language [en] : en

SAP Event Connection Properties
    GateWay Host [] : ecc99.sapaccess.com
    GateWay Service [] : sapgw00
    Listener Count [1] : 1

URL [https://127.0.0.1:46908/jitterbit_sap_destination] : http://127.0.0.1:46908/jitterbit_sap_destination

Um den SAP Event Listener so zu konfigurieren, dass er eine Lastenausgleichsverbindung verwendet, müssen Sie die Konfigurationsdatei des SAP Event Listener an folgendem Speicherort manuell bearbeiten:

/opt/jitterbitsap/data/JitterbitSAPEventListener/conf/sapeventconfig.xml

Im Abschnitt <connection> fügen Sie diese Eigenschaften hinzu:

<eventconfiguration>
    <connection>
        . . .
        <mshost></mshost>
        <mspost></mspost>
        <groupname></groupname>
        <systemid></systemid>
    </connection>
   . . .
</eventconfiguration>

Eingabe in die SAP-Event-Listener-Konfiguration vornehmen

Dieser Abschnitt bietet Definitionen der Felder für die SAP-Event-Listener-Konfiguration für Windows oder Linux.

SAP-Verbindungseigenschaften

Diese Felder werden verwendet, um grundlegende Eigenschaften des SAP-Endpunkts bereitzustellen:

  • SAP-Version: Wählen Sie ECC oder S4 HANA als Version des SAP-Systems. Obwohl diese Einstellung in der Linux-Version nicht verfügbar ist, werden sowohl ECC als auch S4 HANA unterstützt, ohne dass die Version angegeben werden muss.
  • Benutzername: Geben Sie den Benutzernamen für das SAP-System ein.
  • Passwort: Geben Sie das Passwort für das SAP-System ein.
  • Mandant: Geben Sie die numerische Mandanten-ID an, die mit dem SAP-System verbunden ist.
  • Sprache: Geben Sie den Sprachcode für die Sprache ein, in der SAP-Nachrichten gesendet werden sollen, z. B. en für Englisch.
  • Router: Wenn das SAP-System durch eine Firewall geschützt ist, geben Sie die Routerzeichenfolge an, die erforderlich ist, um eine Verbindung herzustellen. Diese Einstellung wird in der Linux-Version nicht unterstützt.

Direkte Verbindung

Vervollständigen Sie diese Felder, wenn der SAP-Endpunkt eine direkte Serververbindung hat. Da nur entweder eine direkte Verbindung oder eine Lastenausgleichsverbindung konfiguriert werden kann, werden diese Felder nicht verwendet, wenn die unter Lastenausgleichsverbindung unten aufgeführten Felder ebenfalls ausgefüllt sind.

  • Anwendungs-Host: Geben Sie den Hostnamen des SAP-Anwendungsservers ein.

  • Systemnummer: Geben Sie die SAP-Systemnummer ein.

Lastenausgleichsverbindung

Geben Sie Werte für diese Felder an, wenn der SAP-Endpunkt Anfragen über einen Lastenausgleich verarbeitet. Da nur entweder eine direkte Verbindung oder eine Lastenausgleichsverbindung konfiguriert werden kann, werden diese Felder nicht verwendet, wenn die unter Direkte Verbindung oben aufgeführten Felder ebenfalls ausgefüllt sind.

Hinweis

Für Linux müssen die Werte für diese Felder manuell in der Konfigurationsdatei des Linux SAP Event Listener definiert werden, anstatt über das Konfigurationsskript, wie im vorherigen Abschnitt beschrieben.

  • MSHost: Geben Sie den Hostnamen des SAP-Messageservers ein.

  • MSPort: Geben Sie den Port des SAP-Messageservers ein.

  • Gruppenname: Geben Sie den SAP-Gruppennamen der Anwendungsserver ein.

  • System-ID: Geben Sie die SAP-System-ID ein.

SAP-Ereignisverbindungsparameter

Diese Felder werden verwendet, um die Verbindung des SAP Event Listener zu konfigurieren:

  • Gateway Host: Geben Sie den Gateway-Host ein.

  • Gateway-Dienst: Geben Sie den Gateway-Dienst ein.

  • Listener-Anzahl: Geben Sie die Anzahl der Listener-Threads an, die Sie als Teil dieses Listener-Dienstes ausführen möchten, abhängig von Ihren Durchsatzanforderungen. Der Standardwert ist 1.

  • Ereignisdetails: Geben Sie die Details jedes IDoc-Ereignisses (tRFC und qRFC) ein. Beachten Sie, dass je nachdem, ob Sie die Windows- oder Linux-Version des SAP Event Listener verwenden:

    • Windows: Während der initialen Konfiguration des SAP Event Listener können Sie die Ereignisdetails leer lassen, wenn Sie diese Details noch nicht generiert haben.

    • Linux: Während der initialen Konfiguration des SAP Event Listener fordert das Shell-Skript nicht dazu auf, Ereignisdetails bereitzustellen. Stattdessen müssen Sie, sobald Sie die Ereignisdetails generiert haben, diese manuell zur Konfigurations-XML-Datei hinzufügen, die sich befindet unter:

      /opt/jitterbitsap/data/JitterbitSAPEventListener/conf/sapeventconfig.xml

    Diese Details müssen für jede in Jitterbit Design Studio erstellte SAP IDoc-Ereignisoperation generiert werden. Nachdem Sie Erstellen einer SAP IDoc-Ereignisoperation und Abrufen von Ereignisdetails in SAP Event Listener Design Studio-Konfiguration und -Verwendung abgeschlossen haben, geben Sie hier die Details jedes IDoc-Ereignisses ein. Beachten Sie beim Eingeben der Details:

  • Der gesamte Inhalt dieses Feldes muss in einem Satz von äußeren <events> und </events> XML-Tags eingeschlossen sein.

  • Innerhalb dieses äußeren Satzes von Tags muss jedes Ereignis in einem Satz von <event> und </event> XML-Tags eingeschlossen sein.

  • Sie können sowohl tRFC- als auch qRFC-Ereignisse eingeben.

    Zum Beispiel:

    <events>
<event>
    <program_id>JITTERBIT</program_id>
    <idoctype>DEBMAS06</idoctype>
    <rfctype>tRFC</rfctype>
    <environment_id>447551</environment_id>
    <operation_guid>ec557feb-b220-400e-9987-fe5d063b7057</operation_guid>
</event>
<event>
    <program_id>JITTERBIT</program_id>
    <idoctype>MATMAS05</idoctype>
    <rfctype>qRFC</rfctype>
    <environment_id>447551</environment_id>
    <operation_guid>bd557feb-b220-400e-9987-fe5d063b7066</operation_guid>
</event>
</events>

    Tipp

    Wenn Sie Ereignisdetails nach der ursprünglichen Konfiguration hinzufügen, starten Sie den SAP Event Listener neu, damit die Konfigurationsänderungen wirksam werden (siehe Neustart des SAP Event Listener-Dienstes in SAP Event Listener-Installation).

    Vorsicht

    Das Feld Ereignisdetails hat derzeit dieses bekannte Problem:

    • SAP Event Listener: Die Windows-Konfigurationsbenutzeroberfläche kann nicht geöffnet werden

      • Zusammenfassung: Beim Versuch, die Windows SAP Event Listener-Konfiguration über die Benutzeroberfläche zu öffnen, tritt eine Ausnahme auf.

      • Zusätzliche Informationen: Dieses Problem tritt auf, wenn eine zuvor gespeicherte Konfiguration, die die erforderlichen äußeren <events> und </events> Tags im Feld Ereignisdetails enthält, versehentlich ohne diese Tags gespeichert wurde.

      • Wiederherstellung: Bearbeiten Sie die Konfigurationsdatei unter C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml manuell, um die erforderlichen äußeren Tags zu ersetzen. Die Windows-Konfigurationsbenutzeroberfläche kann wieder geöffnet werden.

      • URL: Die vorausgefüllte SAP Event Listener-URL. Wenn Sie unserer Empfehlung folgen, den SAP Event Listener auf jedem privaten Agenten in einer privaten Agentengruppe zu installieren, muss der Inhalt in diesem Feld nicht geändert werden. Wenn Sie den SAP Event Listener auf einem anderen Rechner installieren als dem, auf dem der private Agent installiert ist, wenden Sie sich an Jitterbit-Support.

    Tipp

    Für temporäre Fehlersuche in Nicht-Produktionsumgebungen können Sie absichtlich eine ungültige URL in die Konfiguration eingeben. Dies führt dazu, dass der SAP Event Listener den Payload nicht an den Agenten sendet, sondern stattdessen den Payload im Betriebsprotokoll schreibt.

Hinzufügen des Gateway-Ports zur services-Datei

Auf jeder Maschine, auf der der SAP Event Listener installiert ist, muss der SAP-Gateway-Port in der services-Datei des Betriebssystems vorhanden sein. Wenn der Standard-SAP-Gateway-Port (3300) verwendet wird, kann es sein, dass der Port bereits in der services-Datei vorhanden ist oder nicht.

Die services-Datei befindet sich an diesen Verzeichnispfaden:

  • Windows: C:\Windows\System32\drivers\etc\services
  • Linux: /etc/services

SAP-Ports beginnen mit 31, 32 oder 33, gefolgt von einer zweistelligen Systemnummer.

Der Standard-SAP-Gateway-Port beginnt mit 33, gefolgt von 00 als Gateway-Nummer. Das heißt, der Standard-SAP-Gateway-Port ist 3300. Wenn vorhanden, wird der Standard-SAP-Gateway-Port in der services-Datei durch diesen Eintrag dargestellt:

sapgw00  3300/tcp

Wenn der Eintrag für den Standard-Gateway-Port in der services-Datei fehlt oder wenn der Gateway-Port von dem Standard abweicht, müssen Sie ihn zur services-Datei hinzufügen. Wenn die Gateway-Nummer beispielsweise 17 ist, fügen Sie einen Gateway-Port von 3317 zur services-Datei hinzu:

sapgw17  3317/tcp

Nachdem Sie einen Eintrag zur services-Datei hinzugefügt haben, starten Sie den SAP Event Listener-Dienst neu, wie in Neustart des SAP Event Listener-Dienstes in SAP Event Listener-Installation beschrieben.

Testen der Verbindung und Überprüfen, ob der Dienst läuft

Nachdem bestätigt wurde, dass der Gateway-Port zur services-Datei des Betriebssystems hinzugefügt wurde, führen Sie einen Verbindungstest durch, um die eingehende Kommunikation mit SAP zu validieren und zu überprüfen, ob der SAP Event Listener-Dienst läuft. Der Dienst sollte auch dann laufen, wenn der Abschnitt Ereignisdetails der SAP Event Listener-Konfiguration noch nicht abgeschlossen ist.

Windows

Unter Windows klicken Sie im Konfigurationsbildschirm des SAP Event Listener auf die Schaltfläche Testverbindung. Ein Dialog sollte anzeigen, dass die Verbindung erfolgreich war:

attachment

Überprüfen Sie, ob der Jitterbit SAP Event Listener-Dienst in den Windows Diensten läuft:

attachment

Linux

Unter Linux ist das Testen der Verbindung der letzte Schritt des Konfigurationsskripts. Wenn Sie aufgefordert werden, die Verbindung zu testen, geben Sie y ein:

Perform test connection [y/n]?y

Eine Ausgabe, die dieser für einen erfolgreichen Verbindungstest ähnelt, wird angezeigt:

KFile is ../data/JitterbitSAPEventListener/conf/.pk is exist false

. . .

Test connection to SAP is success.

Überprüfen Sie, ob der SAP Event Listener-Dienst läuft, indem Sie ps -ef verwenden:

# ps -ef | grep -v grep | grep 'jitterbitsap'

Eine Ausgabe, die dieser ähnelt, wird angezeigt:

Djava.util.logging.config.file=/opt/jitterbitsap/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xms512m -Xmx1024m -Djava.endorsed.dirs= -classpath /opt/jitterbitsap/bin/bootstrap.jar:/opt/jitterbitsap/bin/tomcat-juli.jar -Dcatalina.base=/opt/jitterbitsap -Dcatalina.home=/opt/jitterbitsap -Djava.io.tmpdir=/opt/jitterbitsap/temp org.apache.catalina.startup.Bootstrap start

Sie können auch Probleme beheben, indem Sie die catalina.out-Protokolldatei überwachen:

# tail ../logs/catalina.out

Eine Ausgabe, die dieser ähnelt, wird angezeigt:

05-Feb-2021 22:18:13.534 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/manager]
05-Feb-2021 22:18:13.561 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/manager] has finished in [27] ms
05-Feb-2021 22:18:13.562 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/ROOT]
05-Feb-2021 22:18:13.572 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/ROOT] has finished in [10] ms
05-Feb-2021 22:18:13.572 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/examples]
05-Feb-2021 22:18:13.750 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/examples] has finished in [178] ms
05-Feb-2021 22:18:13.751 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/host-manager]
05-Feb-2021 22:18:13.762 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/host-manager] has finished in [11] ms
05-Feb-2021 22:18:13.766 INFO [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler ["http-nio-8080"]
05-Feb-2021 22:18:13.787 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 1647 ms