Agenten für SAP installieren

Dieses Thema führt Sie durch die Installation eines SAP-Agenten.

Hinweise:

Diese Seite beinhaltet Folgendes:

Voraussetzungen

Hinweis: Stellen Sie sicher, dass Sie über folgende Informationen verfügen, bevor Sie mit der Installation beginnen.

  1. Zugang zum SAP Service Marketplace (http://service.sap.com):

    • Name und Passwort

  2. SAP-Benutzeradministrator:

    • Name und Passwort

  3. (Optional) SAP Transport-System-Administrator:

    • bei Verwendung der AE-Benutzeroberfläche Name und Passwort des SAP-Systemadministrators

    • beim Betrieb des Systems mit der SAP-GUI Name und Passwort des SAP-Transport-Systemadministrators

  4. Parameter für den RFC-Zugriff auf das jeweilige SAP-System:

    • Name des SAP-Systems

    • Host-Name einer SAP-Instanz oder ein SAP-Router-String - host

    • SAP-Systemnummer sysnr

    • (Optional) Computername oder SAP-Router-String des Message-Servers lb_host

    • (Optional) Login-Gruppe Ib_group

  5. Zugriff auf das Betriebssystem.

  6. TCP/IP-Zugriff auf die Automation Engine.

  7. Agentenname.

  8. AE-Installationsverzeichnis.

  9. Zugriff auf den AE-Systemmandanten 0000:

    • Name und Passwort

Agenten für SAP installieren

  1. Installation des Microsoft Visual C++ 2010 Redistributable Package (Windows)

    Ab JCo 3.0.0, JCo unter Windows werden die Visual Studio 2005 C/C++ Laufzeitbibliotheken benötigt. Weitere Informationen finden Sie unter SAP-Hinweis 684106.

    Sie können diesen Schritt überspringen, wenn die gewünschte Version des Packages bereits installiert ist. Sie können über die Systemsteuerung des Computers auf die installierten Programme zugreifen, um zu überprüfen, ob das Package verfügbar ist und wenn ja, welche Version.

  2. Installieren Sie die Java-Laufzeitumgebung.

    Dieser Installationsschritt kann entfallen, wenn die erforderliche Version der Java-Laufzeitumgebung bereits verfügbar ist. SAP-Hinweis 684106 beschreibt, welche JREs unterstützt werden.

    Auf dem Admin-Computer und/oder Benutzercomputer:

    • Überprüfen Sie die aktuelle Version der Java Virtual Machine (JVM) Ihres Systems mit dem folgenden Befehl:

      • java -version

      Beachten Sie, dass die Reihenfolge der angegebenen Verzeichnisse bei der Angabe von %PATH% oder $PATH relevant ist, wenn mehrere Versionen von JRE oder Java JDK auf Ihrem Computer installiert sind. Es wird die zuerst aufgeführte Java-Laufzeitumgebung verwendet.

    • Laden Sie die erforderliche Java-Laufzeitumgebung unter http://java.com herunter und installieren Sie diese.

  3. Installieren Sie den Agenten

    • UNIX

      Auf dem Host-Computer:

      • Melden Sie sich mit dem AE-Benutzer an.

      • Übertragen Sie die Datei UCXJR3X.tar.gz in ein Verzeichnis (z. B. sap).

      • Wechseln Sie in das sap-Verzeichnis:

        cd sap.

      • Entpacken Sie die .tar-Datei:

        gzip -d UCXJR3X.tar.gz

        tar xvfo UCXJR3X.tar

        Stellen Sie sicher, dass alle Dateien korrekt entpackt wurden und notieren Sie sich alle.tar-Meldungen, die von verschiedenen Eigentümern stammen können. Danach können Sie die.tar-Datei löschen, wenn Sie möchten.

      • Stellen Sie sicher, dass alle Dateien die richtigen Besitzer- und Gruppeneinträge haben.

      • Benennen Sie die mitgelieferte INI-Datei ucxjr3x.ori.ini in ucxjr3x.ini um.

      • Passen Sie die INI-Datei an Ihre Systemumgebung an.

    • WINDOWS

      • Wechseln Sie zum Unterverzeichnis: IMAGE:AGENTS\SAP\WINDOWS.

      • Führen Sie SETUP.EXE aus, um das Programm zu starten.

      • Passen Sie die INI-Datei des SAP-Agenten an Ihre Systemumgebung an. Weitere Informationen finden Sie unter Agent SAP.

      • Passen Sie die Dateien HEADER.SAP, TRAILER.SAP, RESTART.SAP oder HEADER.SAPBW, TRAILER.SAPBW und RESTART.SAPBW nach Bedarf an. Weitere Informationen finden Sie unter Jobs ausführen.

        Der SAP-Agent ist ein AE-Hintergrundprogramm und wird in der Regel als Service im ServiceManager gestartet. Weitere Informationen finden Sie unter ServiceManager.

  4. Installieren Sie den SAP Java Connector

    Auf dem Host-Computer:

    • Eine detaillierte Konfigurations- und Installationsanleitung finden Sie im Archiv des SAP Java Connectors (<sapjco-install-path>/docs/jco/intro.html). Lesen Sie diese Beschreibung sorgfältig durch, um sicherzustellen, dass alles korrekt funktioniert.

      Informationen darüber, welche Java Connector-Version unterstützt wird, finden Sie in den Anforderungen des SAP-Agenten.

      Installieren Sie den 32-Bit SAP Java Connector, wenn Sie 32-Bit-Java verwenden. Für 64-Bit-Java ist der 64-Bit SAP Java Connector erforderlich.

    • Laden Sie den SAP Java Connector aus dem SAP Service Marketplace herunter und installieren Sie ihn (Support Portal -> Downloads -> SAP Connectors -> SAP Java Connector -> Tools & Services).

    • Kopieren Sie die Dateien des SAP Java Connectors in das BIN-Verzeichnis des Agenten.

      Der SAP-Hinweis 636912 enthält Informationen, mit denen Sie überprüfen können, ob der Java Connector korrekt installiert wurde.

    • Testen Sie die Installation mit: java -jar {path-to-sapjco.jar}/sapjco.jar –stdou
      Unter Windows können Sie auf sapjco.jar doppelklicken.
      Es dürfen keine Fehlermeldungen angezeigt werden

  5. AE-Schnittstelle importieren

    Dieser Installationsschritt ist nur erforderlich, wenn Sie die AE-Schnittstelle verwenden möchten.

    Auf dem Host-Computer:

  6. Legen Sie einen Systembenutzer in SAP an.

    Auf dem Host-Computer:

    • Melden Sie sich über den SAP-Benutzeradministrator am SAP-System an.

    • Legen Sie ein Berechtigungsprofil entweder direkt oder mit einer Rolle an. Weitere Informationen finden Sie unter SAP Security Objects.

      Legen Sie einen Benutzer an und ordnen Sie das Berechtigungsprofil oder die Rolle zu.

      Der SAP-System-Benutzer muss in jedem SAP-Mandanten, in dem Sie Jobs ausführen möchten, mit dem gleichen Passwort angelegt werden.

  7. Verbindungsobjekte erstellen

    • Der SAP-Agent benötigt Anmeldedaten, um sich mit den verschiedenen Bereichen in SAP zu verbinden.

    • Öffnen Sie das AWI und melden Sie sich im Systemmandanten 0000 an.

    • Erstellen Sie ein zusätzliches Verbindungsobjekt für die SAP-Bereiche, die mit dem SAP-Agenten verwendet werden sollen (siehe Tabelle unten). Sie müssen auf jeden Fall ein Verbindungsobjekt für die ABAP-Basis erstellen. Tragen Sie dort den SAP-Benutzer ein. Alle anderen Verbindungsobjekte sind optional. Weitere Informationen finden Sie unter Verbindung (CONN).

    • Wählen Sie im Verbindungsobjekt den Typ aus und geben Sie Ihre Zugangsdaten ein:

  8. Agentenobjekt einrichten

    • Wechseln Sie in den Ordner HOST.

    • Erstellen Sie ein Agentenobjekt.

    • Verwenden Sie als Agentennamen den gleichen Namen, der im INI-Dateiparameter name= des SAP-Agenten angegeben ist.

    • Öffnen Sie das Agentenobjekt und wechseln Sie zur Seite Agent und wählen Sie Verbindungsobjekte für jeden Verbindungstyp, den Sie im Abschnitt SAP-Verbindungen verwenden werden.

    • Speichern und schließen Sie das Agentenobjekt.

  9. Starten Sie den Agenten

    Das AE-System muss auf dem Servercomputer laufen. Weitere Informationen finden Sie unter Multi-Server-Vorgänge.

    Auf dem Host-Computer:

    • Verwenden Sie die Kommandos, um den Agenten über die Kommandozeile Ihres Betriebssystems zu starten.

    • Windows:

      <path to java> -Xrs -Xmx256M -jar ucxjr3x.jar

      Wenn Java in einem Ordner installiert ist, der Leerzeichen enthält, muss das Kommando in Anführungszeichen gesetzt werden.

      Zum Beispiel:

      "C:\Program Files (x86)\Java\jre7\bin\java" -jar -Xrs -Xmx256M ucxjr3x.jar

    • UNIX:

      <path to java> -Xmx256M -jar ucxjr3x.jar

      Zum Beispiel:

      /usr/bin/java -jar -Xmx256M ucxjr3x.jar

      Wenn der SAP Java Connector seine native Bibliothek nicht laden kann, kann der Parameter -Djava.library.path verwendet werden, um auf ein Verzeichnis zu verweisen, das die Datei libsapjco3.so enthält.

      Der Agent kann auch über den ServiceManager gestartet werden. Weitere Informationen finden Sie unter ServiceManager.

      Die maximale Größe der Speicherzuweisungspools sollte für das Starten von Java-Agenten (Datenbanken, Rapid Automation, JMX, SAP) auf mindestens 256 MB eingestellt werden. Sie können einen Wert für die Speicherbegrenzung von Java-Anwendungen mit dem Startparameter -Xmx angeben. Die Angabe eines zu niedrigen Wertes kann zum Absturz des Agenten führen. Der Standardwert hängt von der verwendeten Java-Version ab. Dieser Wert muss ein Vielfaches von 1024 größer als 2MB sein. Fügen Sie den Buchstaben k oder K an, um Kilobyte anzugeben, oder m oder M, um Megabyte anzugeben. Wenn große Spool-Listen oder Job-Protokolle übertragen werden, sollte der Wert viel höher sein (z. B. -Xmx1024M).

      Der Java-Parameter -Xrs stellt sicher, dass der Agent im Service Manager weiterläuft, wenn sich ein Benutzer abmeldet. Es ist am besten, diesen Parameter nur unter Windows zu verwenden. Detailliertere Informationen finden Sie in der Java-Dokumentation.

    • Vergewissern Sie sich, dass sich der Agent für SAP angemeldet hat.

    • Informationen über Agenten finden Sie in der Administration-Perspektive. Neu angemeldete Agenten sind noch keinem Mandanten zugeordnet und können daher nur im Mandanten 0000 eingesehen werden. Sie können den neuen Agenten nun über das Agentenobjekt den Kunden mit den erforderlichen Rechten zuordnen. Weitere Informationen finden Sie auf der Seite "Berechtigungen".

  10. Funktionstest

    • Starten Sie einen Test-Job.

      Erstellen Sie ein LOGIN-Objekt und einen SAP_ABAP-Job. Verwenden Sie die Syntax <SAP-Mandant>,<Benutzer> für die Benutzerinformationen im LOGIN-Objekt. Stellen Sie sicher, dass das Kontrollkästchen für den Agenten-Logreport im Jobobjekt aktiviert ist.

      Beispiel-Script für den Testjob:

      R3_ACTIVATE_REPORT REP=RSM04000_ALV,COVERPAGE=YES

      Der aktuelle ABAP erstellt eine Liste der tatsächlichen Benutzer.

    • Überwachen Sie den Prozess im Process Monitoring.

      Es kann einige Sekunden dauern, bis das System registriert, dass der Job abgeschlossen wurde. Der Agent prüft in immer größer werdenden Intervallen, ob der Job noch läuft. Dies geschieht, um zu kurz laufende Jobs frühzeitig zu erfassen. Das Statusprüfungsintervall erhöht sich, je länger der Job läuft. Der Höchstwert kann in der Variablen UC_HOSTCHAR_DEFAULT angegeben werden. Weitere Informationen finden Sie unter UC_HOSTCHAR_DEFAULT - Host-Charakteristika.

    • Überprüfen Sie den Job-Report (PLOG und REP)

    • Überprüfen Sie die Anmeldungen des Agenten in der Protokolldatei.

    • Auf dem SAP-System:

      • Überprüfen Sie die Protokolleinträge der aktuellen Periode mit der Transaktion RZ15 (nur bei Verwendung der Standardschnittstelle).

      • Herunterfahren des Agenten.