Agenten für PeopleSoft installieren

Dieses Dokument führt Sie durch die Installation eines PeopleSoft-Agenten.

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

Diese Seite beinhaltet Folgendes:

Übersicht

  • Die Prozessplanung in PeopleSoft wird über die PeopleTools-Komponenten durchgeführt. Der PeopleSoft-Agent kann für alle Versionen von PeopleTools implementiert werden, die von AE unterstützt werden. Weitere Informationen finden Sie unter Automic Automation Systemanforderungen und Dimensionierung.

  • Im Folgenden wird beschrieben, wie Sie einen Agenten in einem AE-System installieren, in dem die Authentifizierung nicht verwendet wird. Weitere Installationsschritte sind erforderlich, bevor der Agent gestartet und verwendet werden kann, wenn Sie eine der verfügbaren Authentifizierungsmethoden verwenden möchten. Detailliertere Informationen finden Sie im Dokument Authentifizierung von Agenten.

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

  • Dieser Agent unterstützt das Senden von E-Mails mit SMTP und SMTPS. Weitere Informationen finden Sie unter Einrichten von E-Mail-Verbindungen.

Voraussetzungen

  • Gültige Operator-ID's für die Ausführung von Aufgaben in PeopleSoft

Die nachfolgend aufgeführten zusätzlichen Anforderungen müssen erfüllt sein, damit Server-Prozessprotokolle des PeopleTools Process Scheduler Batch zur AE-Datenbank hinzugefügt werden können:

  • Eintrag in der INI-Datei des PeopleSoft-Agenten zum Übertragen der Logdateien in die Automation Engine, siehe Agent PeopleSoft 
  • Leseberechtigung für die Logdatei der PeopleSoft-Prozesse
  • Leseberechtigung für die Konfigurationsdatei des PeopleSoft Process Scheduler Batch Server
  • Korrekter Eintrag in der Konfigurationsdatei beim Parameter "Log/Output Directory=" 
  • Der Agent kennt die Umgebungsvariable, die für "Log/Output Directory=" verwendet werden kann

Dies sind die Voraussetzungen für den Einsatz der AE-Schnittstelle.

  • Die AE-Schnittstelle muss in die PeopleTools-Datenbank geladen, validiert und für den vollen Zugriff mit dem Application Designer autorisiert worden sein
  • Die AE-Schnittstelle muss in der INI-Datei des Agenten aktiviert sein

Weitere Informationen finden Sie unter Automation Engine Schnittstelle.

Mitgelieferte Dateien

Die Bilddateien UCXJPSX.ZIP für Windows und UCXJPSX.tar.gz für Unix enthalten die unten aufgeführten Dateien:

  • UCXJPSX.jar – jar-Datei des Agenten

  • UCXJPSX.INI – INI-Datei für den PeopleSoft-Agenten

  • UC.MSL – Meldungsbibliothek

  • UCXJPS84.jar – Java-Klassen

  • SETUP.EXE – Installationsprogramm (nur Windows)

  • Setup.lst – Setup-Listendatei (nur Windows)

  • ucxjpsx.sh – Beispiel-Agent-Startscript (nur Unix)

Weitere Informationen finden Sie unter Automation Engine Schnittstelle.

Technische Implementierung

Komponentenschnittstellen (Java-Klassen) können für die Verbindung des Agenten mit PeopleSoft/PeopleTools verwendet werden.

People Tools mit AE-Schnittstelle (Java-Klassen)

Der Zugriff auf die Jobverarbeitung erfolgt über die Java-Klassen der ausgelieferten UC4_*-Komponentenschnittstellen.

Herstellen einer Verbindung zur Automation Engine

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.

Wichtig! Sie sollten mit TLS/SSL und der Zertifikatimplementierung vertraut sein, bevor Sie die entsprechende Komponente installieren bzw. aktualisieren. Weitere Informationen finden Sie hier:

Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert: dem Java Trust Store für Java-Komponenten und Java-Agenten, dem Windows-Betriebssystemspeicher für Windows-Agenten und dem TLS/SSL-Speicher für UNIX-Agenten. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

