Installation du JWP

Le présent document contient les instructions d'installation pour le processus de travail basé Java (JWP = Java-based work process).

Généralités

Le JWP est un composant d'Automation Engine nécessaire pour exécuter les fonctions suivantes :

Authentification unique (via KDC)
Calcul de l'ERT adaptatif
Fonction Exporter avec références
Intégration Automic Release Automation
Recherche globale ECC

Fichiers fournis

Le JWP est fourni dans le même répertoire que tous les autres fichiers Automation Engine.

Fichier / répertoire	Description
ucsrvjp.jar	Fichier de démarrage du JWP.
/lib/	Répertoire avec implémentation OSGI et pilote JDBC.
/plugins/com.automic.database.jar	Fichier d'accès à la base de données.
/plugins/com.automic.ara.jar	Ouvre le service web ARA.
/plugins/com.automic.ert.jar	Calcul de l'ERT (adaptatif).
/plugins/com.automic.kernel.jar	Kernel du JWP.
/plugins/com.automic.network.jar	Connexions TCP/IP.
/plugins/com.automic.sso.jar	Authentification unique.
/plugins/com.automic.util.logging.jar	Logging / Trace.
/plugins/org.apache* /plugins/org.eclipse*	Ensembles OSGI supplémentaires pour console et services.

Le répertoire /configuration/ est créé automatiquement au premier démarrage du JWP et contient le cache des ensembles OSGI.

Installation

Décompressez les fichiers

Sous Windows, les fichiers JWP sont automatiquement copiés du programme SETUP.EXE dans le répertoire BIN. Sous UNIX, les fichiers se trouvent dans l'archive TAR correspondante.

Copiez les répertoires "plugin" et "lib" fournis dans le répertoire BIN d'Automation Engine.

Les étapes d'installation suivantes dépendent du type de base de données utilisé.

Serveur MS SQL

	1)	Installation du pilote JDBC

Téléchargez Microsoft JDBC Driver 4.0 pour serveurs SQL.

Après le téléchargement, copiez le fichier "sqljdbc4.jar" dans le répertoire lib d'Automation Engine.

	2)	Activation de TCP/IP dans le serveur MS SQL

Vérifiez si l'instance du serveur MS SQL utilisée permet l'accès via TCP/IP.

Ouvrez SQL Server Configuration Manager et sélectionnez Protocols for MSSQLSERVER dans SQL Server Network Configuration. L'élément "TCP/IP" doit être "Enabled" dans la section de droite.

	3)	Définition du port du serveur MS SQL

Le port par défaut du serveur MS SQL est 1433.

En cas de doute sur le port de votre instance de serveur MS SQL, consultez son fichier-journal. Le message "Server is listening on [ 'any'<ipv4> numéro de port]" doit se trouver dans le fichier journal actuel qui contient le port.

	4)	Modification du fichier de configuration d'Automation Engine

Le JWP utilise le même fichier de configuration (ucsrv.ini) que les autres processus de travail du système Automation Engine.

La connexion de la base de données doit être modifiée dans le fichier de configuration pour le JWP. Pour cela, vous disposez de deux options :

1) Connexion ODBC DSN-less

Notez qu'avec cette option, la même chaîne de connexion à la de base de données que celle qui est utilisée par tous les autres processus de travail dans le système Automation Engine doit être modifiée dans le fichier de configuration. Lors de l'installation d'un JWP pour un système existant, tous les processus de travail WP doivent ensuite être redémarrés.

Une chaîne de connexion est requise dans la section [ODBC] du fichier de configuration, sa syntaxe ne requiert pas de DSN. Dans ce cas, les noms du serveur et de la base de données doivent être directement spécifiés.

SQLDRIVERCONNECT=ODBCVAR=SNNNNNRN,Driver={SQL Server Native Client VERSION};Server=tcp:SRVNAME,PORT;Database=DBNAME;Uid=DBUSER;Pwd=DBPWD

VERSION : version du client natif du serveur SQL. Est affiché dans SQL Server Configuration Manager.
SRVNAME : nom de l'ordinateur de la base de données.
PORT : port de l'instance du serveur MS SQL.
DBNAME : nom de la base de données.
DBUSER : utilisateur de la base de données.
DBPWD : mot de passe de la base de données.

Exemple :

[ODBC]
SQLDRIVERCONNECT=ODBCVAR=SNNNNNRN,Driver={SQL Server Native Client 11.0};Server=tcp:dbsrv01,1433;Database=AEV10;Uid=user;Pwd=password

L'entrée doit tenir sur une seule ligne (sans saut de ligne).

2) Chaîne de connexion distincte pour le JWP

Avec cette option, une chaîne de connexion distincte à la de base de données pour le JWP est définie dans la section [JDBC].

