Manuel d'administration > Installation > Nouvelle installation > Installation des utilitaires (UNIX)

Installation des utilitaires (UNIX)

Vous trouverez ici des indications pour la nouvelle installation des utilitaires.

Comme les utilitaires pour UNIX sont disponibles pour diverses plateformes, un code à trois caractères a été attribué à chaque plateforme UNIX prise en charge. The codes are described in the Terminology. Dans le présent document, le code en question est remplacé par les caractères "???".

Automic recommande d'installer l'utilitaire dans un répertoire différent (par exemple /opt/uc4/utilities).

Prérequis

ID utilisateur valide pour l'installation (uc4)

Fichiers fournis

Les fichiers des utilitaires sont fournis compressés dans des fichiers tar (util???.tar.gz). Vous trouverez le fichier tar en question dans un sous-répertoire conforme à la plateforme UNIX de IMAGE:UTILITIES\UNIX. Les noms des sous-répertoires indiquent les plates-formes prises en charge.

*.sh : Démarrage normal de l'utilitaire.
sans extension : Programme pour l'appel batch.

Nom de fichier	Description
UCYBDBar.jar	AE DB Archive (archiving the database)
ucybchng	AE DB Change (editing exported data)
UCYBDBcc.jar	AE DB Client Copy (copying and deleting clients)
UCYBDBLd.jar	AE DB Load (chargement de la base de données)
UCYBDBre.jar	AE DB Reorg (reorganizing the database)
UCYBDBRR	AE DB Revision Report (creating revision reports)
UCYBDBUn.jar	AE DB Unload (déchargement de la base de données)
UCYBLGMX	AE.LogMix (combination of log and trace files)
ucyrepg.jar	AE.Reporting Tool (defining queries)
uc.msl	Message library
UC4LAF.jar	Archive for layout files
*.ini	Initialization files for the utilities
*.sh	Start scripts for calling the utilities
libgcc, libssp, libstdc++*, libsysapi, libuc001, libuccache, libucdbup, libucsbepm, libucudb32, libUCYBCLICPY, libUCYBDBLd, libUCYBDBUn, libUCYDBArchive, libUCYDBReorg, libzu00132, libzuxml, ucucli, ucuoci,	Runtime libraries File ending with "a" indicates AIX File ending with "sl" indicates HP-UX File ending with "so" indicates Solaris, Linux and zLinux

As of version 8.0, the file names of all utilities have been changed to lowercase letters. For compatibility reasons, binary links are supplied for UNIX utilities of version 8.0. They link the program calls from old file names to the new ones. These links are only supplied in version 8.0 and no longer appear in later versions.

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
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.	Décompression du fichier tar et configuration de l'environnement système

Ordinateur administrateur
Copiez le fichier tar util???.tar.gz via FTP dans un répertoire (par exemple UC4/utility).
La connexion s'est effectuée à l'aide de l'ID utilisateur "UC4"..
Allez au répertoire des utilitaires :
cd utility
Décompression du fichier tar :
gzip -d util???.tar.gz ou gunzip util???.tar.gz
tar xvfo util???.tar
Les fichiers livrés sont alors déposés dans le répertoire correspondant. 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 propriétaire. Le Groupe doit correspondre à l'ID "UC4". La modification doit être effectuée sous un utilisateur privilégié (par exemple root).
chown UC4 *. modifie le propriétaire de tous les fichiers par UC4.
chgrpNom du groupe * modifie le groupe d'utilisateurs pour tous les fichiers.

Définissez les Variables d'environnement dans $HOME/.profile. Pour Oracle :

Pour AIX p. ex. :

ORACLE_HOME=/usr/oracle; export ORACLE_HOME
UC4=/opt/uc4/utility; export UC4
PATH=.:$ORACLE_HOME/bin[:$PATH]; export PATH
LIBPATH=.:$UC4/bin:$ORACLE_HOME/lib:/usr/lib:/lib[:$LIBPATH]; export LIBPATH

