Agent für SAP installieren - Basics

Agent für SAP installieren

Agent für Siebel installieren (Windows)

---

Agent für SAP installieren - Details

Hier finden Sie eine Anleitung für die Neuinstallation eines SAP Agenten.

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

Dieser Schritt ist nur relevant bei der Installation des SAP-Agenten unter Windows.

Ab JCo 3.0.0 benötigt JCo unter Windows Visual Studio 2005 C/C++ runtime libraries. Weitere Details zum Installieren finden Sie im SAP-Hinweis 684106.

Ist das Package bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen. Ob und in welcher Version es vorhanden ist, sehen Sie in der Systemsteuerung -> Software.

• Host
• Das Package aus dem Verzeichnis IMAGE:CRTS installieren.

	2.	Java Runtime Environment (JRE) installieren

Ist JRE bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen.

• Admin-Rechner und/oder Benutzer-Rechner
• Die Version der aktuellen Java Virtual Machine (VM) des Systems kann mit dem folgenden Kommando geprüft werden.

java -version

Sind mehrere Versionen von JRE oder Java SDK auf dem Rechner installiert, so ist bei der Einstellung von %PATH% bzw. $PATH darauf zu achten, dass die Reihenfolge der angegebenen Verzeichnisse relevant ist. Es wird die Java Runtime Umgebung verwendet, die in der Auflistung der Verzeichnisse zuerst gefunden wird.

• Laden Sie das erforderliche Java Runtime Environment von der Seite http://java.sun.com herunter und installieren Sie es. Bei der Installation wird automatisch das Java Plug-in für Web-Browser installiert. Da die AE dieses nicht benötigt, können Sie es in der Systemsteuerung deaktivieren.

	3.	Installieren des Agenten (UNIX)

• Host
• Anmelden mit dem Benutzer "AE".
• Übertragen Sie die Tar-Datei UCXJR3X.tar.gz mittels ftp in ein Verzeichnis (z.B. sap).
• Wechseln Sie in das SAP-Verzeichnis:
  cd sap
• Entpacken des TAR-Files.
  gzip -d UCXJR3X.tar.gz
  tar xvfo UCXJR3X.tar
  Dadurch entstehen die eigentlichen Auslieferungsdateien. Die TAR-Datei kann nach dem Entpacken gelöscht werden.
• Hinweis: Achten Sie bitte unbedingt auf Meldungen von tar, welche z.B. durch unterschiedliche Besitzer hervorgerufen werden können und darauf, dass alle Dateien richtig entpackt werden!
• Überprüfen, ob alle Dateien den richtigen Owner- und Group-Eintrag besitzen. AE muss Owner sein. Die Gruppe muss der Kennung AE entsprechen. Nur ein Benutzer mit entsprechenden Rechten (z.B. root) kann diese Änderungen vornehmen.
  chown UC4 * ändert die Benutzer aller Dateien auf AE.
  chgrp Gruppenname * ändert die BenutzerGruppen aller Dateien.
• Umbenennen der ausgelieferten ini-Datei UCXJR3X.ori.ini in UCXJR3X.ini.
• Anpassen der INI-Datei an die Systemumgebung.

	4.	Installieren des Agenten (Windows)

• Wechseln Sie in das Unterverzeichnis IMAGE:AGENTS\SAP\WINDOWS.
• Starten des Programms SETUP.EXE.
• Anpassen der INI-Datei an die Systemumgebung.
• Eventuell HEADER.SAP, TRAILER.SAP, RESTART.SAP bzw. HEADER.SAPBW, TRAILER.SAPBW, RESTART.SAPBW anpassen. Siehe: Job - Ausführen
• Der SAP-Agent ist ein AE-Hintergrundprogramm. Er wird im Allgemeinen über den ServiceManager gestartet.

	5.	SAP Java Connector installieren

• Host
• Die genaue Anleitung für die Installation und Konfiguration finden Sie im Archiv des SAP Java Connectors (<sapjco-install-path>/docs/jco/intro.html). Lesen Sie diese Beschreibung, um eine korrekte Funktionalität zu gewährleisten.
•  Welche Java Connector Version für welche Version des SAP-Agenten benötigt wird, finden Sie in der Voraussetzungs-Checkliste.
•  Wenn Sie 32bit-Java installiert haben, müssen Sie ebenfalls den 32bit SAP Java Connector verwenden. Bei 64bit-Java, benötigen Sie den 64bit SAP Java Connector!
• Laden Sie den SAP Java Connector vom 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 CallAPIs.
• Der SAP-Hinweis 636912 enthält Informationen zur Überprüfung, ob der Java-Connector korrekt installiert wurde.

	6.	Importieren der AE-Schnittstelle (optional)

• Host
•  Dieser Installationsschritt ist nur bei Verwendung der AE-Schnittstelle erforderlich!
• Kopieren der Transportdateien.
• Importieren des Transportes.
• Siehe auch: AE-Schnittstelle transportieren.

	7.	Anlegen eines CPIC-Users

• Host
• Anmelden am SAP-System mit dem SAP-Benutzeradministrator.
• Anlegen eines Berechtigungsprofils, direkt oder über eine Rolle.
• Anlegen des CPIC-Users und Zuordnung des Berechtigungsprofils oder der Rolle.
•  Beachten Sie, dass dieser CPIC User in jedem SAP Mandanten mit demselben Passwort angelegt werden muss in dem Sie einen Job durchführen wollen!

	8.	Verbindungs-Objekte einrichten

