Mise à jour d'un système AE à partir de la version 10

To ensure that your upgrading process is successful Automic recommends that you strictly follow the steps that are described in this guide.

Never upgrade a productive AE system without having it tested extensively in a separate environment.

For details about installing hotfixes, see the related topic hotfix installation.

Il est très important de procéder de manière structurée pour la mise à niveau d'un système AE, afin de garantir que les traitements pourront continuer dès que possible.
Cette procédure explique les étapes nécessaires en détail et aborde notamment les domaines qui nécessitent une attention particulière. Suivez les étapes recommandées pour un processus de conversion en douceur et vous serez bientôt en mesure d'utiliser toutes les nouvelles fonctions de votre nouvelle version d'Automation Engine.

Lors d'un changement de version d'Automation Engine, l'utilitaire AE DB Load exécute et surveille toutes les étapes nécessaires à la modification de la base de données. Ceci est nécessaire car il modifie également des données qui ne pourraient pas être modifiées avec du SQL pur. Toutes les étapes traitées par l'utilitaire lors de la procédure de mise à jour sont tracées dans le fichier uc_upd.txt. Le fichier chngdb.sql contient également des informations sur les instructions exécutées dans la base de données. Ces instructions doivent être exécutées par l'utilitaire. Reportez-vous aux notes de mise à jour de la version d'Automation Engine correspondante pour modifier la base de données et préparer les étapes nécessaires.

Le processus de mise à niveau comporte plusieurs phases :

1. Installation et test complet dans un environnement de test.
2. Définir la fenêtre d'intervention et créer un plan pour une éventuelle restauration.
   Ne passez jamais à une nouvelle version d'Automation Engine sans avoir prévu un scénario de restauration.
3. Sauvegarder la base de données d'AE et tous les répertoires des composants.
4. Mettre à niveau étape par étape SANS utiliser les nouvelles fonctionnalités
5. Les nouvelles fonctionnalités ne doivent être utilisées qu'après la mise à jour de tous les composants d'AE et après avoir respecté une période d'observation du système.

Chaque phase comporte plusieurs petites étapes. Votre système AE n'est pas mis à niveau en une seule fois, mais étape par étape. Les anciens composants ne sont pas écrasés et les nouveaux fichiers sont installés dans des répertoires séparés. Seule la base de données AE est directement mise à niveau à l'aide de l'utilitaire AE DB Load. Cette méthode offre deux avantages principaux :

1. Vous pouvez revenir à la version précédente d'AE si des problèmes surviennent dans votre environnement système. Ainsi, les risques vis-à-vis de votre traitement sont minimes.
2. Selon la taille de votre système AE, l'ensemble du processus de mise à niveau peut prendre un certain temps. Grâce à une mise à niveau étape par étape, vous pouvez sélectionner des périodes d'interventions réduites et ainsi mieux coordonner la mise à niveau avec d'autres départements et processus. De plus, cela permet de mieux localiser les erreurs pouvant éventuellement se produire.

Mettez à niveau votre environnement de test en premier. Les problèmes éventuels pourront ainsi être identifiés et résolus avant qu'ils se produisent sur votre système de production. Testez les étapes de la mise à niveau individuellement, pour établir un plan de mise à niveau de votre système de production.

Votre système AE n'est pas disponible au cours de la mise à niveau de la base de données.

Après chaque étape de la mise à niveau de l'installation, il est essentiel de surveiller les nouveaux composants pendant un certain temps. Ce n'est que lorsque leur stabilité est prouvée que vous pouvez continuer à mettre à niveau les autres composants d'AE.

Notez que la procédure de mise à niveau recommandée par Automic permet de reprendre la production à tout moment dans l'ancienne version Automation Engine. Pour cela, il est nécessaire d'installer les composants en parallèle et de préparer une deuxième instance de la base de données.

Use the message-comparing program if you require a list of all changed messages.

Nos consultants sont experts dans la mise à niveau des systèmes AE. Contactez Automic, nos experts seront heureux de vous assister si vous avez besoin d'aide.

