Agenten für SAP IBP installieren

Dieses Thema führt Sie durch die Installation des SAP IBP-Agenten in einem AE-System ohne Authentifizierung. Wenn Sie eine der verfügbaren Authentifizierungsmethoden verwenden möchten, müssen Sie weitere Installationsschritte durchführen. Weitere Informationen finden Sie unter Agenten-Authentifizierung.

Tipp! Diese Seite bezieht sich nur auf den manuellen Installationsprozess. Anweisungen zum Installieren eines Container-Java-Agenten finden Sie unter Container-Java-Agenten installieren.

Am besten installieren Sie den Agenten in einem separaten Verzeichnis (z. B. C:\AUTOMIC\AGENTS\SAPIBP oder Automic/Agent/sapibp).

Wichtig! Bevor Sie den SAP IBP-Agent installieren, überprüfen Sie die Informationen zur Versionskompatibilität unter compatibility matrix. Weitere Informationen zur Verwendung von compatibility matrix finden Sie unter Kompatibilitätsinformationen.

Diese Seite beinhaltet Folgendes:

Eine Verbindung zur Automation Engine herstellen

Die Automation Engine und die Windows-, UNIX- und Java-Agenten kommunizieren unter Verwendung von TLS/SSL. Diese Agenten richten eine Verbindung zum Java-Kommunikationsprozess (JCP) ein, der vertrauenswürdige Zertifikate verwendet, um ihre Identität gegenüber anderen Kommunikationspartnern nachzuweisen.

Hinweis: Die TLS/SSL-Implementierung gilt nicht für den HP-UX-Agenten, da er in dieser Version nicht mehr unterstützt wird.

Sie können die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei verwenden, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

Weitere Informationen zu den verschiedenen Zertifikattypen und ausführliche Anweisungen zur Erstellung und Verwendung finden Sie unter Welche Art von Zertifikaten sollte ich für Automic Automation v21 verwenden?

TLS/SSL-Agenten (in Containern und lokal) und das TLS Gatewayrichten bei Verwendung für die Automic Automation Kubernetes Editioneine Verbindung zu einem Ingress-/HTTPS-Load Balancer ein, und nicht direkt zum JCP. Der Ingress-/HTTPS-Load Balancer muss erreichbar sein und benötigt ein Zertifikat zur Authentifizierung. Die Adresse des Load Balancers muss auf beiden Seiten definiert werden: Automation Engine und Agent/TLS Gateway.

Wichtig! Wenn Sie Agenten für ein Automic Automation Kubernetes Edition-System manuell installieren oder aktualisieren, müssen Sie sicherstellen, dass Sie Ihre Agenten und/oder das TLS Gateway konfigurieren, um den TCP- oder HTTPS-Load Balancer zu erreichen, und nicht direkt den CP oder JCP. Stellen Sie außerdem sicher, dass ihr HTTPS-Load Balancer die erforderlichen Zertifikate besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AAKE-Cluster herstellen.

Java Runtime Environment (JRE)

Installieren Sie auf dem Admin- und/oder Benutzercomputer die Java Runtime Environment (JRE).

Wenn Sie die JRE installiert haben, können Sie diesen Schritt ignorieren. Eine Liste der kompatiblen Java-Versionen finden Sie unter compatibility matrix.

Verwenden Sie den folgenden Befehl, um die Version der aktuellen Java Virtual Machine (VM) zu prüfen:

java -version

Wenn mehrere JRE- oder Java SDK-Versionen auf dem Computer installiert sind, stellen Sie sicher, dass die Reihenfolge der Verzeichnisse in den Einstellungen %PATH% oder $PATH korrekt ist, weil die erste JRE verwendet wird, die in der Verzeichnisliste gefunden wird.

Sie können die erforderliche JRE von https://www.oracle.com/java/technologies/ herunterladen.

Mitgelieferte Dateien

Der SAP IBP-Kernt enthält die folgenden Dateien:

  • ecc-ae-sheet-ra-sap-ibp.jar

    Enthält die AWI-Bereiche.

  • uc.msl

    Nachrichtenbibliothek

  • ucxjcitx.ini

    Agent-Konfigurationsdatei

  • ucxjsapibp.jar

    Agentenkern für den Agenten

  • setup.exe