Exemple :

[JDBC]
SQLDRIVERCONNECT=jdbc:sqlserver://dbsrv01;databaseName=AEV10

Le nom et le mot de passe de l'utilisateur de la base de données sont utilisés par l'élément [ODBC].

L'avantage de cette méthode est que la chaîne de connexion des autres processus de travail (section [ODBC]) n'a pas besoin d'être modifiée, ni redémarrée.

Oracle

	1)	Installation du pilote JDBC

Copiez le pilote JDBC "ojdbc6.jar" de l'installation cliente de la base de données Oracle dans le dossier "lib" du JWP.
Le fichier est situé dans : ORACLE_HOME/jdbc/lib/ojdbc6.jar

	2)	Configuration de la connexion à la base de données

Vous avez deux options :

1) Connexion via OCI

La modification du fichier INI "ucsrv.ini" n'est pas nécessaire avec cette option. Cependant, le JWP requiert l'accès aux bibliothèques de la base de données Oracle de la même manière que pour un processus de travail WP. Sous UNIX, les variables d'environnement LD_LIBRARY_PATH ou SHLIB_PATH doivent donc être sélectionnées en conséquence selon la plateforme.

Vous trouverez plus d'informations sur l'installation du pilote JDBC dans les instructions d'installation JDBC d'Oracle.

2) Connexion directe à la base de données

Vous pouvez vous connecter directement à la base de données à l'aide du pilote Oracle JDBC Thin.

La section [JDBC] du fichier ucsrv.ini doit être configurée en conséquence. Exemple :

[JDBC]
SQLDRIVERCONNECT=jdbc:oracle:thin:@dbserver:1521/service_name

Le nom et le mot de passe de l'utilisateur de la base de données se trouvent dans l'élément [ODBC].

DB2

	1)	Installation du pilote JDBC

Copiez le fichier "db2jcc4.jar" (pilote JDBC ) dans le répertoire "lib" du JWP.

Ce fichier fait partie du client DB2 et se trouve dans le sous-répertoire "SQLLIB/java".

	2)	Configuration de la connexion à la base de données

La modification du fichier ucsrv.ini n'est pas nécessaire.

Cependant, si nécessaire, la chaîne de connexion à la base de données peut être définie dans la section [JDBC] du fichier INI.

Exemple :

[JDBC]
SQLDRIVERCONNECT=jdbc:db2://server:<port>/database

Le nom et le mot de passe de l'utilisateur pour l'accès à la base de données se trouvent dans l'élément [ODBC].

Ajout des certificats pour SSL

Afin de pouvoir utiliser SSL, il faut que le ou les certificats du serveur LDAP soient disponibles pour le processus de travail java JWP.
Le JWP utilise le fichier keystore par défaut "cacerts" dans le répertoire lib/security du JRE.

Pour ajouter des certificats, vous avez deux options :

1	Ajouter des certificats avec keytool

Accédez au dossier jre\lib\security de l'installation Java et importez le certificat avec la commande keytool :

keytool -keystore cacerts -importcert -alias ldapServer -file certficate.cer
Dès que l'invite vous demandant si vous faites confiance à ce certificat apparaît, répondez en saisissant "Y".

2	Ajouter des certificats par téléchargement

Une autre option pour installer le certificat est d'utiliser le paramètre de ligne de commande -installcert du processus de travail java JWP.

java -jar ucsrvjp.jar -installcert <host>:<sslport>

Cela suppose que le processus de travail java a accès en écriture au fichier cacerts de l'installation Java.
Cette commande détecte le chemin du fichier cacerts, se connecte à l'hôte et au port spécifiés et tente de créer une connexion SSL.

S'il manque un certificat, le message "impossible de trouver le chemin de certificat valide pour la cible demandée" apparaît et le certificat manquant est téléchargé et enregistré dans le fichier cacerts.

Démarrer le JWP

Pour démarrer le JWP via la ligne de commande, utilisez ce type de commande :

java -Xmx512M -jar ucsrvjp.jar -IC:\temp\ucsrv.ini

Le fichier "ucsrvjp.jar" est fourni dans le même répertoire que les autres fichiers d'Automation Engine. Il sert exclusivement à faire démarrer le JWP.

Le JWP peut également être lancé par le gestionnaire de services.

java -Xmx512M -jar ucsrvjp.jar -svc%port% -IC:\temp\ucsrv.ini

Le paramètre -svc doit être ignoré lors d'un démarrage direct via la ligne de commande.

Le paramètre -I qui spécifie le fichier INI est optionnel. S'il manque le paramètre, le JWP tente de trouver le fichier "ucsrv.ini" dans le répertoire de travail courant (répertoire où se trouve le fichier "ucsrvjp.jar").