Lisez attentivement les notes de mise à jour de la version Automation Enginecorrespondante. Elles contiennent des informations devant être impérativement prises en compte avant ou pendant le processus de mise à niveau.

Le prérequis le plus important est d'avoir un système de test. Avant de pouvoir utiliser la nouvelle version Automation Engine dans votre système de production, des tests complets dans un système distinct sont nécessaires. Vous pouvez ainsi déjà vous familiariser et optimiser les étapes nécessaires pour la mise à niveau de votre système de production.

Nous partons du principe que vous effectuez une maintenance régulière de la base de données. La dernière réorganisation avec les utilitaires AE ainsi qu'avec les outils de la base de données doit être effectuée avant la mise à niveau de la base de données. Plus la base de données est de taille réduite, plus sa mise à niveau est rapide. Attention : le processus de mise à niveau de la base de données AE prend beaucoup de temps. De plus, un espace disque suffisant est nécessaire lors de la duplication des tableaux.

Pendant les phases de mise à niveau, vous devez disposer des autorisations nécessaires sur les ordinateurs, bases de données, systèmes ERP, etc. concernés. Assurez-vous que les administrateurs responsables sont disponibles au cours de chaque étape de travail.

Pendant la durée de la mise à niveau, vous pouvez demander des consultants, des développeurs et un support 24h/24 et 7j/7. Cela permet de gérer au mieux les interventions dans les domaines critiques et sensibles de votre système AE. Contactez votre responsable compte ou le support L'équipe du support technique dès que vous aurez déterminé la date de la mise à niveau.

Préparez le numéro de téléphone et l'adresse électronique du support technique ainsi que les données de connexion pour le centre de téléchargement.

Le tableau ci-dessous liste les nouvelles fonctions susceptibles d'engendrer des problèmes de compatibilité ou devant prises en compte lors de la mise à niveau. Il ne répertorie pas toutes les nouvelles fonctions de cette version d'AE.
Les nouvelles fonctions sont détaillées dans les notes de mise à jour.

Description des colonnes du tableau :

• Sujet : nom du sujet général ou d'une nouvelle fonction
• Comportement modifié : quels éléments ont été modifiés ?
• Incompatibilités éventuelles : impact éventuel de la modification
• Actions / contremesures : que puis-je faire pour identifier et/ou supprimer les incompatibilités potentielles ?

Modification générale de la base de données

Les informations et les instructions de vérification s’appliquent à tous les versions, soit les versions actuelles, soit les nouvelles versions que vous voulez installer.

Le schéma / la structure de la base de données a été modifiée.

Les demandes SQL envoyées à la base de données AE ne fonctionnent plus.

• Consultez chngdb.sql pour en savoir plus sur les modifications générales
• Consultez et modifiez les objets SQL/SQLI/SQLJOBS concernés conformément à cela
• Consultez et modifiez les requêtes de base de données pertinentes qui sont utilisées par des programmes ou outils externes

Package de la mise à jour

Le package de la mise à jour (fichier zip, structure des dossiers et son contenu) a été changé.

Les dossiers et les fichiers suivants ont été retirés :

• Le dossier ./11/ (le contenu, par exemple, UserInterface, AutomationEngine) sont maintenant directement dans le répertoire de base et ne son plus dans le sous-dossier.
• Les fichiers uc4setup et les fichiers d'images CD ont été retirés.
• Un nouvel installeur est disponible pour une installation tout-en-un dans les ensembles de produits.

Les routines d'installation possiblement automatisées utilisant les images de lka mise à jour ne fonctionneront pas.

Si des scripts étaient dépendants de l'ancienne structure du package, vous devez modifier les chemins.

Routage des CP/WP 

Le renvoi des demandes FORMS vers les agents RA a été changé.

Lorsque vous modifiez les objets de connexion RA, un agent RA correspondant doit être actif dans le même client pour obtenir les données.

Assigner un agent RA pour les clients correspondants.

Surveillance de tierce partie par l'interface de surveillance externe (EMI)

