Installation de l'agent pour PeopleSoft (UNIX) – Détails
Vous trouverez ici des indications pour la nouvelle installation d'un Agent PeopleSoft.
|
1.
|
Installer l'interface AE |
Le processus complet de l'installation de l'interface AE est décrit dans un document séparé.
L'interface AE est requise afin d'utiliser les Variables de liaison.
|
2.
|
Adaptation des valeurs du champ OUTDESTTYPE (PeopleSoft) |
- Hôte
-
Cette étape ne doit être réalisée que lorsque le système PeopleSoft est exécuté dans une autre langue que l'anglais. Dans ce cas, cela permet de garantir que PeopleSoft prend en charge la valeur pour le paramètre OUTDESTTPYE de l'élément de script AE PS_RUN_PROCESS. Sinon, la valeur par défaut pour le paramètre qui est stocké dans PeopleSoft est utilisée.
- Démarrez PeopleSoft Application Designer.
- Sélectionnez "File" -> "Open".
- Ouvrez le champ (définition : Field) portant le nom "OUTDESTTYPE" (Name).
- Ensuite, les "Definition Properties" s'ouvrent en cliquant sur "File" -> "Defintion Properties" ou à l'aide du raccourci clavier ALT + ENTREE.
- Dans l'onglet Translate Values, le tableau doit être modifié comme suit :
Valeur |
Activ |
Eff Dt |
Long Name |
Short Name |
0 |
|
01.01.1899 |
Any |
Any |
1 |
|
01.01.1899 |
(None) |
NONE |
2 |
|
01.01.1899 |
Fichier |
FILE |
3 |
|
01.01.1899 |
Printer |
PRINTER |
4 |
|
01.01.1899 |
Window |
WINDOW |
5 |
|
01.01.1899 |
E-mail |
EMAIL |
6 |
|
01.01.1899 |
Web |
WEB |
7 |
|
01.01.1899 |
Default |
DEFAULT |
- Fermez la fenêtre de propriétés en cliquant sur OK.
- Pour appliquer les modifications, enregistrez le champ : "File" -> "Save".
|
3. |
Transférer le fichier tar de l'agent vers l'hôte et le décompresser |
- Hôte
- Transférez le fichier tar UCXJPSX.tar.gz via FTP dans un répertoire (par exemple peoplesoft).
- Passez au répertoire de PeopleSoft :
cd peoplesoft
- Décompressez le fichier tar :
gzip -d UCXJPSX.tar.gz
tar xvfo UCXJPSX.tar
- Cela permet de créer les fichiers fournis dans les répertoires correspondants. Le fichier tar peut être supprimé après la décompression.
-
Attention : tenez bien compte des messages de tar qui peuvent par exemple s'afficher via différents propriétaires et vérifiez que tous les fichiers ont bien été décompressés.
- Vérifiez que tous les fichiers possèdent les éléments Propriétaire et Groupe qui conviennent. AE doit être le propriétaire. Le groupe doit correspondre à l'identification de l'AE. Seul un utilisateur privilégié, tel que root, peut apporter des modifications.
chown UC4 * modifie les propriétaires de tous les fichiers à
chgrp nom de groupe * modifie les groupes d'utilisateurs de tous les fichiers
|
4.
|
Adaptation du fichier de configuration de l'agent |
- Hôte
- Activer l'interface dans la section [PRCS_SBB_JAVA] du fichier INI de l'agent installé, avec ENABLED=1.
- Dans le paramètre CLASSES=, il faut entrer l'emplacement de la bibliothèque psjoa.jar et le répertoire des classes Java. Créez les classes Javavous-même ou utilisezl'une des classes Java livrées avec la version de PeopleTools en votre possession.
- UCXJPS82.jar - pour 8.1 et 8.2
- UCXJPS84.jar – pour 8.44, 8.45, 8.46, 8.49, 8.50, 8.51, 8.52, 8.53, 8.54
- Définissez la variable d'environnement pour l'agent si une variable d'environnement est utilisée dans le fichier de configuration de PeopleTools (Log/Output Directory=).
Le contenu du fichier psjoa.jar a été modifié à compter de la version 8.54 de People Soft. Il y manquent certaines classes Java. Elles se trouvent dans l'installation de People Soft 8.54 Internet Architecture dans le répertoire suivant :
<PS_HOME>\webserv\peoplesoft\applications\peoplesoft\PORTAL.war\WEB-INF\classes
Vous devez ajouter le fichier psjoa.jar et les classes manquantes au CLASSPATH des composants suivants :
- Agent People Soft (pour activer l'exécution du job)
- Interface utilisateur (afin de pouvoir utiliser les FORMULAIRES lors de la définition des jobs People Soft).
- Ordinateur administrateur ou ordinateur utilisateur
- Adaptez éventuellement HEADER.PS, TRAILER.PS et RESTART.PS. Voir : Job - Exécution.
|
5. |
Créer le script de démarrage |
- Hôte
- Assurez-vous que le script de démarrage inclue les bibliothèques d'exécution Java dans le chemin de bibliothèque partagé.
Les noms de chemins pour HP/UX (processeur risc 2.0) sont : /opt/java1.5/jre/lib/PA_RISC2.0/ et /opt/java1.5/jre/lib/PA_RISC2.0/classic/libjvm.sl.
La Variable d'environnement $PS_SERVDIR est requise afin de transférer les protocoles de processus sur AE.
- Exemple pour HP/UX :
set +vx
UC4_ROOT=$HOME
UC4_BIN=$UC4_ROOT/bin
UC4_TEMP=$UC4_ROOT/temp
#
JAVA_DIR=/opt/java1.3/jre/lib/PA_RISC2.0
UC4_LIB=$UC4_ROOT/lib
export SHLIB_PATH=$JAVA_DIR/classic:$JAVA_DIR:$UC4_LIB
echo "SHLIB_PATH ----> '$SHLIB_PATH'"
#
#PS_HOME=<Home directory of PeopleSoft>
export PS_SERVDIR=$PS_HOME/appserv/HR800/prcs/PSHR800
echo "PS_SERVDIR ----> '$PS_SERVDIR'"
#
nohup $UC4_BIN/UCXJPSX > $UC4_TEMP/UCXJPSX.log 2>&1 &
- Définissez les droits de fichier pour le propriétaire et le groupe afin que le script de démarrage puisse être exécuté,
chmod 750start-script
L'accès est interdit à tous les autres.
|
6. |
Utilisation de l'ERP-Générateur (facultatif)
|
- Ordinateur administrateur et/ou ordinateur utilisateur
- Pour l'utilisation de l'ERP-Générateur PS, le PeopleSoft Java Object Adapter est nécessaire.
- Adaptez en conséquence l'élément "classpath" du fichier INI de l'interface utilisateur (psjoa.jar).
Exemple :
[ENVIRONMENT]
classpath=.;.\psjoa.jar;.\ucdj.jar
|
7. |
Réduction de l'intervalle de vérification des tâches dans PeopleSoft
|
- Ordinateur administrateur ou ordinateur utilisateur
Il est recommandé de réduire la fréquence à laquelle les Jobs sont vérifiés. Ceci nécessite la création et l'installation d'une variable séparée pour les caractéristiques de l'hôte de l'agent installé.
- Démarrez l'interface utilisateur pour le client 0000.
- Dupliquez la Variable UC_HOSTCHAR_DEFAULT et renommez la UC_HOSTCHAR_<Agent name>.
- Réduisez l'entrée JOB_CHECKINTERVAL de 60 à 15 secondes dans cette nouvelle Variable.
- Modifiez l'entrée pour l'agent PeopleSoft de DÉFAUT à <nom de l'agent> dans la variable UC_EX_HOSTCHAR.
|
8. |
Gestion des informations de connexion à l'ERP
|
- Ordinateur administrateur ou ordinateur utilisateur
Pour la phase de démarrage de l'agent, une connexion à l'application PeopleSoft est nécessaire (ID opérateur, mot de passe). Ces informations sont enregistrées dans le Client 0000, objet Login "ERP_LOGIN".
- Démarrez l'interface utilisateur et connectez-vous au client 0000.
- Créez un objet Login à l'aide du nom ERP_LOGIN.
(Si vous utilisez un autre nom, réglez la variable UC_HOSTCHAR_* avec la clé APPLICATION_LOGIN.)
- Saisissez les données de connexion (type d'hôte = "PS", infos de connexion = ID opérateur, mot de passe).
|
9. |
Définir les ID opérateurs dans AE
|
- Ordinateur administrateur ou ordinateur utilisateur
Des ID opérateurs sont nécessaires pour exécuter des tâches dans PeopleSoft. AE doit connaître les mots de passe de ces ID d'utilisateur. Saisissez l'ID de l'opérateur et le mot de passe de l'objet Login du client qui est utilisé pour exécuter les tâches.
- Démarrez l'interface utilisateur pour le client dans lequel les tâches doivent être exécutées.
- Entrez dans un objet Login tous les ID opérateur nécessaires ainsi que les données de connexion.
|
10.
|
Test de la connexion PeopleSoft
|
- Si disponible, testez la connexion au serveur d'applications PeopleTools avec le programme pscitester. Ce programme de test est fourni sous forme de code source dans le SDK de PeopleTools et peut éventuellement être converti à l'aide d'un compilateur C/C++.
|
11.
|
Test de fonction
|
- Ordinateur serveur
- Le Automation Engine doit être en cours d'exécution.
- Hôte
- Démarrez l'agent à l'aide du script de démarrage créé.
Un objet Agent est créé automatiquement dans le Client système 0000 et il est enregistré dans le dossier "HOST".
- Ordinateur administrateur ou Serveur
- Vérifiez si l'agent s'est connecté au Automation Engine :
- Démarrez l'interface utilisateur pour le client 0000. Affichez les informations sur les Agents dans la Supervision Système. Comme un Agent nouvellement connecté n'est pas encore attribué à un Client, il est uniquement visible dans le Client 0000. Utilisez l'objet agent to l'assigner aux clients avec les droits appropriés.
- Ordinateur administrateur/hôte
- Démarrez un Job de test.
L'agent PeopleSoft est l'hôte. Saisissez un ID opérateur valide. Reprise du rapport après activation d'AE. Un processus PeopleTools est activé avec PS_RUN_PROCESS.
- Surveiller le traitement dans l'interface utilisateur.
Il se peut qu'il soit nécessaire d'attendre plusieurs minutes pour qu'AE remarque que le processus PeopleTools ait terminé. L'agent vérifie périodiquement si le processus PeopleTools s'exécute encore, en fonction des paramètres configurés dans JOB_CHECKINTERVAL, .
- Contrôlez le rapport de Job.
- Contrôlez le fichier log de l'agent.
- PeopleSoft Online
- Vérifiez dans PeopleSoft si la tâche a été exécutée correctement.
- Arrêtez l'agent pour PeopleSoft.
|
12. |
Saisie du script de démarrage de l'agent pour le démarrage du système
|
- Pour vous assurer que l'agent PeopleSoft démarre lors de chaque démarrage du système UNIX, il faut enregistrer le script de démarrage créé dans la procédure de démarrage automatique du système UNIX. Etant donné que cette activité requiert dans la plupart des cas des droits administratifs, c'est-à-dire qu'elle dépend également des conditions de fonctionnement et du système d'exploitation, un collaborateur privilégié est nécessaire.
|
13. |
Configuration pour l'utilisation des Variables de liaison (facultatif)
|
- Il faut procéder à plusieurs paramétrages supplémentaires si vous souhaitez exécuter des processus PeopleSoft utilisant desVariables de liaison.
-
L'interface AE doit être installée pour utiliser cette fonction.
- Copiez les définitions de processus PeopleSoft sur les définitions spécifiques à AE. Ce processus peut être exécuté à l'aide de commandes SQL dans la base de données PeopleTools. Il n'est pas nécessaire de copier toutes les définitions de processus, mais ceux qui utilisent des Variables de liaison et qui sont planifiés par AE doivent être inclus.
Les scripts SQL suivants sont valides pour les bases de données PeopleTools sur ORACLE et MS SQL Serveur. Ces scripts doivent être adaptés si vous utilisez une base de données d'un autre éditeur.
ORACLE :
Avec PeopleSoft version 8.50 ou 8.51, ce script SQL doit être utilisé :
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;
Le script SQL suivant est requis si vous utilisez PeolpleSoft version 8.2x ou 8.4 :
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;
Attribuez ensuite des droits d'exécution pour les nouveaux types de processus.
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 :
Avec PeopleSoft version 8.50 ou 8.51, ce script SQL doit être utilisé :
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;
Le script SQL suivant est requis si vous utilisez PeolpleSoft version 8.2x ou 8.4 :
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;
Attribuez ensuite des droits d'exécution pour les nouveaux types de processus.
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 );
-
Il est fortement recommandé de tester les Jobs qui utilisent des Variables de liaison. De plus amples informations figurent dans le document Variables de liaison.
|
14. |
Configuration pour l'utilisation du gestionnaire de tâches distantes (facultatif)
|
- L'utilisation de l'objet gestionnaire de tâches distantes nécessite la création préalable d'une vue SQL.
- Démarrez l'Application Designer.
- Ouvrez le projet qui a été fourni par AE.
- Dans le menu "Build", sélectionnez l'élément "Project." Le paramètre "Create Views" doit être sélectionné.
- Créez la vue SQL.