Installieren des Agenten

  1. Falls noch nicht geschehen, installieren Sie die Java Runtime Environment (JRE).

  2. Laden Sie das Installations-Package unter https://docs.automic.com/documentation herunter.

  3. Installieren Sie auf dem Host den Agenten:

    UNIX

    1. Melden Sie sich mit dem AE-Benutzer an.

    2. Übertragen Sie die Datei ucxjsapibp.tar in ein Verzeichnis (z. B. sapibp).

    3. Wechseln Sie in das sapibp-Verzeichnis: cd sapibp.

    4. Entpacken Sie die .tar-Datei:

      gzip -d ucxjsapibp.tar

      tar xvfo ucxjsapibp.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.

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

    6. Benennen Sie die mitgelieferte INI-Datei ucxjcitx.ori.ori.ini in ucxjcitx.ini um..

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

      • Verwenden Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      • name

        Name des Agenten-Objekts.

        Maximale Länge: 32 Zeichen

        Erlaubte Zeichen: "A-Z", "0-9", "_", ".", "$", "@", "-" und "#".

        Bindestriche ("-") sind nur in Agent-Namen zulässig. Sie dürfen in den Namen anderer Objekte nicht verwendet werden.

        Obwohl Agent-Namen auf 32 Zeichen beschränkt sind, sollten Sie sie unter 25 Zeichen halten. Die letzten sieben Zeichen werden für das Hinzufügen des Suffixes '.NEW.nn' verwendet, wenn ein neuer Agent aus seiner Vorlage erstellt wird.

      • system

        Automation Engine Systemname. Dieser Eintrag muss mit dem Eintrag in der .ini-Datei des Automation Engine-Servers identisch sein.

      • ra

        Wird für zusätzliches Tracing verwendet. Bevor Sie einen neu installierten oder aktualisierten Agenten starten, sollten Sie das Rapid Automation-Tracing durch Hinzufügen von ra=99 aktivieren. Dadurch erhalten Sie weitere Informationen zur Fehlerbehebung, wenn während der Installation ein Fehler auftritt. Nach erfolgreichem Agent-Start können Sie ra=0 festlegen und den Agent neu starten, um das Rapid Automation-Tracing zu deaktivieren.

      • connection

        Adresse des Kommunikationsprozesses im Automation Engine-System, mit dem sich der Agent selbst verbinden sollte. Das Format hierbei lautet:

        <DNS-Name oder TCP/IP-Adresse>:<Portnummer>

      Weitere Informationen finden Sie unter Agent RA Core - INI-Datei.

    WINDOWS

    1. Führen Sie setup.exe aus, um das Programm zu starten.

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

      • Verwenden Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      • name

        Name des Agenten-Objekts.

        Maximale Länge: 32 Zeichen

        Erlaubte Zeichen: "A-Z", "0-9", "_", ".", "$", "@", "-" und "#".

        Bindestriche ("-") sind nur in Agent-Namen zulässig. Sie dürfen in den Namen anderer Objekte nicht verwendet werden.

        Obwohl Agent-Namen auf 32 Zeichen beschränkt sind, sollten Sie sie unter 25 Zeichen halten. Die letzten sieben Zeichen werden für das Hinzufügen des Suffixes '.NEW.nn' verwendet, wenn ein neuer Agent aus seiner Vorlage erstellt wird.

      • system

        Automation Engine Systemname. Dieser Eintrag muss mit dem Eintrag in der .ini-Datei des Automation Engine-Servers identisch sein.

      • ra

        Wird für zusätzliches Tracing verwendet. Bevor Sie einen neu installierten oder aktualisierten Agenten starten, sollten Sie das Rapid Automation-Tracing durch Hinzufügen von ra=99 aktivieren. Dadurch erhalten Sie weitere Informationen zur Fehlerbehebung, wenn während der Installation ein Fehler auftritt. Nach erfolgreichem Agent-Start können Sie ra=0 festlegen und den Agent neu starten, um das Rapid Automation-Tracing zu deaktivieren.

      • connection

        Adresse des Kommunikationsprozesses im Automation Engine-System, mit dem sich der Agent selbst verbinden sollte. Das Format hierbei lautet:

        <DNS-Name oder TCP/IP-Adresse>:<Portnummer>

      Weitere Informationen finden Sie unter Agent RA Core - INI-Datei.

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

  4. Starten Sie den Agenten.

    1. Stellen Sie sicher, dass das AE-System auf dem Servercomputer ausgeführt wird. Weitere Informationen finden Sie unter Multi-Server-Vorgänge.

    2. Starten Sie den Agenten auf dem Host mit den folgenden Befehlen:

      • Windows:

        <Pfad zu Java> -Xrs -jar ucxjsapibp.jar

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

        Beispiel

        "C:\Program Files (x86)\Java\jre8\bin\java" -jar -Xrs -Xmx1G ucxjsapibp.jar

      • UNIX:

        <Pfad zu Java> -jar ucxjsapibp.jar

        Beispiel

        /usr/bin/java -jar ucxjsapibp.jar

    3. Stellen Sie auf dem Administrator- oder Servercomputer sicher, dass der Agent bei der Automation Engine angemeldet ist.

      Neu eingeloggte Agenten werden einem Mandanten nicht automatisch zugewiesen und können nur in Mandant 0 angezeigt werden. Sobald Sie sich bei Mandant 0 eingeloggt haben, greifen Sie auf die Administration-Perspektive zu und wählen Sie Agenten und Gruppen aus.

      Sie können den neuen Agenten nun über die Agentenobjektdefinition Mandanten mit den erforderlichen Rechten zuordnen. Weitere Informationen finden Sie auf der Seite Seite "Berechtigungen".

Verwenden Sie den ServiceManager, um den Agenten als Service zu starten oder zu beenden. Weitere Informationen finden Sie unter ServiceManager.

Arbeiten mit dem SAP IBP-Agenten

Sobald Sie die Installation beendet haben, ist der SAP IBP-Agent in der Administration-Perspektive von Mandant 0 verfügbar.

Informationen zur Arbeit mit dem Agenten finden Sie unter:

Siehe auch: