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

Installation de l'Interface Utilisateur (Windows)

Vous trouverez ici des indications pour la nouvelle installation de l'interface Utilisateur (Windows).

Pour des raisons de performance, les Interfaces Utilisateur devraient toujours être installées sur le disque dur local. Une installation sur réseau n'est en outre pas recommandée, étant donné que cela peut provoquer un blocage de l'Interface Utilisateur en cas de défaillance du réseau.

La communication de l'Interface Utilisateur se fait uniquement au moyen des processus de communication du système AE. Aucune interface de base de données (ODBC, OCI ou CLI) n'est donc nécessaire.

Installez toujours l'Interface Utilisateur dans un répertoire distinct (par exemple : C:\AE\USERINTERFACE).

Fichiers fournis

Les fichiers de l'Interface Utilisateur se trouvent dans le répertoire IMAGE:USERINTERFACE\WINDOWS.

Nom du fichier	Description
UCDJ.EXE	Programme 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 les connexions aux systèmes AE
LOGIN_DAT.XML	Fichier de configuration pour les connexions des Utilisateurs 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
UC4.WAV	Fichier WAV lu au démarrage de l'Interface Utilisateur (affichage de l'écran de démarrage).
UCXJPS84.JAR	Fichier avec classes Java spécifiques pour les Formes PeopleSoft
SETUP.EXE	Programme d'installation
SYNTHETICA.JAR, SYNTHETICAADDONS.JAR, UC4LOOKANDFEEL.JAR, ATTACHLAYOUT.JAR, SWINGX.JAR, SWING-WORKER-1.2.JAR	Mise en page de l'interface
UC4-RA.JAR	Cadre RA
INTELLISENSE.JAR	Fichier pour la fonction de complément automatique de 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. Lors de l'installation, le plug-in Java pour navigateur web est installé automatiquement. Comme UC4 n'en a pas besoin, vous pouvez le désactiver dans le panneau de configuration.

	2.	Installation de l'Interface Utilisateur

Ordinateur administrateur et/ou ordinateur utilisateur
Lancez le programme SETUP.EXE dans le répertoire IMAGE:USERINTERFACE\WINDOWS.
Tous les fichiers nécessaires au fonctionnement de l'Interface Utilisateur sont copiés dans le répertoire indiqué. Le répertoire par défaut est C:\AE\USERINTERFACE\BIN.

	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.

Saisie du nom du 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 trouvez ces informations dans le fichier INI d'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
Adaptez en conséquence l'élément "classpath" du fichier INI de l'Interface Utilisateur (psjoa.jar).

Exemple :

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

	5.	Exécution de la DLL à partir d'un chemin sélectionné personnellement (facultatif)

Ordinateur administrateur et/ou ordinateur utilisateur
Il est possible de procéder à une modification du chemin de la CALLHTMLHELP.DLL en effectuant une entrée dans les Variables d'environnement (Panneau de configuration -> Système). Saisissez la Variable JAVA_LIBRARY_PATH et le chemin souhaité. La bibliothèque CALLHTMLHELP.DLL sera désormais chargée à partir de ce répertoire.
Il est également possible d'utiliser le paramètre "-Djava.library.path=chemin" dans le fichier INI. Entrez celui-ci dans la ligne "cmd=" de la section [GLOBAL].

Exemple :

cmd="javaw" -Djava.library.path=..\libraries -jar -cp .;.\UC4LAF.jar UCDJ.jar

	6.	Démarrage de l'Interface Utilisateur

Ordinateur administrateur et/ou ordinateur utilisateur
Utilisez soit le fichier UCDJ.EXE ou UCDJ.BAT pour exécuter l'interface Utilisateur.

L'application Java UCDJ.JAR devrait tout le temps avoir suffisamment de mémoire à disposition. Sinon, cela peut entraîner l'arrêt de l'interface Utilisateur. Augmentez ainsi préférablement à 1 024 Mo la valeur du paramètre de démarrage Java Xmx dans le fichier INI UCDJ.INI (lors de l'exécution par UCDJ.EXE) ou UCDJ.BAT.

Afin de pouvoir exécuter l'interface Utilisateur via le fichier *.EXE, une "Microsoft Visual C-Runtime Library" 32 bits doit être installée.

Problèmes possibles

Pendant l'installation :

Espace disque insuffisant :

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

Lors du démarrage du programme :

Aucune connexion au système AE:

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

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

Vérifiez que les processus Serveur sont activés.

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

Rubriques connexes :

Configuration du débogueur pour d'éventuelles interruptions du programme