Pour HP-UX par exemple :

ORACLE_HOME=/opt/Oracle; export ORACLE_HOME
UC4=/opt/uc4/utility; export UC4
PATH=.:$ORACLE_HOME/bin[:$PATH]; export PATH
SHLIB_PATH=.:$UC4/bin:$ORACLE_HOME/lib:/usr/lib:/lib[:$SHLIB_PATH]; export SHLIB_PATH

Pour Linux, Solaris et zLinux par exemple :

ORACLE_HOME=/oracle/product/9.0.1; export ORACLE_HOME
UC4=/opt/uc4/utility; export UC4
PATH=.:$ORACLE_HOME/bin[:$PATH]; export PATH
LD_LIBRARY_PATH=.:$UC4/bin:$ORACLE_HOME/lib:/usr/lib:/lib[:$LD_LIBRARY_PATH]; export LD_LIBRARY_PATH

Définissez les Variables d'environnement dans $HOME/.profile. Pour DB2 :

Pour AIX p. ex. :

DB2DIR=/usr/lpp/db2_06_01;export DB2DIR
DB2INSTANCE=db2inst1;export DB2INSTANCE
UC4=/opt/uc4/utility; export UC4
PATH=.:$DB2DIR/bin[:$PATH]; export PATH
LIBPATH=$UC4/bin:$DB2DIR/lib:usr/lib:/lib[:$LIBPATH]; export LIBPATH

Pour HP-UX par exemple :

DB2DIR=/opt/IBMdb2/V6.1; export DB2DIR
UC4=/opt/uc4/utility; export UC4
PATH=.:$DB2DIR/bin[:$PATH]; export PATH
SHLIB_PATH=$UC4/bin:$DB2DIR/lib:/usr/lib:/lib[:$SHLIB_PATH]; export SHLIB_PATH

Pour Linux, Solaris et zLinux par exemple :

DB2DIR=/opt/IBMdb2/V7.1;export DB2DIR
DB2INSTANCE=db2inst1;export DB2INSTANCE
UC4=/opt/uc4/utility; export UC4
PATH=.:$DB2DIR/bin[:$PATH]; export PATH
LD_LIBRARY_PATH=$UC4/bin:$DB2DIR /lib:/usr/lib:/lib[:$LD_LIBRARY_PATH]; export LD_LIBRARY_PATH

	3.	Adaptez les fichiers INI à l'environnement système.

Ordinateur administrateur
Les fichiers INI portent le même nom que les utilitaires correspondants. Adaptez les éléments y figurant à vos besoins.
- AE DB Archive (UCYBDBAR.ini)
- AE DB Client Copy (UCYBDBCC.ini)
- AE DB Load (UCYBDBLD.ini)
- AE DB Reorg (UCYBDBRE.ini)
- AE DB Revision Report (UCYBDBRR.ini)
- AE DB Unload (UCYBDBUN.ini)
- AE DB Reporting Tool (UCYBDBRT.INI)

	4.	Démarrage des utilitaires

Ordinateur administrateur
Les utilitaires peuvent être exécutés des façons suivantes :
- *.sh : Démarrage normal de l'utilitaire.
- sans extension : programme pour lequel des Paramètres de démarrage peuvent être transférés pour les exécutions batch.

Use the following command to process the start scripts:

For example:
chmod +x UCYBDBar.sh

Note that starting this utility's graphical interface on the platform HP Itanium requires the library "libstdc++.so.6" to be loaded with the environment variable LD_PRELOAD.

Example of a command loading the library:

export LD_PRELOAD=/uc4/utility/bin/libstdc++.so.6

You can insert this command in the Shell scripts. The library will then automatically be loaded whenever a utility's GUI is opened.

Shell-script example "ucybdbld.sh" for opening the graphical user inferface of the utility AE DB Load:

export LD_PRELOAD=./libstd++.so.6

java -jar ucybdbld.jar