La nouvelle interface de pointe JMX (interface de surveillance externe EMI) a été introduite.

L'interface SNMP existante est toujours disponible, mais l'intégration de tierces parties avec BMC Patrol, HP OpenView et Tivoli n'est plus prise en charge.

Il n'y a pas d'incompatibilité, mais l'intégration avec BMC Patrol, HP OpenView et Tivoli n'est plus disponible.

A la place, intrégrez les systèmes de surveillance externes par le nouvel EMI.

Tableaux MQ doublés

Les tableaux MQ ont été doublés et renommés.

Les tableaux MQ ne peuvent pas être considérés lorsque vous utilisez DB Reorg et les scripts existants peuvent échouer en raison du changement des noms de tables.

Modifier les scripts DB Reorg.

Extensions de fichier INI des proxy

Les paramètres et le format de certaines valeurs ont été changés dans le fichier INI en raison des améliorations de fonctionnalités.

Vous ne serez pas en mesure de réutiliser les fichiers INI des versions proxy avant v2 sans modification.

Modifiez les paramètres du fichier INI selon la documentation de l'utilisateur proxy.

Le tableau ci-dessous liste les nouvelles fonctions susceptibles d'engendrer des problèmes de compatibilité ou devant prises en compte lors de la mise à niveau. Il ne répertorie pas toutes les nouvelles fonctions de cette version d'AE.
Les nouvelles fonctions sont détaillées dans les notes de mise à jour.

Description des colonnes du tableau :

• Sujet : nom du sujet général ou d'une nouvelle fonction
• Comportement modifié : quels éléments ont été modifiés ?
• Incompatibilités éventuelles : impact éventuel de la modification
• Actions / contremesures : que puis-je faire pour identifier et/ou supprimer les incompatibilités potentielles ?

Numéros de message

(Pour plus d'informations sur l'éventuel impact individuel, voir aussi la rubrique Modifications des numéros de messages)

Les numéros de message contiennent désormais huit chiffres, et non sept.

Ancien format : Uxxxxxx
Nouveau format

Le filtrage des numéros Uxxxxxx ne fonctionne plus avec

• PREP_PROCESS_REPORT
• PREP_PROCESS_FILE
• Les filtre d'analyse des résultats
• Les scripts d'analyse de log ou les outils personnalisés
• Les rapports de jobs des anciens agents basés sur Java contenant des messages à 7 et 8 chiffres
• Les agents des anciennes versions qui envoient ou tracent des numéros de message à 7 chiffres

• Localisez les fonctions de script PREP_PROCESS_REPORT et PREP_PROCESS_FILE dans les scripts par le biais de la fonction de recherche, par ex., modifiez PREP_PROCESS_REPORT(,,’ACT’,’*U1234567*’) en PREP_PROCESS_REPORT(,,’ACT’,’*U01234567*’) 
• Vérifiez manuellement les objets filtre, ou utilisez une instruction SQL
  par ex., SELECT OH_Name FROM OH,OFC WHERE OH_Idnr=OFC_OH_Idnr AND OFC_Filtertext LIKE 'U001%' AND OH_DeleteFlag = 0

Valeurs des variables texte 

• La limite de 1024 caractères pour les champs et variables à base de texte a été supprimée
• Le type de données des champs BD est passé de VARCHAR (1024) à CLOB (illimité)

• Le package Oracle DBMS_LOB doit être installé pour gérer CLOB  
• Les résultats des opérations sur les chaînes de caractères peuvent dépasser 1024 caractères au lieu de subir une troncature de chaîne ou générer des messages d'erreur
• Les demandes d'objets SQL/SQLI peuvent fonctionner sur les tableaux dotés de champs de texte avec des types de données modifiés -> Référez-vous à chngdb.sql

Vérifiez les demandes envoyées aux tables dotées de champs modifiés (VARCHAR -> CLOB)