• Admin-Rechner oder Benutzer-Rechner

• Der SAP-Agent benötigt Anmeldedaten, um sich an die verschiedenen Bereiche in SAP anzumelden.
• Starten Sie das UserInterface und melden Sie sich am Systemmandanten 0000 an.
• Legen Sie für die SAP-Bereiche, die Sie mit dem SAP-Agenten nutzen möchten, jeweils ein eigenes Verbindungs-Objekt an (siehe nachfolgende Tabelle). Sie müssen auf jeden Fall ein Verbindungs-Objekt für die SAP Basis erstellen. Tragen Sie dort den CPIC-User ein. Alle anderen sind optional.
• Wählen Sie im Verbindungs-Objekt den Typ aus und tragen Sie die Anmeldedaten ein.

•  Beachten Sie, dass SAP Groß- und Kleinschreibung unterscheidet! Tragen Sie das Passwort entsprechend der Schreibweise ein!

	9.	Agenten-Objekt einrichten

• Admin-Rechner oder Benutzer-Rechner
• Wechseln Sie in den Ordner "HOST".
• Legen Sie ein Agenten-Objekt an.
• Verwenden Sie für den Namen des Agenten-Objektes diesselbe Bezeichnung, die Sie in der INI-Datei des SAP-Agenten im Parameter name= eingetragen haben.
• Öffnen Sie das Agenten-Objekt und wechseln Sie auf die Registerkarte "Agent".
• Wählen Sie die zuvor erstellten Verbindungs-Objekte aus.
• Speichern und schließen Sie das Agenten-Objekt.
•  Sie können anstelle dieses Installationsschrittes den Agenten auch sofort starten. Es wird dann ein Agenten-Objekt automatisch angelegt. Allerdings müssen Sie dann den Agenten beenden, die Verbindungs-Objekte im Agenten-Objekt auswählen und danach den Agenten neu starten.

	10.	Starten des Agenten

• Server-Rechner
• Automation Engine System muss laufen.
• Host
• Starten Sie den Agenten über die Kommandozeile für Ihr Betriebssystem mit folgenden Befehlen
  :
  • Windows:
    

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

  Wenn Java in einem Ordner installiert ist, der Leerzeichen enthält, müssen die Befehle in Anführungszeichen gesetzt werden.

  Beispiel:

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

  • UNIX:

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

  Beispiel:

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

Wenn der SAP Java Connector seine Native Library nicht laden kann, können Sie den Parameter -Djava.library.path verwenden, um auf ein Verzeichnis zu zeigen, das die libsapjco3.so enthält.

Der Agent kann auch mit dem ServiceManager gestartet werden.

Beachten Sie, dass beim Start der Java-Agenten (Datenbanken, RA, JMX, SAP) das Speicherlimit auf mindestens 256 MB (oder 512 MB) gesetzt werden sollte. Sie können den Wert für die Speicherbegrenzung von Java-Anwendungen mit dem Startparameter -XmX festlegen. Wird dieser Wert zu klein gewählt, kann es zum Absturz des Agenten kommen. Der Standardwert hängt von der verwendeten Java-Version ab.

Durch den Java-Parameter -Xrs wird sichergestellt, dass der Agent bei einer normalen Beendigung auch ordnungsgemäß endet. Wir empfehlen daher, diesen Parameter zu verwenden. Mehr Informationen dazu finden Sie in der Dokumentation von Java.

• Es wird im Systemmandant 0000, sofern noch nicht vorhanden, ein Agenten-Objekt automatisch angelegt und im Ordner "HOST" gespeichert.
• Admin-Rechner oder Server-Rechner

• Prüfen, ob sich der Agent für SAB BW angemeldet hat.
  • In der Systemübersicht die Informationen über Agenten abrufen. Da ein neu angemeldeter Agent noch keinem Mandanten zugewiesen ist, wird er nur im Mandant "0000" sichtbar. Der neu installierte Agent kann nun über das Agenten-Objekt den Mandanten mit den gewünschten Rechten zugewiesen werden.

	11.	Funktionstest

• Admin-Rechner/Host
• Starten eines Testjobs.
  Der SAP-Rechner ist Host. Zulässige User-ID vergeben. Ablegen des Jobreports in der AE aktivieren.
  Das Script enthält folgende Script-Zeile:
  R3_ACTIVATE_REPORT REP=RSM04000_ALV,COVERPAGE=YES
  Der aufgerufene ABAP erstellt eine Liste der aktiven Benutzer.
• Beobachten des Ablaufs im UserInterface.
   Es kann einige Sekunden dauern, bis das System bemerkt, dass der Job fertig ist. Der Agent prüft periodisch, ob der Job noch läuft. Dieses Intervall kann in der Host-Charakteristik eingestellt werden.
• Kontrollieren des Jobreports.
• Kontrollieren des Agent-Loggings in der Logdatei.
• SAP System
• Prüfen Sie mit Transaktion RZ15 (nur bei der Standard-Schnittstelle) die LOG-Einträge vom aktuellen Zeitraum.
• Beenden des Agenten.