Administratorhandbuch > Installation > Neu-Installation > Agent für PeopleSoft installieren (Windows) – Details

Agent für PeopleSoft (Windows) installieren - Details

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

	1.	Microsoft Visual C++ 2010 Redistributable Package installieren

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

Beachten Sie, dass für PeopleTools Version 8.53 mindestens Java Version 1.7 erforderlich ist!

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.	AE-Schnittstelle installieren

Die Installation der AE-Schnittstelle ist in einem eigenen Dokument beschrieben.

Die AE-Schnittstelle ist unter anderem eine Voraussetzung für die Nutzung vonBind-Variablen!

	4.	Anpassung der Werte des Feldes OUTDESTTYPE (PeopleSoft)

Host
Dieser Schritt ist nur dann durchzuführen, wenn das PeopleSoft-System in einer anderen Sprache als Englisch läuft. Der Vorgang ist notwendig, damit in diesem Fall der Wert für den Parameter OUTDESTTPYE des AE Script-Sprachmittels PS_RUN_PROCESS von PeopleSoft übernommen wird. Andernfalls wird der Standardwert für den Parameter, der in PeopleSoft hinterlegt ist, verwendet.
Starten Sie den PeopleSoft Application Designer.
Wählen Sie "File" -> "Open" aus.
Öffnen Sie das Feld (Definition: Field) mit dem Namen "OUTDESTTYPE" (Name).
Danach sind die "Defintion Properties" entweder über "File" -> "Defintion Properties" oder das Tastaturkürzel ALT + ENTER zu öffnen.
In der Registerkarte Translate Values ist die Tabelle folgendermaßen zu ändern:

Wert	Eff Dt	Long Name	Short Name
0	01.01.1899	Any	Any
1	01.01.1899	(None)	NONE
2	01.01.1899	File	FILE
3	01.01.1899	Printer	PRINTER
4	01.01.1899	Window	WINDOW
5	01.01.1899	Email	EMAIL
6	01.01.1899	Web	WEB
7	01.01.1899	Default	DEFAULT

Schließen Sie das Eigenschaftsfenster mit "OK".
Um die Änderungen zu übernehmen, speichern Sie das Feld: "File" -> "Save".

	5.	Agent installieren und Systemumfeld einrichten

Host
Starten des Programms SETUP.EXE im Verzeichnis IMAGE:AGENTS\PEOPLESOFT\WINDOWS.
Ändern Sie bei Bedarf das Laufwerk. Verzeichnis C:\AUTOMIC\AGENTS\PEOPLESOFTverwenden. Installation mit dem großen Button (Computer, Verpackung und Diskette) starten.
Die AE-Programmgruppe wird automatisch angelegt bzw. der Agent eingetragen.
Anpassen der INI-Datei.
Gegebenenfalls Umgebungsvariable für den Agenten setzen, wenn in der Konfigurationsdatei von PeopleTools (Log/Output Directory=) eine Umgebungsvariable verwendet wird.
Setzen Sie unbedingt den Pfad zur Datei jvm.dll in der Umgebungsvariablen path= ! Sie befindet sich im Ordner "client" im Installationsverzeichnis der Java Runtime Environment. Sollte der ServiceManager laufen, müssen Sie diesen neu starten.
Die AE-Schnittstelle muss in der Sektion [PRCS_SBB_JAVA] aktiviert werden (ENABLED=1).
Im Parameter CLASSES= ist der Ort der Java-Bibliothek psjoa.jar und das Verzeichnis der Java-Klassen einzutragen. Erstellen Sie die Java-Klassenentweder selbst oder verwenden Sie abhängig von der PeopleTools-Version eine der ausgelieferten Javaklassen:

UCXJPS82.jar - für 8.1 und 8.2
UCXJPS84.jar - für 8.44, 8.45, 8.46, 8.49, 8.50, 8.51, 8.52, 8.53, 8.54

Die Datei psjoa.jar befindet sich im Ordner "web" im Installationsverzeichnis von PeopleSoft. Sollte PeopleSoft nicht auf demselben Rechner installiert sein wie der Agent, muss der Ordner "web" als Share freigegeben werden. Der Benutzer unter dem der Agent startet muss Zugriffsrechte auf dem Rechner haben.

Der Inhalt der Datei psjoa.jar wurde ab People Soft Version 8.54 geändert. Einige Java-Klassen fehlen dort. Sie stehen in der People Soft 8.54 Internet Architecture-Installation im folgenden Verzeichnis zur Verfügung:

<PS_HOME>\webserv\peoplesoft\applications\peoplesoft\PORTAL.war\WEB-INF\classes

Sie müssen die psjoa.jar und die fehlenden Klassen dem CLASSPATH folgender Komponenten hinzufügen:

People Soft Agent (um die Job-Ausführung zu ermöglichen)

Userinterface (um FORMS bei der Definition von People Soft Jobs verwenden zu können).

Admin-Rechner oder Benutzer-Rechner
Eventuell HEADER.PS, TRAILER.PS und RESTART.PS anpassen. Siehe: Job - Ausführen

Bitte den ServiceManager verwenden, um den Agenten als Dienst zu starten.

	6.	Nutzung der ERP Forms (optional)

Admin-Rechner und/oder Benutzer-Rechner

Für die Verwendung der PS ERP Forms wird der PeopleSoft Java Object Adapter benötigt. Die Datei "psjoa.jar" ist dazu in das bin-Verzeichnis des Agenten und des UserInterface zu kopieren.
Tragen Sie in die Variable UC_EX_ERP_CONNECT, die im Mandant 0 ausgeliefert wird, Agentenname und Connectstring ein.
Passen Sie in der INI-Datei der UserInterfaces den Eintrag "classpath" entsprechend an (psjoa.jar und ucxjps84.jar).

Beispiel:

[ENVIRONMENT]
classpath=.;.\ucdj.jar.;.\psjoa.jar.;.\ucxjps84.jar

	7.	Intervall zur Überprüfung der Aufgaben in PeopleSoft verkürzen

Admin-Rechner oder Benutzer-Rechner

Es wird empfohlen, das Intervall für die Jobüberprüfung herabzusetzen. Dazu muss für den installierten Agenten eine eigene AE- Variable für die Host-Charakteristik angelegt und zugewiesen werden.

UserInterface für Mandant 0000 starten.
Die Variable UC_HOSTCHAR_DEFAULT duplizieren und auf UC_HOSTCHAR_<Agentenname> umbenennen.
In dieser neuen Variablen den Eintrag für JOB_CHECKINTERVAL von 60 (Sekunden) auf 15 herabsetzen.
In der Variablen UC_EX_HOSTCHAR den Eintrag für den PeopleSoft-Agenten von DEFAULT auf <Agentenname> ändern.

	8.	ERP-Login pflegen

Admin-Rechner oder Benutzer-Rechner

Für die Startup-Phase des Agenten wird ein Login zur PeopleSoft Application benötigt (Operator-ID, Passwort). Diese Information wird im Mandant 0000, Login-Objekt "ERP_LOGIN" gespeichert.

UserInterface starten und an Mandant 0000 anmelden.
Login-Objekt mit Standard-Namen "ERP_LOGIN" anlegen.
(Möchten Sie einen anderen Namen für das Login-Objekt verwenden, so ist dieser in der Variablen UC_HOSTCHAR_* mit dem Key APPLICATION_LOGIN zu ändern.)
Anmeldedaten eintragen (Host Typ = "PS", Login-Info = Operator-ID, Passwort).

	9.	Operator-ID's in der AE definieren

Admin-Rechner oder Benutzer-Rechner

Für die Durchführung von Aufgaben in PeopleSoft werden Operator-ID's benötigt. Die Passwörter zu diesen Benutzerkennungen müssen in der AE bekannt sein. Die Zuordnung von Operator-ID und Passwort wird im Login-Objekt des Mandanten eingetragen, in dem die Aufgaben ausgeführt werden.

UserInterface für den Mandant starten, in dem die Aufgaben ausgeführt werden sollen.
Alle benötigte Operator-ID's mit den Anmeldedaten in einem Login-Objekt eintragen.

	10.	Testen der PeopleSoft-Verbindung

Falls vorhanden, mit dem Programm pscitester die Verbindung zum PeopleTools-Applikationsserver überprüfen. Dieses Testprogramm wird als Sourcecode in der PeopleTools SDK als Beispiel zu Verfügung gestellt und kann gegebenenfalls mit einem C/C++-Compiler übersetzt werden.

	11.	Funktionstest

Server-Rechner
Automation Engine muss laufen.
Host
Starten des Agenten mit dem erzeugten Start-Script.
Es wird im Systemmandant 0000 ein Agenten-Objekt automatisch angelegt und im Ordner "HOST" gespeichert.
Admin-Rechner oder Serverrechner
Prüfen, ob sich der Agent bei der Automation Engine angemeldet hat:

UserInterface für Mandant 0000 starten. 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.

Admin-Rechner/Host
Starten eines Testjobs.
Der PeopleSoft-Agent ist Host. Gültige Operator-ID eingeben. Übernahme des Job-Reports in die AE aktivieren. Es wird mit PS_RUN_PROCESS ein PeopleSoft-Prozess aktiviert.
Beobachten des Ablaufs im UserInterface.
Es kann einige Sekunden dauern, bis die AE bemerkt, dass der PeopleSoft-Prozess fertig ist. Der Agent prüft periodisch entsprechend der Einstellung im JOB_CHECKINTERVAL, ob der PeopleSoft-Prozess noch läuft.
Kontrollieren des Job-Reports.
Kontrollieren der Logdatei des Agenten.
PeopleSoft Online
Prüfen Sie in PeopleSoft, ob die Aufgabe korrekt durchgeführt wurde.
Beenden des Agenten für PeopleSoft.

	12.	Konfiguration zur Nutzung von Bind-Variablen (optional)

Einige zusätzliche Einstellungen sind vorzunehmen, wenn Sie in PeopleSoft Prozesse durchführen möchten, die Bind-Variablen verwenden.
Beachten Sie, dass für die Nutzung dieser Funktionalität die AE-Schnittstelle installiert sein muss!
Kopieren Sie zuerst die PeopleSoft Prozesstyp-Definitionen zu AE-spezifischen Prozesstyp-Definitionen. Dieser Vorgang kann über SQL-Kommandos in der PeopleTools-Datenbank erfolgen. Es ist nicht notwendig, dass Sie alle Prozesstyp-Definitionen kopieren. Sie sollten zumindest jene, die über Bind-Variablen verfügen und von AE eingeplant werden, miteinbeziehen.

Die folgenden SQL-Scripts gelten für PeopleTools-Datenbanken auf ORACLE und MS SQL Server. Verwenden Sie eine Datenbank von einem anderen Hersteller, so müssen Sie die Scripts entsprechend anpassen.

ORACLE:

Bei PeopleSoft Version 8.50 oder 8.51 ist dieses SQL-Script zu 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;
0
COMMIT;

Bei Verwendung der PeopleSoft Version 8.2x oder 8.4x ist folgendes SQL-Script zu einzusetzen:

Vergeben Sie anschließend Ausführungsrechte für die neuen Prozesstypen:

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:

Bei PeopleSoft Version 8.50 oder 8.51 ist dieses SQL-Script zu 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;

Bei Verwendung der PeopleSoft Version 8.2x oder 8.4x ist folgendes SQL-Script zu einzusetzen:

Vergeben Sie anschließend Ausführungsrechte für die neuen Prozesstypen:

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 );

Führen Sie umfangreiche Tests mit Jobs durch, die Bind-Variablen verwenden! Nähere Informationen sind im Dokument Bind-Variablen vermerkt.

	13.	Konfiguration zur Verwendung des RemoteTaskManagers (optional)

Der Einsatz des RemoteTaskManager-Objektes erfordert das Erzeugen eines SQL-Views.
Starten Sie den Application Designer.
Öffnen Sie das von uns ausgelieferte Projekt.
Wählen Sie im Menü Build den Punkt Projectaus. Die Einstellung "Create Views" muss ausgewählt sein.
Erzeugen Sie den SQL-View.

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support