PeopleSoft-Agent – Installationsprozess (Windows)

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:

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.

Agenten für PeopleSoft installieren (Windows)

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.
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.

Passen Sie auf dem Host-Computer die Werte im Feld OUTDESTTYPE an (PeopleSoft).

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

Starten Sie den PeopleSoft Application Designer.
Wählen Sie Datei > Öffnen.
Öffnen Sie das Feld OUTDESTTYPE.
Öffnen Sie die Definitionseigenschaften entweder über "Datei" -> "Definitionseigenschaften" oder verwenden Sie die Tastenkombination ALT + ENTER.

Ändern Sie im Tab Werte übersetzen die Tabelle wie unten gezeigt:

Wert	Eff Dt	Langer Name	Kurzname
0	01.01.1899	Beliebiger	Beliebiger
1	01.01.1899	(Keine)	NONE
2	01.01.1899	Datei	FILE
3	01.01.1899	Drucker	DRUCKER
4	01.01.1899	Fenster	FENSTER
5	01.01.1899	E-Mail	E-MAIL
6	01.01.1899	Web	WEB
7	01.01.1899	Standardwert	DEFAULT

Klicken Sie auf OK, um das Fenster "Eigenschaften" zu schließen.
Wählen Sie Datei > Speichern, um das Feld und Ihre Änderungen zu speichern.

Installieren Sie auf dem Host 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.
  
  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).
  
  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?
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.
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>.
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.
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.
Führen Sie auf dem Servercomputer einen Funktionstest aus. Stellen Sie sicher, dass AE ausgeführt wird.
1. Starten Sie auf dem Host den Agenten unter Verwendung des erstellten Start-Scripts.
  
  Ein Agentenobjekt wird automatisch im Mandanten 0 angelegt und im Ordner HOST gespeichert.
2. 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".
3. 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
4. Ü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.
5. Überprüfen Sie den Job-Report und die Logdatei des Agenten.
6. Überprüfen Sie, ob PeopleSoft online ist, und stellen Sie sicher, dass die Aufgabe ordnungsgemäß ausgeführt wurde.
7. Schließen Sie den PeopleSoft-Agenten bzw. fahren Sie ihn herunter.
Konfigurieren Sie Ihr System zur Nutzung von Bind-Variablen (optional).

Einige zusätzliche Einstellungen müssen angegeben werden, wenn Bind-Variablen in PeopleSoft-Prozessen verwendet werden sollen. Weitere Informationen finden Sie unter Nutzung von Bind-Variablen.

Beachten Sie, dass für diese Funktion die AE-Schnittstelle installiert sein muss, siehe Automation Engine Schnittstelle.

Kopieren Sie die PeopleSoft-Prozesstypdefinitionen in dieAE-spezifischen Definitionen. Dies geschieht mit Hilfe von SQL-Kommandos in der PeopleTools-Datenbank. Es ist nicht erforderlich, alle Prozesstyp-Definitionen zu kopieren, aber diejenigen, die Bind-Variablen verwenden und von der AE geplant werde, sollten inkludiert werden.

Die unten aufgeführten SQL-Scripts gelten für PeopleTools-Datenbanken auf ORACLE und MS SQL Server. Diese Scripts müssen angepasst werden, wenn eine Datenbank eines anderen Herstellers verwendet wird.

Hinweis: 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 Version >= 8.50 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 Version >= 8.50 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.
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:

Agenten installieren
Agent PeopleSoft INI-Datei