par ex., recherchez "OVW_Value1" : SELECT OH_Name FROM OH WHERE OH_Idnr IN (SELECT OVD_OH_Idnr FROM OVD WHERE OVD_SQL like '%OVW_Value1%' OR  OVD_SQLOra like '%OVW_Value1%' OR OVD_SQLDB2 like '%OVW_Value1%')

Fonction de script GET_OH_IDNR

Le client du deuxième paramètre a été supprimé de cette fonction de script Automic pour des raisons de sécurité.

Les objets qui utilisent cette fonction de script avec le client de paramètre indiqué seront interrompus.

Vérifiez tous les onglets de script pour cette fonction, et supprimez le paramètre ou corrigez la fonction d'appel.

Objets Login pour les événements de fichier sur Windows, UNIX, et zOS

Un nouveau privilège a été ajouté aux objets utilisateurs

Le nouveau privilège est vérifié et utilisé par défaut après la mise à niveau de la version d'AE.

• Lors de la mise à niveau, le nouveau paramètre par défaut est utilisé, et aucune action n'est nécessaire.
• Mais si des objets utilisateurs sont chargés par le biais du conteneur de transport ou si des données XML sont importées, ce privilège peut ne pas être défini. Si nécessaire, il doit être configuré manuellement.

zOS : Remplacement des lignes de Job dans JCL

Les valeurs de l'attribut MVS_JOBTYPE sont obsolètes.

Aucune incompatibilité pour l'instant, l'ancienne valeur est toujours compatible.

Aucune vérification/modification n'est nécessaire

Variables XML (VARA.XML)

• Le client Oracle INSTANT n'est plus pris en charge.
• Le package Oracle XML DB doit être installé.

• Le client entier Oracle doit être installé (au lieu du client Oracle INSTANT).
• Le package "Oracle XML DB" doit être installé.

Aucune vérification/modification n'est nécessaire. Cela fait partie de l'installation de la base de données AE

Tâches FAULT_OTHER

Le comportement de la désactivation des tâches dotées du statut FAULT_OTHER a été modifié.

• Dans les versions antérieures d'AE, les tâches sont désactivées dans la liste des activités par défaut. À compter de la version 11, la désactivation est liée à l'option de désactivation de la tâche.
• Par conséquent, plus de tâches demeurent dans la fenêtre des activités par rapport auxversions antérieures d'AE.

Consultez les options de désactivation en conséquence.

(Si nécessaire, elles peuvent être configurées pour archiver le comportement de la version antérieure d'AE)

Fonction de script GET_ATT_SUBSTR(call_text)

Dans les versions antérieures d'AE, au moins un espace était renvoyé. À compter de la version 11, aucune valeur n'est renvoyée en cas d'appel manqué.

Une erreur se produit si le texte d'appel est vide.

Agents RA

Les bibliothèques tierces partagées ont été supprimées du coeur des agents RA.

Vous devez obtenir toutes les bibliothèques tierces partagées, et vérifier qu'elles sont correctement installées.

Téléchargez le pilote Oracle JDBC et copiez-le dans le répertoire lib du coeur RA.

Ceci est uniquement nécessaire pour un agent RA nécessitant une connexion à la base de données Oracle (via JDBC) – par ex., RA Banner, RA JDE ou RA Oracle Retail.

De la version 9 SP4 à la version 10 SP4, GET_VAR se résout de manière récurrente. Cela signifie que si une valeur contient le caractère "&", le processeur de script essaie de la résoudre. Ceci a été modifié.
Exemple :
Variable de script "MYVAR", clé = 1 Valeur = "Schmidt&Partners"
Script
:set &partners = 'no'
:set &value# = get_var('MYVAR','1')

La variable &value# contiendra donc :
v9 SP4 vers v10: Schmidtno
V11 : Schmidt&Partners

En version 10 SP4 HF1, le comportement était configurable (avec la clé RESOLVE_GET_VAR dans UC_SYSTEM_SETTINGS).

En version 11, l'option de configuration a été supprimée. En conclusion, toutes les valeurs de variables qui doivent être résolues de manière récurrente doivent utiliser la fonction de script RESOLVE_VAR.

Potentiellement tous les scripts utilisant GET_VAR et une variable contenant le caractère "&" sont affectés.
Il peut être difficile de déterminer les scripts/variables affectés, et ce, surtout pour les variables dynamiques.
Il est recommandé d'effectuer plusieurs tests exhaustifs.

Pour déterminer les objets variables affectés, vous pouvez utiliser cette demande SDL :

select oh_client, oh_name from oh where oh_idnr in
(select ovw_oh_idnr from ovw where
ovw_value1 like '%&%'
or OVW_Value2 like '%&%'
or ovw_value3 like '%&%'
or ovw_value4 like '%&%'
or ovw_value5 like '%&%'
) order by OH_Client, OH_Name asc

La fonction de script RESOLVE_VAR peut être utilisée pour résoudre un objet variable statique de manière récursive.

La longueur des variables de script est désormais illimitée.

Vous pouvez utiliser GET_VAR pour vérifier l'existence d'une clé retournant un vide, comme dans l'exemple suivant :
:SET &test# = GET_VAR(‚VARA.TEST‘,‘KEY_DOES_NOT_EXIST‘)

Ainsi, si vous utilisez STR_MATCH() avec une chaîne de caractères vide pour la variable de script &test# :
:SET &true# = STR_MATCH(&test#,"")

dans v10 de Automation Engine, la valeur renvoyée pour &true# sera "Y"
Dans V11 , elle sera "N".

Explication :
Dans STR_MATCH(), une variable de longueur 0 est attendue (""). La variable &test# contenant un vide (" "), la valeur renvoyée pour &true# est "N".

Le comportement de v11 est donc correct.

Le résultat du script suivant est différent dans v10 et v11.1 :

:SET&TEST#=' 0000000050'
:IFFORMAT(&TEST#, "0") =50
:P"valid"
:ENDIF

Dans v10, le résultat sera l'affichage de « valid » dans le rapport.

Dans v11.1, vous recevrez un message d'erreur indiquant que les lignes non numériques ne sont pas autorisées.

Lire les notes de mise à jour

Refuser les nouveaux démarrages de jobs

Préparation du processus de mise à niveau des composants principaux

Mise à niveau des interfaces utilisateurs

Mise à niveau de Enterprise Control Center

Maintenance de la base de données AE

Duplication de la base de données AE

Mise à niveau des utilitaires

Mise à niveau d'AE et du ServiceManager

Upgrade Framework Integration (optional)

Upgrade UserInterfaces (if they have not yet been upgraded)

Upgrade the Enterprise Control Center (if it has not yet been upgraded)

Stop all clients

Stop the Automation Engine

Back up the AE database

Upgrade the AE database

• Automic strongly recommends reading the notes concerning database modifications below before starting the upgrading process.
• Upgrade your AE database using the utility AE DB Load. The individual steps you find below.
• If you have created a duplicate, Automic recommends upgrading it now in order to make sure that the original instance remains operable. Keep in mind to enter the correct database connection in the INI files of the utilities.

Notes on Upgrading the AE Database   Remarques importantes :   Automic conseille aux administrateurs de base de données de suivre la procédure ci-après.  Toute modification directe du contenu de la base de données sans utiliser les programmes AE provoquera des problèmes de cohérence. Ne démarrez les étapes de travail qu'après avoir sauvegardé la base de données. La durée de ce processus est fonction de la taille de la base de données et de l'étendue de la mise à jour. Il faut éventuellement tenir compte du déplacement de grandes quantités de données. Assurez-vous que l'espace disque pour le répertoire \AUTOMIC\DB et pour la section LOG de la base de données permettent de stocker toutes ces données. Les droits d'accès affectés à l'Utilisateur de la base de données en vue de la mise à jour doivent être rétablis après l'opération de mise à jour. Il est ainsi possible d'éviter des modifications de base de données non voulues. DB2 : Après la mise à jour de la base de données AE, contrôlez la taille des espaces de table et exécutez le cas échéant l'instruction SQL suivante : ancien espace de table <Nom de l'espace de table UC4> reduce max;

Database Upgrade with AE DB Load Utility Remarques : Le répertoire DB du CD d'installation peut contenir plusieurs versions de scripts SQL et de fichiers de base de données. Ils sont requis une mise à niveau est effectuée sur plusieurs versions. Vérifez que vous utilisez la version correcte si <vers> est indiqué dans le document. Automic vous conseille vivement de lire également les remarques relatives à la mise à niveau de la base de données AE, ci-dessus. Les modifications, qui doivent être effectuées se trouvent dans le fichier special_rt.sql. De plus, le fichier new_mq.sql doit également être exécuté. Dans le fichier UC_UPD.TXT, cherchez les lignes et supprimez le commentaire "message" au début. Extrait du fichier modifié UC_UPD.TXT : process_sql_file new_mq.sql process_sql_file special_rt.sql Le fichier special_rt.sql convertit les rapports enregistrés dans la base de données. En fonction du nombre d'enregistrements de rapports concernés par la conversion, vous devez veiller à disposer suffisamment de mémoire et d'un log de transaction d'une taille appropriée. La table est copiée et est donc brièvement disponible en double exemplaire. C'est pourquoi la conversion dure également plus longtemps. Automic recommande de réorganiser les rapports avant d'exécuter UC_UPD.TXT afin de réduire autant que possible le nombre d'enregistrements de rapports. Procédure : 1. Modifier le schéma de la base de données et charger de nouvelles données initiales dans la base de données Ordinateur serveur Tous les processus serveur doivent être arrêtés. Soyez particulièrement vigilant si vous avez réparti des processus du serveur sur plusieurs ordinateurs. Les étapes suivantes ne doivent être traitées que si tous les processus ont été arrêtés. Ordinateur administrateur Le répertoire contenant les fichiers de la base de données doit se trouver à l'emplacement spécifié par le paramètre INPUT du fichier INI de l'utilitaire AE DB Load. Par défaut, c'est le dossier dans lequel se trouve le répertoire BIN des utilitaires. Exemple pour Windows : Utilitaires dans C:\AUTOMIC\UTILITY\BIN Fichiers de base de données dans C:\AUTOMIC\UTILITY\DB Utilitaires - Windows : Les fichiers pour la base de données AE se trouvent dans IMAGE:DB. Copiez l'intégralité du dossier DB dans le répertoire mentionné ci-dessus Utilitaires UNIX : Les fichiers de la base de données sont contenus dans l'archive db.tar.gz qui est fournie dans le dossier IMAGE:DB. Décompressez l'archive avec les commandes suivantes : gzip -d db.tar.gz ou gunzip db.tar.gz tar xvfo db.tar (Linux : tar -zxvf db.tar.gz) Copiez ensuite les fichiers décompressés dans le répertoire défini. Démarrez le programme AE DB Load pour mettre à niveau la base de données. Sélectionnez le fichier <Répertoire DB>\GENERAL\<vers>\UC_UPD.TXT La version courante de la base de données est identifiée et la base de données est mise à niveau. La structure de la base de données ainsi que les données sont modifiées. Les objets du client 0000 sont remplacés ou complétés automatiquement. 2. Sélectionner la méthode d'authentification Ordinateur administrateur AE.DB Load affiche un masque dans lequel vous devez sélectionner une méthode d'authentification. Ce masque ne s'affiche que si la base de données est mise à niveau dans une nouvelle Automation Engine version. 3. Installer le partitionnement avec ILM (optionnel) Ordinateur administrateur Un masque s'ouvre dans lequel vous pouvez configurer les paramètres du partitionnement avec ILM. Cette étape est optionnelle.  Le partitionnement de la base de données AE ne peut pas être annulé.

Configure and start the Java Work Process (JWP)

• As of version 11.2 of the Automation Engine the function Export with references and the full text search in the ECC require a JWP.

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").

Start the Automation Engine and clients

Monitor the AE system

Installation des Agents

Installation des autres composants

Utilisation des nouvelles fonctionnalités