Wenn sich die relevanten Zertifikate nicht dort befinden und Sie sie importieren möchten, können Sie für diesen Zweck für das Betriebssystem oder Java spezifische Tools verwenden, wie zum Beispiel Keytool, cert-manager, OpenSSL usw. Weitere Informationen zur Verwendung dieser Tools finden Sie in der entsprechenden Produktdokumentation.

Wenn Sie nicht den Standardspeicherort für die oben aufgeführten Komponenten und Agenten verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

Wichtig! TLS/SSL-Agenten (in Containern und vor Ort) sowie das TLS Gateway, wenn sie für die Automic Automation Kubernetes Edition verwendet werden, stellen eine Verbindung zu einem Ingress-/HTTPS-Load-Balancer her, der zur Authentifizierung ein Zertifikat anfordert.

Stellen Sie sicher, dass die Adresse des Load Balancers auf beiden Seiten definiert ist: in der Automation Engine und auf dem Agenten/TLS Gateway, und dass Ihr HTTPS-Load-Balancer die erforderlichen Zertifikate zur Nutzung besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AWI, die JCP- und REST-Prozesse über einen Ingress herstellen.

Agenten für PeopleSoft installieren

  1. Installieren Sie auf dem Administrator- und/oder Benutzercomputer, auf dem der Agent installiert ist, 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.

  2. Installieren Sie die AE-Schnittstelle, die für die Verwendung von Bind-Variablen erforderlich ist. Weitere Informationen finden Sie unter Nutzung von Bind-Variablen und Automation Engine Schnittstelle.

  3. Passen Sie auf dem Hostrechner die Definition im Feld OUTDESTTYPE an (PeopleSoft).

    Hinweis: Dieser Schritt ist nur erforderlich, wenn das PeopleSoft-System in einer anderen Sprache als Englisch läuft. Wenn ja, stellt er sicher, dass PeopleSoft den Wert für den Parameter OUTDESTTPYE des AE-Script-Elements PS_RUN_PROCESS übernimmt. Andernfalls verwendet das System den Standardparameterwert, der in PeopleSoft gespeichert ist. Weitere Informationen finden Sie unter PS_RUN_PROCESS.

    1. Starten Sie den PeopleSoft Application Designer.

    2. Wählen Sie Datei > Öffnen.

    3. Öffnen Sie das Feld OUTDESTTYPE.

    4. Öffnen Sie Definition Properties.

    5. Ändern Sie auf der Registerkarte Werte übersetzen die Tabelle wie unten gezeigt:

      WertAktivEff DtLanger NameKurzname
      001.01.1899BeliebigerBeliebiger
      101.01.1899(Keine)NONE
      201.01.1899DateiFILE
      301.01.1899DruckerDRUCKER
      401.01.1899FensterFENSTER
      501.01.1899E-MailE-MAIL
      601.01.1899WebWEB
      701.01.1899StandardwertDEFAULT

    6. Klicken Sie auf OK, um das Fenster "Eigenschaften" zu schließen.

    7. Wählen Sie File > Save aus, um Ihre Änderungen zu speichern.

  4. Installieren Sie auf dem Hostrechner den Agenten und richten Sie die Systemumgebung ein.

    1. Starten Sie das Programm SETUP.EXE im Verzeichnis IMAGE:AGENTS\PEOPLESOFT\WINDOWS. Sie können das Laufwerk bei Bedarf wechseln. Es ist wichtig, dass das Verzeichnis C:\AUTOMIC\AGENTS\PEOPLESOFT verwendet wird. Starten Sie die Installation mit der großen Schaltfläche (Computer, Verpackung und Diskette).

    2. Die AE-Programmgruppe wird automatisch angelegt oder der Agent eingegeben.

    3. Passen Sie die INI-Datei des PeopleSoft-Agenten an. Weitere Informationen finden Sie unter Agent PeopleSoft.

      Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

      Wenn Sie nicht den Standardspeicherort für diese Komponente verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

      Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

    4. Stellen Sie sicher, dass die Komponentenschnittstelle in den [PRCS_SBB_JAVA]-Abschnitten aktiviert (ENABLED=1) ist.

    Die Datei psjoa.jar ist im Ordner web im PeopleSoft-Installationsverzeichnis gespeichert. Wenn PeopleSoft nicht auf dem gleichen Computer wie der Agent installiert ist, geben Sie den Ordner web als Freigabe frei. Der Benutzer, unter dem der Agent startet, muss über Computerzugriffsrechte verfügen. Stellen Sie sicher, dass Sie den neuesten Bugfix von psjoa.jar für die Version PT8.54 verwenden.

  5. Verkürzen Sie auf dem Administrator- oder Benutzercomputer das Intervall für die Aufgabenprüfung (PeopleSoft).

    Es wird empfohlen, das Intervall für die Job-Prüfung zu verkürzen. Dies erfordert, dass für das Hostmerkmal eine eigene Variable angelegt und dem installierten Agenten zugeordnet wurde.

    1. Starten Sie das AWI und melden Sie sich im Mandanten 0 an.

    2. Duplizieren Sie die Variable UC_HOSTCHAR_DEFAULT, und benennen Sie sie in UC_HOSTCHAR_< Agent-Name> um. Weitere Informationen finden Sie unter UC_HOSTCHAR_DEFAULT - Host-Charakteristika.

    3. Reduzieren Sie den Eintrag in JOB_CHECKINTERVAL von 60 (Sekunden) auf 15 in dieser neuen Variablen. Weitere Informationen finden Sie unter JOB_CHECKINTERVAL.

    4. Ändern Sie den Eintrag für den PeopleSoft-Agenten in der Variablen UC_EX_HOSTCHAR von DEFAULT auf <Agentenname>.

  6. Bearbeiten Sie auf dem Administrator- oder Benutzercomputer das ERP-Login.

    Für die Startphase des Agenten werden Login-Daten für die PeopleSoft-Anwendung benötigt (Operator-ID, Passwort). Diese Informationen werden im Mandanten 0 im Login-Objekt ERP_LOGIN gespeichert.

    1. Starten Sie das AWI und melden Sie sich im Mandanten 0 an.

    2. Richten Sie das Login-Objekt unter Verwendung des Namens ERP_LOGIN ein, siehe Login (LOGIN).

      Hinweis: Wenn Sie einen anderen Namen für das Login-Objekt verwenden möchten, passen Sie ihn mithilfe des Schlüssels APPLICATION_LOGIN in der Variablen UC_HOSTCHAR_DEFAULT an.

    3. Geben Sie Ihre Zugangsdaten ein (Hosttyp = PS, Login-Info = Operator-ID, Passwort). Weitere Informationen finden Sie unter UC_HOSTCHAR_DEFAULT - Host-Charakteristika.

  7. Definieren Sie auf dem Administrator- oder Benutzercomputer die Operator-IDs (AE).

    Operator-IDs werden für die Ausführung von Aufgaben in PeopleSoft benötigt. Die AE muss die Passwörter für diese Benutzer-IDs kennen. Die Benutzer-ID und das Passwort werden im Login-Objekt des Mandanten zugewiesen, mit dem Aufgaben ausgeführt werden.

    1. Starten Sie die AWI für den Mandanten, in dem die Aufgaben ausgeführt werden sollen.

    2. Geben Sie alle erforderlichen Operator-IDs mit den Anmeldedaten im Login-Objekt ein.

  8. Starten Sie auf dem Serverrechner den Agenten und führen Sie einen Funktionstest aus.

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

    2. Starten Sie den Agenten mit dem folgenden Kommando:

      java -Xrs -Xmx1G -DTM_ALLOW_NOTLS=Y -jar ucxjpsx.jar

      24.4

      java -Xmx1G -jar ucxjpsx.jar

      Ein Agentenobjekt wird automatisch im Mandanten 0 angelegt und im Ordner HOST gespeichert.

    3. Vergewissern Sie sich in AWI, Mandant 0, 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 Definieren der Seite "Berechtigungen".

    4. Starten Sie auf dem Administrator-/Host-Computer (der PeopleSoft-Agent ist der Host) einen Test-Job.

      Geben Sie eine gültige Operator-ID ein. Aktivieren Sie die Job-Reportübergabe an die AE. Ein PeopleTools-Prozess wird mit dem Script-Element PS_RUN_PROCESS aktiviert. Weitere Informationen finden Sie unter PS_RUN_PROCESS

    5. Überwachen Sie den Prozess im AWI.

      Es kann einige Sekunden dauern, bis die AE bemerkt, dass der PeopleTools-Prozess abgeschlossen ist. Der Agent überprüft regelmäßig, ob der PeopleTools-Prozess noch gemäß den Einstellungen unter JOB_CHECKINTERVAL verläuft. Weitere Informationen finden Sie unter JOB_CHECKINTERVAL.

    6. Überprüfen Sie den Job-Report und die Logdatei des Agenten.

    7. Überprüfen Sie, ob PeopleSoft online ist, und stellen Sie sicher, dass die Aufgabe ordnungsgemäß ausgeführt wurde.

    8. Schließen Sie den PeopleSoft-Agenten bzw. fahren Sie ihn herunter.

  9. Konfigurieren Sie Ihr System zur Nutzung von Bind-Variablen (optional).

    Die Verwendung von Bind-Variablen in PeopleSoft-Prozessen erfordert das Definieren zusätzlicher Einstellungen. Siehe Nutzung von Bind-Variablen. Es erfordert außerdem die Installation der AE-Schnittstelle. Siehe Automation Engine Schnittstelle.

    Kopieren Sie die PeopleSoft-Prozesstypdefinitionen in dieAE-spezifischen Definitionen. Verwenden Sie dafür SQL-Befehle in der PeopleTools-Datenbank. Es ist nicht erforderlich, alle Prozesstyp-Definitionen zu kopieren, aber stellen Sie sicher, dass Sie alle einbeziehen, die Bind-Variablen verwenden und von der AE geplant werden. 

    Die unten aufgeführten SQL-Scripts gelten für PeopleTools-Datenbanken auf ORACLE und MS SQL Server. Wenn Sie eine andere Datenbank verwenden, passen Sie die Scripts dementsprechend an.

    Hinweis: Nachdem die SQL-Scripts ausgeführt sind, müssen Sie Ihr PeopleSoft-System neu starten.

    Hinweise:

    • Stellen Sie sicher, dass die Prozesstypdefinition mit dem Suffix UC4_ geändert werden kann. Wenn Sie 8.61 verwenden, müssen Sie Application Engine(psae.exe) in Application Engine ändern und die SQL-Anweisung unten ausführen.

    • Nachdem die SQL-Scripts ausgeführt sind, müssen Sie Ihr PeopleSoft-System neu starten.

    ORACLE

    Das folgende SQL-Script ist erforderlich, wenn Sie PeopleSoft in Version 8.50 verwenden:

    Das nachstehende SQL-Skript ist erforderlich, wenn Sie PeopleSoft-Version 8.61 verwenden:

    INSERT INTO PS_PRCSTYPEDEFN
    SELECT 'UC4_'||PRCSTYPE,
    OPSYS,
    DBTYPE,
    VERSION,
    PARMLIST,
    CMDLINE,
    WORKINGDIR,
    OUTPUTDEST,
    GENPRCSTYPE,
    WINPARM,
    MVSSHELLID,
    AS4JOBDESCNAME,
    AS4JOBDESCLIB,
    'UC4_'||PRCSTYPEDESCR,
    RESTARTENABLED,
    SYSDATE,
    'UC4',0
    FROM PS_PRCSTYPEDEFN;
    COMMIT;

    Das folgende SQL-Script ist erforderlich, wenn Sie PeopleSoft Version 8.4x verwenden:

    INSERT INTO PS_PRCSTYPEDEFN
    SELECT 'UC4_'||PRCSTYPE,
    OPSYS,
    DBTYPE,
    VERSION,
    PARMLIST,
    CMDLINE,
    WORKINGDIR,
    OUTPUTDEST,
    GENPRCSTYPE,
    WINPARM,
    MVSSHELLID,
    AS4JOBDESCNAME,
    AS4JOBDESCLIB,
    'UC4_'||PRCSTYPEDESCR,
    RESTARTENABLED,
    SYSDATE,
    'UC4'
    FROM PS_PRCSTYPEDEFN;

    COMMIT;

    Weisen Sie den neuen Prozesstypen Ausführungsrechte zu:

    INSERT INTO PS_SERVERCLASS
    SELECT ORIG.SERVERNAME,
    ORIG.OPSYS,
    'UC4_'||ORIG.PRCSTYPE,
    ORIG.PRCSPRIORITY,
    ORIG.MAXCONCURRENT
    FROM PS_SERVERCLASS ORIG
    WHERE 0 =
    (SELECT COUNT(*) FROM PS_SERVERCLASS SC
    WHERE SC.SERVERNAME=ORIG.SERVERNAME
    AND SC.OPSYS=ORIG.OPSYS
    AND SC.PRCSTYPE='UC4_'||ORIG.PRCSTYPE )  
    AND 0 <
    (SELECT COUNT(*) FROM PS_PRCSTYPEDEFN PT
    WHERE PT.PRCSTYPE='UC4_'||ORIG.PRCSTYPE
    AND PT.OPSYS=ORIG.OPSYS );

    COMMIT;

    MS SQL-Server

    Das folgende SQL-Script ist erforderlich, wenn Sie PeopleSoft in Version 8.50 verwenden:

    Das nachstehende SQL-Skript ist erforderlich, wenn Sie PeopleSoft-Version 8.61 verwenden:

    INSERT INTO PS_PRCSTYPEDEFN
    SELECT 'UC4_' + PRCSTYPE,
    OPSYS,
    DBTYPE,
    VERSION,
    PARMLIST,
    CMDLINE,
    WORKINGDIR,
    OUTPUTDEST,
    GENPRCSTYPE,
    WINPARM,
    MVSSHELLID,
    AS4JOBDESCNAME,
    AS4JOBDESCLIB,
    LEFT('UC4_' + PRCSTYPEDESCR,30),
    RESTARTENABLED,
    GETDATE(),
    'UC4',
    0
    FROM PS_PRCSTYPEDEFN; 

    Das folgende SQL-Script ist erforderlich, wenn Sie PeopleSoft Version 8.4x verwenden:

    INSERT INTO PS_PRCSTYPEDEFN
    SELECT 'UC4_' + PRCSTYPE,
    OPSYS,
    DBTYPE,
    VERSION,
    PARMLIST,
    CMDLINE,
    WORKINGDIR,
    OUTPUTDEST,
    GENPRCSTYPE,
    WINPARM,
    MVSSHELLID,
    AS4JOBDESCNAME,
    AS4JOBDESCLIB,
    LEFT('UC4_' + PRCSTYPEDESCR,30),
    RESTARTENABLED,
    GETDATE(),
    'UC4'
    FROM PS_PRCSTYPEDEFN;

    Weisen Sie den neuen Prozesstypen Ausführungsrechte zu:

    INSERT INTO PS_SERVERCLASS
    SELECT ORIG.SERVERNAME,
    ORIG.OPSYS,'UC4_' + ORIG.PRCSTYPE, ORIG.PRCSPRIORITY, ORIG.MAXCONCURRENT
    FROM PS_SERVERCLASS ORIG WHERE 0 =
    (SELECT COUNT(*) FROM PS_SERVERCLASS SC
    WHERE SC.SERVERNAME=ORIG.SERVERNAME
    AND SC.OPSYS=ORIG.OPSYS
    AND SC.PRCSTYPE='UC4_' + ORIG.PRCSTYPE )  
    AND 0 <
    (SELECT COUNT(*) FROM PS_PRCSTYPEDEFN PT
    WHERE PT.PRCSTYPE='UC4_' + ORIG.PRCSTYPE
    AND PT.OPSYS=ORIG.OPSYS );

    Es wird empfohlen, Jobs zu testen, die Bind-Variablen häufig verwenden. Weitere Informationen finden Sie unter Nutzung von Bind-Variablen.

  10. Konfigurieren Sie Ihr System optional für die Verwendung eines Remote Task Managers.

    Bei Verwendung eines Remote Task Managers ist die vorherige Generierung einer SQL-Ansicht erforderlich. Weitere Informationen finden Sie unter Remote Task Manager (JOBQ).

    1. Starten Sie den Application Designer.

    2. Öffnen Sie das mitgelieferte Projekt.

    3. Wählen Sie im Menü Build das Element Project aus. Wählen Sie die Einstellung Ansichten erstellen.

    4. Generieren Sie die SQL-Ansicht.

 

Siehe auch: