Manuel d'administration > Installation > Nouvelle installation > Installation de l'Interface Utilisateur (UNIX)

Installer l'interface utilisateur (UNIX)

Vous trouverez ici des indications pour la nouvelle installation d'une interface utilisateur.

L'interface utilisateur de Automation Engine est programmée sous Java. C'est pourquoi Java 2 JRE (Java Runtime Environment) est un prérequis à l'installation de l'interface utilisateur.

Instalez toujours les interfaces utilisateur sur votre disque dur local afin de vous assurer des meilleures performances. Une installation sur réseau n'est pas recommandée, car cela peut bloquer l'interface utilisateur en cas de défaillance du réseau.

La communication de l'interface utilisateur se déroule exclusivement par le biais des processus de communication du système AE. Aucune interface de base de données n'est donc nécessaire.

Automic recommande fortement d'installer l'interface utilisateur dans un répertoire séparé.

Prérequis

ID utilisateur valide pour l'installation (AE)

Fichiers fournis

Les fichiers de l'interface utilisateur se trouvent dans le répertoire IMAGE:USERINTERFACE\UNIX. Tous les fichiers sont récapitulés dans le fichier ucdj.tar.gz.

Nom de fichier	Description
UCDJ.SH	Script de démarrage pour exécuter l'interface utilisateur
UCDJ.INI	Options d'exécution pour le programme de démarrage
UCDJ.BAT	Fichier de commandes pour exécuter l'interface utilisateur
UCDJ.JAR	Interface utilisateur en Java
UC4CONFIG.XML	Fichier de configuration pour la connexion aux systèmes AE
LOGIN_DAT.XML	Fichier de configuration pour la connexion d'un utilisateur au système AE
UC.MSL	Bibliothèque de messages
CALLHTMLHELP.DLL, CALLHTMLHELPIA64.DLL, CALLHTMLHELPX64.DLL, UC4DOCREF.PROPERTIES, UC4MSGREF.PROPERTIES	Fichiers pour l'affichage de l'aide F1
CONFIGREF.CLASS	Classe de configuration
SYNTHETICA.JAR, SYNTHETICAADDONS.JAR, UC4LOOKANDFEEL.JAR, ATTACHLAYOUT.JAR, SWINGX.JAR, SWING-WORKER-1.2.JAR	Mise en page de l'interface
UC4.WAV	Fichier WAV traité au démarrage de l'interface utilisateur (affichage de l'écran de démarrage).
UCXJPS84.JAR	Fichier doté de classes Java spécifiques pour les formes PeopleSoft
AE-RA.JAR	Cadre RA
INTELLISENSE.JAR	Fichier pour la fonction d'auto-complétion l'éditeur de script

Déroulement

	1.	Installation de Java Runtime Environment (JRE)

Si JRE est déjà installé dans la version nécessaire, vous pouvez passer cette étape de l'installation.

Ordinateur administrateur et/ou ordinateur utilisateur
Vérifiez la version de la machine virtuelle Java (VM) du système à l'aide de la commande suivante :

java -version

Si plusieurs versions de JRE ou de Java SDK sont installées sur l'ordinateur, l'ordre des répertoires donnés est important. Faites-y attention lorsque vous paramétrez %PATH% et $PATH. L'environnement Java Runtime à utiliser est le premier trouvé dans la liste des répertoires.

Téléchargez le Java Runtime Environment nécessaire depuis le site http://java.sun.com et installez-le.

	2.	Installer l'interface utilisateur

Ordinateur administrateur et/ou ordinateur utilisateur
Connexion à l'aide de l'ID utilisateur AE.
Créez un répertoire pour l'interface utilisateur (valeur par défaut : /opt/globalDC).
Transférez le répertoire ucdj.tar.gz de IMAGE:UserInterface/<unix platform> vers /opt/globalDC via le FTP binaire.
Décompressez le fichier tar transféré dans le répertoire actuel (/opt/globalDC).
gzip -d ucdj.tar.gz ougunzip ucdj.tar.gz
tar xvf ucdj.tar

(Linux : tar -zxvf ucs???.tar.gz)

	3.	Adaptation des fichiers de configuration

Ordinateur administrateur et/ou ordinateur utilisateur
La plupart des valeurs des fichiers de configuration proviennent de l'interface utilisateur. Les spécifications suivantes sont cependant inévitables.
Adaptation de uc4config.xml.

Saisissez le nom de connexion et du système dans le paramètre <connection name= "nom" system="système">.
Indication des données de connexion pour le processus de communication (nom DNS ou adresse TCP/IP de l'ordinateur sur lequel celui-ci s'exécute ainsi que le numéro de port). Vous pouvez trouver ces informations dans le fichier INI du Automation Engine (Section [PORTS]).

	4.	Utilisation de l'ERP-Générateur (facultatif)

Ordinateur administrateur et/ou ordinateur utilisateur

PeopleSoft :
PeopleSoft Java Object Adapter et certaines classes Java (UCXJPS84.jar) sont nécessaires à l'utilisation de l'ERP-Générateur PS
Modifiez l'élément "classpath" du fichier INI de l'interface utilisateur (psjoa.jar).

Exemple :

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

	5.	Démarrer l'interface utilisateur

Ordinateur administrateur et/ou ordinateur utilisateur
La commande suivante exécute le script de démarrage :

chmod +x ucdj.sh

Problèmes possibles

Pendant l'installation :

Espace disque insuffisant :

il faut environ 20 Mo. L'espace disque disponible est vérifié par le programme d'installation.

Lors du démarrage du programme :

Pas de connexion au système AE :

Vérifiez les éléments du fichier uc4config.xml :

Saisissez le nom du système AE auquel l'interface utilisateur doit se connecter. De plus, il est important de bien spécifier le port et le nom de l'ordinateur ou l'adresse IP sur lequel le processus de communication se trouve.

Le système AE ne s'exécute pas :

Assurez-vous que les processus Serveur sont actifs.

Paramétrage recommandé pour Citrix

Java doit être installée localement sur le serveur Citrix.
Pour chaque Interface Utilisateur utilisée, la mémoire indiquée lors de l'exécution Java dans le fichier INI (ucdj.ini) doit au moins être disponible.
Exemple : cmd="javaw" -Xmx512m...
Pour s'assurer que la version Java correcte est utilisée, il est possible d'indiquer le chemin Java absolu dans le fichier INI.
Exemple : cmd="C:\Program Files\Java\jre\bin\javaw" -Xmx512m...
Les fichiers log et trace ainsi que les fichiers de configuration uc4config.xml et login_dat.xml devraient être séparés selon les besoins de l'utilisateur (voir ci-dessous).
Le paramètre Java suivant peut optimiser la gestion de stockage du JVM :
-XX:+UseConcMarkSweepGC

Séparer les fichiers log et trace de l'Interface Utilisateur selon les besoins de l'utilisateur

Dans le fichier uc4config.xml, il est possible d'utiliser des variables d'environnement pour enregistrer les fichiers log/trace à différents emplacements en fonction de l'utilisateur du système d'Exploitation.

Exemples de la section correspondante du fichier uc4config.xml (Windows) :

Les fichiers log et trace sont créés dans le répertoire de l'utilisateur Windows qui enregistre les données d'application temporaires. Le nom de l'utilisateur est utilisé dans le nom de Fichier.

<logging count="10">%APPDATA%/temp/UCDJ_LOG_##_%USERNAME%.TXT</logging>
<trace count="10" tcp="3" xml="0">%APPDATA%/temp/UCDJ_TRC_##_%USERNAME%.TXT</trace>

Dans cet exemple, les fichiers log et trace sont enregistrés dans le dossier Temp de l'interface Utilisateur et contiennent également le nom de l'utilisateur Windows :

<logging count="10">../temp/UCDJ_LOG_##_%USERNAME%.TXT</logging>
<trace count="10" tcp="3" xml="0">../temp/UCDJ_TRC_##_%USERNAME%.TXT</trace>

Démarrage de l'interface Utilisateur selon les besoins de l'utilisateur

Les fichiers de configuration uc4config.xml et login_dat.xml doivent être disponibles pour chaque utilisateur OS qui utilise l'interface Utilisateur. Dans l'idéal avec un nom significatif tel que uc4config_TEST.xml et login_dat_TEST.xml.

Variante 1 :

Appeler l'interface Utilisateur avec les paramètres de démarrage -I et -J, le nom d'utilisateur peut alors être utilisée de manière dynamique via les variables d'environnement.

Exemple : Commande de démarrage pour l'interface Utilisateur sous Windows
C:\AUTOMIC\UserInterface\bin\UCDJ.EXE -J"-OC:\AUTOMIC\UserInterface\bin\login_dat_%USERNAME%.xml –IC:\AUTOMIC\UserInterface\bin\uc4config_%USERNAME%.xml"

Variante 2 :

L'appel de l'interface Utilisateur reste identique, la spécification des fichiers de configuration en fonction de l'utilisateur s'effectue dans le fichier INI. Pour cela, utilisez des variables d'environnement pour l'exécution Java dans le fichier INI (cmd=...).

Exemple de la section du fichier INI :

[GLOBAL]
cmd="javaw" -Xmx512m com.uc4.ucdf.UCDialogFactory -U%User% -I./uc4config_%USERNAME%.xml -O./login_dat_%USERNAME%.xml

Si non seulement le nom mais également le chemin vers les fichiers XML dépendent de l'utilisateur, une variable d'environnement propre au chemin avant la commande de démarrage doit être définie. Par exemple :

Fichier INI :

[GLOBAL]
cmd="javaw" -Xmx256m com.uc4.ucdf.UCDialogFactory -U%User% -I%UI_XML%/UC4CONFIG_%USERNAME%.xml -O%UI_XML%/login_dat_%USERNAME%.xml

Appel de l'interface Utilisateur :

Set UI_XML=C:\UI_XML_Files
C:\AUTOMIC\UserInterface\bin\UCDJ.EXE -F0 -IUCDJ_individualized.ini