Partie IV : Configuration supplémentaire de
LiveCycle Workflow
Cette section du guide décrit la configuration supplémentaire des installations de LiveCycle Workflow.
140
14
Configuration de WebSphere 5.1.1.5 pour BAM
Server
Ce chapitre s'applique uniquement aux licences LiveCycle Workflow permettant d'utiliser
Business Activity Monitor.
Ce chapitre explique comment créer la base de métadonnées BAM, configurer BAM Server pour
WebSphere 5.1.1. 5 et déployer l'application BAM Server. BAM Server est un composant de
LiveCycle Workflow.
Ce chapitre suppose que vous avez installé la base de données LiveCycle. Si ce n'est pas le cas,
reportez-vous à la section « Préparation de l'environnement », page 30 .
Création de la base de métadonnées BAM
Vous devez créer une base de métadonnées LiveCycle pour enregistrer les définitions des métriques de processus que BAM Server surveille, ainsi que les détails relatifs aux alertes et aux données d'exécution d'objet enregistrées sur le disque.
Les métadonnées BAM pouvant représenter un volume important, vous devez attribuer au moins 50 Mo à la base de métadonnées BAM. Pour les déploiements de production, allouez au moins 200 Mo.
BAM Server peut nécessiter des paramètres spécifiques pour certains aspects de la configuration de la base de métadonnées BAM. Les paramètres dépendent du type de serveur d'applications hébergeant
BAM Server et du type de serveur de base de données utilisé pour enregistrer les métadonnées BAM.
Comptes utilisateur
Vous devez également créer un compte utilisateur utilisable par BAM Server pour se connecter à la base de métadonnées BAM. Ce compte doit disposer de droits d'accès en création, en modification et en mise à jour sur la base de données.
Sous Oracle, le compte utilisateur de la base de données doit être associé à un espace de stockage créé spécifiquement pour les métadonnées BAM. Lors de la création du compte, le nom de base de données globale et le SID doivent être cqst
et le nom d'utilisateur doit être cqstmeta
.
Création de variables d'environnement pour DB2
Si vous utilisez DB2 comme base de métadonnées BAM, vous devez créer une variable d'environnement contenant le nom de l'instance DB2 associée. Vous devez également inclure le chemin d'accès aux bibliothèques partagées DB2 dans la variable de chemin d'accès à la bibliothèque.
Les exemples suivants illustrent les commandes permettant de configurer les variables d'environnement.
Utilisez les commandes correspondant à votre système d'exploitation. Vous devrez peut-être modifier la commande pour l'adapter à l'emplacement d'installation de DB2.
141
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Configuration de WebSphere pour BAM Server 142
Exemple 14.1 Commandes de configuration des variables d'environnement sous Windows
Les commandes suivantes s'appliquent à une instance DB2 nommée DB2, les fichiers de bibliothèque DB2
étant installés dans C:\SQLLIB\BIN : set DB2INSTANCE=DB2 set PATH=C:\SQLLIB\BIN;%PATH%
Exemple 14.2 Commandes de configuration des variables d'environnement sous Solaris
Les commandes suivantes s'appliquent à une instance DB2 nommée db2fs, les fichiers de bibliothèque
DB2 étant installés dans /opt/IBM/db2/V8.1/lib : export DB2INSTANCE=db2fs export LD_LIBRARY_PATH=/opt/IBM/db2/V8.1/lib:${LD_LIBRARY_PATH}
Exemple 14.3 Commandes de configuration des variables d'environnement sous AIX
Les commandes suivantes s'appliquent à une instance DB2 nommée db2fs, les fichiers de bibliothèque
DB2 étant installés dans /opt/IBM/db2/V8.1/lib : export DB2INSTANCE=db2fs export LIBPATH=/opt/IBM/db2/V8.1/lib:${LIBPATH}
Configuration de WebSphere pour BAM Server
Si vous installez LiveCycle Workflow tout en utilisant Business Activity Monitor, vous devez configurer manuellement WebSphere afin que BAM Server s'exécute correctement.
Vous devez exécuter les tâches suivantes :
●
Si ce n'est pas déjà fait, créez un serveur d'applications pour exécuter BAM Server. Reportez-vous à la
section « Création d'une instance de serveur d'applications », page 36 .
●
Installez les pilotes de base de données sur le serveur d'applications que vous avez créé pour
BAM Server. Reportez-vous à la section
« Installation des pilotes de base de données pour
.
●
●
Configurez la connexion à la base de métadonnées BAM. Reportez-vous à la section
« Configuration de la connexion à la base de métadonnées BAM », page 143 .
Installation des pilotes de base de données pour BAM Server
Pour permettre à WebSphere de se connecter à la base de métadonnées de BAM, vous devez installer les pilotes de base de données sur l'ordinateur sur lequel WebSphere est installé. Les pilotes Oracle et DB2 (le cas échéant) ont déjà été copiés dans le répertoire ${WAS_INSTALL_ROOT}/db_driver à l'étape
« Installation des pilotes de base de données », page 45
.
Vous devrez également supprimer le fichier ojdbc14.jar du répertoire [racine du serveur
d'applications]/appserver/lib du serveur d'applications WebSphere.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Configuration de la connexion à la base de métadonnées BAM 143
➤
Pour installer les pilotes de base de données pour SQL Server :
1. Accédez au répertoire ${WAS_INSTALL_ROOT}/db_driver.
2. Téléchargez le pilote SQL Server 2000 pour JDBC depuis le site Web suivant : www.microsoft.com/sql/downloads . Ce téléchargement installe les fichiers msbase.jar, mssqlserver.jar et msutil.jar requis.
Remarque :
il se peut que ces pilotes soient déjà installés sur l'ordinateur hébergeant la base de données. Reportez-vous à la section
« Installation des procédures stockées JTA », page 33 .
3. Copiez les fichiers mssqlserver.jar, msbase.jar et msutil.jar dans le répertoire
${WAS_INSTALL_ROOT}/db_driver.
Configuration de la connexion à la base de métadonnées BAM
Vous devez configurer une source de données pour la base de métadonnées BAM sur WebSphere de sorte que BAM Server puisse récupérer les informations sur les métriques de processus à contrôler :
●
●
●
(DB2) Créez un alias d'authentification JAAS pour la base de métadonnées BAM. Reportez-vous à la
.
Créez le pool de connexion JDBC. Reportez-vous à la section
« Création du fournisseur JDBC pour la base de métadonnées BAM », page 144 .
Créez la source de données. Reportez-vous à la section
« Création de la source de données pour la base de métadonnées BAM », page 144 .
Création d'un alias d'authentification JAAS pour la base de métadonnées
BAM sur DB2
Si vous stockez les métadonnées BAM dans une base de données DB2, vous devez créer un alias d'authentification JAAS pour un compte utilisateur ayant accès à la base de métadonnées BAM.
➤
Pour créer un alias d'authentification JAAS pour la base de métadonnées BAM sur DB2 :
1. Démarrez le serveur d'applications WebSphere.
2. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez Security >
JAAS Configuration > J2C Authentication Data.
3. Sur la page J2C Authentication Data Entries, cliquez sur New.
4. Sur la page qui s'affiche, spécifiez les valeurs des propriétés suivantes, puis cliquez sur OK :
●
Alias : nom de l'alias. Saisissez
BAMDB2
●
User ID : nom d'utilisateur du compte utilisateur ayant accès à la base de métadonnées BAM sur DB2.
●
●
Password : mot de passe associé à l'ID utilisateur spécifié.
Description : (Facultatif ) description de l'alias.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Configuration de la connexion à la base de métadonnées BAM 144
Création du fournisseur JDBC pour la base de métadonnées BAM
Vous devez créer le fournisseur JDBC que vous utiliserez pour créer la connexion à la base de métadonnées
BAM.
➤
Pour créer le fournisseur JDBC :
1. Démarrez le serveur d'applications WebSphere.
2. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Resources > JDBC Providers.
3. Dans la zone Server de Scope, saisissez le nom de l'instance de serveur créée pour BAM Server et cliquez sur New.
4. Dans le menu JDBC Provider, sélectionnez le pilote de base de données correspondant au type de base de données que vous utilisez pour stocker les métadonnées BAM, puis cliquez sur Apply.
●
●
●
(Oracle) Sélectionnez Oracle JDBC Driver.
(DB2) Sélectionnez DB2 Universal JDBC Driver Provider.
(SQL Server) Sélectionnez WebSphere embedded ConnectJDBC driver for MS SQL Server.
5. Dans la zone Classpath, ajoutez les chemins d'accès aux fichiers à la suite des autres entrées de la zone, en fonction du type de base de données que vous utilisez pour stocker les métadonnées BAM. Si vous devez ajouter plusieurs chemins de classe, n'oubliez pas d'ajouter un retour chariot après chaque chemin d'accès :
●
●
Oracle :
{WAS_INSTALL_ROOT}/db_driver/ojdbc14.jar
DB2 :
●
{WAS_INSTALL_ROOT}/db_driver/db2jcc.jar
{WAS_INSTALL_ROOT}/db_driver/db2jcc_license_cu.jar
SQL Server :
{WAS_INSTALL_ROOT}/db_driver/mssqlserver.jar
{WAS_INSTALL_ROOT}/db_driver/msbase.jar
{WAS_INSTALL_ROOT}/db_driver/msutil.jar
Remarque :
veillez à ne pas supprimer les entrées existantes dans la zone Classpath.
6. Cliquez sur OK au bas de l'onglet.
7. Enregistrez les modifications apportées à la configuration principale.
Création de la source de données pour la base de métadonnées BAM
Vous devez créer une source de données pour permettre à BAM Server de se connecter à la base de métadonnées BAM.
➤
Pour créer la source de données pour la base de métadonnées BAM :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Resources > JDBC Providers.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Configuration de la connexion à la base de métadonnées BAM 145
2. Cliquez sur le fournisseur JDBC que vous avez créé pour la base de métadonnées BAM.
3. Dans le tableau Additional Properties, sélectionnez Data Sources.
4. Cliquez sur New, spécifiez les valeurs suivantes pour les propriétés, puis cliquez sur OK :
●
●
●
●
●
Name :
com.celequest.metadata.metaDatasource
JNDI Name :
jdbc/com.celequest.metadata.metaDatasource
Container managed persistence : désactivez cette option
Datasource Helper Class Name : (Oracle 10g uniquement) com.ibm.websphere.rsadapter.Oracle10gDataStoreHelper
Container-managed Authentication Alias : (DB2)
BAMDB2
5. Sur la page Data Sources, cliquez sur com.celequest.metadata.metaDatasource, puis sur Custom
Properties.
6. (Oracle) Cliquez sur URL, saisissez la valeur suivante pour la propriété URL, puis cliquez sur OK : jdbc:oracle:thin:@[nomhôte]:[port]:[Nom_BD_BAM]
[
nom_hôte] correspondant au nom de l'ordinateur sur lequel Oracle est exécuté,
[
port] au port utilisé pour accéder à la base de données Oracle et
[Nom_BD_BAM]
au nom de la base de données BAM.
7. (SQL Server, DB2) Spécifiez les valeurs des propriétés ci-après suivant le type de base de données utilisé pour stocker les métadonnées BAM :
●
DB2 :
●
serverName : nom de l'ordinateur ou adresse IP de l'ordinateur hébergeant DB2.
portNumber : port utilisé pour accéder à DB2. La valeur par défaut est de 50000.
databaseName :
[Nom_BD_BAM]
(Reportez-vous à la section
« Configuration de WebSphere pour
SQL Server :
serverName : nom d'hôte ou adresse IP de l'ordinateur exécutant la base de données
portNumber : port utilisé pour accéder à SQL Server. La valeur par défaut est de 1433.
databaseName :
[Nom_BD_BAM]
(Reportez-vous à la section
« Configuration de WebSphere pour
8. Sur la page Custom Properties, cliquez sur New, spécifiez les valeurs des propriétés suivantes, puis cliquez sur OK :
●
Name :
user
(cette propriété est sensible à la casse et n'accepte que des minuscules)
●
●
Value : nom d'utilisateur du compte utilisateur ayant accès à la base de métadonnées BAM.
Reportez-vous à la section
« Configuration de WebSphere pour BAM Server », page 142
.
Description : (Facultatif ) description de la propriété.
9. Sur la page Custom Properties, cliquez sur New, spécifiez les valeurs des propriétés suivantes, puis cliquez sur OK :
●
Name :
password
(cette propriété est sensible à la casse et n'accepte que des minuscules)
●
●
Value : mot de passe du compte utilisateur ayant accès à la base de métadonnées BAM.
Description : (Facultatif ) description de la propriété.
10. Enregistrez les modifications apportées à la configuration principale.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Création de la source de données d'intégration 146
Test de la connexion à la base de données
Vous devez tester la configuration du fournisseur JDBC à l'aide de la fonction de test de la connexion de
WebSphere.
➤
Pour tester la connexion à la base de données :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez JDBC
Providers >
[Fournisseur]
> Data Sources.
2. Sélectionnez le fournisseur com.celequest.metadata.metaDatasource.
3. Cliquez sur Test Connection.
La zone Message située en haut de la page affiche les résultats du test. Si le test échoue, utilisez les fonctions de génération de rapports d'erreurs de WebSphere pour identifier l'origine du problème.
Création de la source de données d'intégration
Vous devez créer une source de données pour permettre à de se connecter à la base de données LiveCycle.
➤
Pour créer la source de données pour la base de données LiveCycle :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Resources > JDBC Providers.
2. Cliquez sur le fournisseur JDBC que vous avez créé pour la base de métadonnées BAM.
3. Dans le tableau Additional Properties, sélectionnez Data Sources.
4. Cliquez sur New, spécifiez les valeurs suivantes pour les propriétés, puis cliquez sur Apply :
●
Name : com.celequest.adobe
●
JNDI Name :
jdbc/com.celequest.adobe
●
●
Container managed persistence : sélectionnez cette option
Datasource Helper Class Name : (Oracle 10g uniquement) com.ibm.websphere.rsadapter.Oracle10gDataStoreHelper
5. Cliquez sur Custom Properties.
6. (Oracle) Cliquez sur URL, saisissez la valeur suivante pour la propriété URL, puis enregistrez les modifications apportées à la configuration principale : jdbc:oracle:thin:@[nomhôte]:[port]:[Nom_BD_BAM]
[nom_hôte]
correspondant au nom de l'ordinateur sur lequel Oracle est exécuté,
[port]
au port utilisé pour accéder à la base de données Oracle et
[Nom_BD_BAM]
au nom de la base de données LiveCycle.
7. (DB2) Spécifiez les valeurs des propriétés ci-après suivant le type de base de données utilisé pour stocker les métadonnées BAM :
serverName : nom de l'ordinateur ou adresse IP de l'ordinateur hébergeant DB2.
portNumber : port utilisé pour accéder à DB2. La valeur par défaut est de 50000.
databaseName : nom de la base de données LiveCycle.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Configuration des paramètres de WebSphere 147
8. (SQL Server) Spécifiez les valeurs des propriétés ci-après suivant le type de base de données utilisé pour stocker les métadonnées BAM :
serverName : nom d'hôte ou adresse IP de l'ordinateur exécutant la base de données
portNumber : port utilisé pour accéder à SQL Server. La valeur par défaut est de 1433.
databaseName : nom de la base de données LiveCycle.
9. Sous Related Items, sélectionnez J2C Authentication Data Entries.
10. Cliquez sur New, puis tapez un nom (par exemple,
MyAliasLiveCycle
) dans la zone Alias.
11. Entrez le compte utilisateur
[admin BD LiveCycle]
et le mot de passe connexe, puis cliquez sur
Apply et sur OK.
12. Enregistrez les modifications apportées à la configuration principale.
13. Revenez à JDBC Providers > [base de métadonnées BAM] > Data Sources et sélectionnez com.celequest.adobe
.
14. Dans la zone Container-managed Authentication Alias, sélectionnez l'alias d'authentification JAAS pointé vers la base de données Adobe LiveCycle saisie à l'étape
15. Enregistrez les modifications apportées à la configuration principale.
Test de la connexion à la base de données
Vous devez tester la configuration du fournisseur JDBC à l'aide de la fonction de test de la connexion de
WebSphere.
➤
Pour tester la connexion à la base de données :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez JDBC
Providers >
[Fournisseur]
> Data Sources.
2. Sélectionnez le fournisseur com.celequest.adobe.
3. Cliquez sur Test Connection.
La zone Message située en haut de la page affiche les résultats du test. Si le test échoue, utilisez les fonctions de génération de rapports d'erreurs de WebSphere pour identifier l'origine du problème.
Configuration des paramètres de WebSphere
Vous devez configurer plusieurs paramètres de serveur dans WebSphere pour assurer la prise en charge de
BAM Server.
➤
Pour définir les paramètres du serveur d'applications :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez Servers >
Application Servers, puis cliquez sur le nom du serveur d'applications sur lequel vous allez déployer
BAM Server.
2. Cliquez sur l'onglet Configuration, puis, sous Additional Properties, cliquez sur Process Definition.
3. Sur la page Process Definition, sous Additional Properties, cliquez sur Java Virtual Machine.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Configuration des paramètres de WebSphere 148
4. Sur la page de configuration de la machine virtuelle Java, renseignez les zones Initial Heap et
Maximum Heap.
Ces paramètres dépendent des possibilités de votre système. Vous devez leur attribuer la valeur la plus
élevée possible. Il est recommandé de spécifier des valeurs au moins égales à 128 et 512.
5. Ajoutez le texte suivant dans la zone Generic JVM Arguments pour prendre en charge UTF-8 :
-Dfile.encoding=utf8
6. Sous Additional Properties, cliquez sur Custom Properties, puis sur New et spécifiez les valeurs appropriées pour la propriété suivante :
●
Name :
com.celequest.metadata.jdbcDriver.
●
Value : spécifiez l'une des valeurs suivantes, en fonction du type de base de données utilisé pour stocker les métadonnées BAM :
●
●
●
(Oracle) oracle.jdbc.driver.OracleDriver
(SQL Server) com.microsoft.jdbc.sqlserver.SQLServerDriver
(DB2) com.ibm.db2,jcc.DB2Driver
7. Cliquez sur OK pour appliquer les modifications et revenir à la page Custom Properties.
8. Cliquez sur New pour créer la propriété com.celequest.metadata.jdbcURL, puis attribuez un nom et une valeur à la propriété personnalisée :
●
●
Name :
com.celequest.metadata.jdbcURL.
Value : spécifiez l'une des valeurs suivantes, en fonction du type de base de données utilisé pour stocker les métadonnées BAM :
●
DB2 : jdbc: db2://[nomhôte]:[port][Nom_BD_BAM]:user=[nomutilisateur];password=
[mot de passe];
[nomhôte
] correspondant au nom de l'ordinateur sur lequel DB2 est exécuté,
[port]
au port utilisé pour accéder à la base de données DB2 représentée par
[Nom_BD_BAM
] dans l'adresse,
[nomutilisateur]
au nom du compte utilisateur utilisé pour accéder à la base de données et
[
mot de passe] au mot de passe du nom d'utilisateur spécifié pour le paramètre
[
NOMUTILISATEUR
]
.
●
SQL Server : jdbc:microsoft:sqlserver://[nomhôte]:[port];databaseName=
[Nom_BD_BAM];selectMethod=Cursor;user=[Admin_BD_BAM]; password=[mot de passe]
[nomhôte]
correspondant au nom de l'ordinateur sur lequel SQL Server est exécuté,
[port]
au port utilisé pour accéder à la base de données SQL Server représentée par
[Nom_BD_BAM]
dans l'adresse et
[motdepasse
] au mot de passe du compte d'utilisateur
[Admin_BD_BAM]
.
●
Oracle : jdbc:oracle:thin:[Admin_BD_BAM ]/[mot de passe]@[nomhôte]:[port]:
[nom_BD_BAM]
[mot de passe]
correspondant au mot de passe associé au nom du compte utilisateur spécifié pour l'utilisateur de base de données
[Admin_BD_BAM]
,
[nomhôte]
au nom de l'ordinateur sur lequel Oracle est exécuté et
[
port] au port utilisé pour accéder à la base de données Oracle représentée par
[Nom_BD_BAM]
dans l'adresse.
Ces valeurs doivent correspondre à l'URL Oracle spécifiée dans la source de données de la base de métadonnées BAM. Reportez-vous à la section
« Création de la source de données pour la base de métadonnées BAM », page 144
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Paramètres JVM WebSphere facultatifs 149
9. (Facultatif ) Cliquez sur New pour créer une nouvelle propriété pour spécifier les propriétés JVM facultatives associées à la base de métadonnées BAM, puis saisissez le nom et la valeur de la propriété personnalisée :
●
Name : saisissez le nom de la propriété au format suivant : com.celequest.property.[PARAMETRE]
●
Value : saisissez la valeur de la propriété.
Pour plus de détails sur les noms et valeurs des propriétés JVM facultatives, reportez-vous à la section
« Paramètres JVM WebSphere facultatifs », page 149 .
pour chaque propriété JVM facultative que vous souhaitez spécifier.
11. Cliquez sur OK et enregistrez les modifications apportées à la configuration principale.
12. Revenez à la page principale du serveur en cliquant sur son nom en haut de la page, puis cliquez sur
Transaction Service sous Additional Properties.
13. Sur la page Transaction Service, tapez
600
dans la zone Total transaction lifetime timeout.
14. Cliquez sur OK pour revenir à la page Custom Properties.
15. Enregistrez les modifications apportées à la configuration principale.
16. Redémarrez WebSphere.
Paramètres JVM WebSphere facultatifs
Vous pouvez configurer plusieurs paramètres JVM facultatifs associés à la base de métadonnées Business
Activity Monitor, notamment la langue, le pays et le niveau d'assemblage. Ces paramètres JVM sont exprimés parles propriétés personnalisées de la machine virtuelle Java. Les propriétés personnalisées possèdent les attributs suivants :
●
●
Nom : com.celequest.property.[PARAMETRE]
Valeur :
[VALEUR]
Ce tableau fournit les valeurs valides de
[PARAMETRE]
et
[VALEUR]
.
Paramètre Description
LANGUAGE
Code ISO pour la langue du serveur.
Par exemple, pour définir la langue sur le portugais, la propriété personnalisée com.celequest.property.LANGUAGE
doit avoir la valeur
PT
.
COUNTRY
LOCALESORT
Code ISO pour le pays du serveur.
Cette option permet d'indiquer si les chaînes sensibles aux paramètres locaux ont
été comparées. Les valeurs valides sont true
et false
:
●
Indiquez true
si vous souhaitez comparer les chaînes sensibles aux paramètres locaux.
●
Indiquez false
si vous ne souhaitez pas comparer les chaînes sensibles aux paramètres locaux.
La valeur par défaut est false
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Création d'un alias d'hôte virtuel 150
Paramètre Description
STRENGTH
Niveau de force d'assemblage correspondant au degré selon lequel les caractères non anglais sont comparés et assemblés.
Les valeurs valides (de la moins sélective à la plus sélective) sont les suivantes : primary
, secondary
, tertiary
et identical
. La valeur par défaut est tertiary
.
Pour plus d'informations sur les paramètres d'assemblage, consultez la documentation de Sun Java à l'adresse suivante : http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html
.
Remarque :
ce paramètre n'est opérationnel que si
LOCALESORT
est défini sur true
.
DECOMPOSITION
Mode de décomposition de l'assemblage. Les valeurs valides sont none
, canonical
et full
. La valeur par défaut est canonical
.
Pour plus d'informations sur les paramètres d'assemblage, consultez la documentation de Sun Java à l'adresse suivante : http://java.sun.com/j2se/1.4,2/docs/api/java/util/Locale.html
Remarque :
ce paramètre n'est opérationnel que si
LOCALESORT
est défini sur true
.
Création d'un alias d'hôte virtuel
Vous devez créer un alias d'hôte pour le port permettant d'accéder au service BAM Server. Une fois l'alias créé, vous devez utiliser Administrator pour mettre à jour les paramètres de LiveCycle Workflow Server avec la nouvelle URL de BAM Server.
➤
Pour créer un alias d'hôte virtuel :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Environment > Virtual Hosts.
2. Cliquez sur default host.
3. Sous Additional Properties, cliquez sur Host Aliases.
4. Cliquez sur New, spécifiez les valeurs suivantes pour les propriétés, puis cliquez sur OK :
●
Name :
*
●
Value :
9091
5. Enregistrez les modifications apportées à la configuration principale.
Déploiement de BAM Server sur WebSphere
Vous devez déployer le fichier EAR de BAM Server (CAS_Adobe.ear) sur le serveur d'applications configuré pour exécuter BAM Server. Vous devez également déployer le fichier EAR d'intégration de BAM Server
(CQIntegration.ear) sur le serveur d'applications configuré pour exécuter LiveCycle Workflow Server.
Pour éviter les problèmes de déploiement sous Windows, vous devez prédéployer le fichier EAR de BAM
Server. Avant d'exécuter la procédure suivante, vérifiez que les installations précédentes de BAM Server sont arrêtées et désinstallées, et que le serveur d'applications WebSphere n'est pas en cours d'exécution.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Déploiement de BAM Server sur WebSphere 151
➤
(Windows) Pour prédéployer le fichier EAR de BAM Server :
1. Créez un répertoire de travail, par exemple c:\wrk.
2. Créez un répertoire temporaire, par exemple c:\tmp.
3. Créez un répertoire de destination, par exemple c:\bam.
4. Copiez le fichier CAS_Adobe.ear du répertoire [racine LiveCycle]/components/bam/common dans le répertoire de travail que vous avez créé.
5. Ouvrez une invite de commande et remplacez le répertoire de travail actuel par le répertoire [racine du
serveur d'applications]/AppServer/bin.
6. Saisissez la commande suivante pour créer un nouveau fichier EAR contenant les EJB déployés : ejbDeploy.bat [répertoire de travail]/CAS_Adobe.ear
[répertoire temporaire]
[répertoire de destination]/CAS_websphere_deploy.ear
[répertoire de travail]
correspondant au répertoire de travail,
[répertoire temporaire]
au répertoire temporaire et
[répertoire de destination]
au répertoire de destination que vous avez créés.
Cette commande crée un nouveau fichier EAR nommé CAS_websphere_deploy.ear dans le répertoire
[répertoire de destination]
.
Remarque :
a l'issue de l'exécution de la commande, assurez-vous que son interpréteur de commandes n'indique aucune erreur. Un avertissement et un message d'information sont tolérés.
➤
Pour déployer le fichier EAR de BAM Server :
1. Lancez le serveur d'applications WebSphere et l'instance de serveur d'applications BAM créée à la
section « Création d'une instance de serveur d'applications », page 36 .
2. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Applications > Enterprise Applications.
3. Cliquez sur Install.
4. Spécifiez le chemin d'accès au fichier EAR de Business Activity Monitor et cliquez sur Next :
●
(Windows) Spécifiez le fichier EAR créé lors du prédéploiement du fichier EAR de BAM Server,
à savoir [répertoire de destination]/CAS_websphere_deploy.ear.
●
(Linux, UNIX) Spécifiez [racine LiveCycle]/components/bam/common/CAS_Adobe.ear.
Une première page de configuration s'affiche.
5. Sélectionnez Generate Default Bindings, puis cliquez sur Next.
6. Dans la zone Directory to Install Application, saisissez le chemin d'accès du répertoire côté serveur où vous souhaitez installer l'application, sélectionnez Deploy EJBs, puis cliquez sur Next.
7. Dans le menu Deploy EJBs Option - Database Type, sélectionnez le type de base de données que vous utilisez pour stocker les métadonnées BAM, puis cliquez sur Next :
●
(DB2) Sélectionnez
DB2UDB_V81
.
●
●
(SQL Server) Sélectionnez
MSSQLSERVER_2000
.
(Oracle) Sélectionnez
ORACLE_V9I
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 5.1.1.5 pour BAM Server
Déploiement de BAM Server sur WebSphere 152
8. Cliquez sur Step 6.
9. Sélectionnez les fichiers ejb-jar.xml et web.xml.
10. Sous Clusters and Servers, sélectionnez l'instance créée pour le serveur BAM, puis cliquez sur Apply.
Vérifiez que ces modules pointent maintenant vers l'instance de serveur BAM et cliquez sur Next.
11. Cliquez sur Step 8 pour afficher la page Summary.
12. Cliquez sur Finish.
➤
Pour déployer le fichier CQIntegration.ear :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Applications > Install New Application.
2. Cliquez sur Browse pour accéder au répertoire [racine LiveCycle]/components/bam/common, puis sélectionnez le fichier CQIntegration.ear. Vous n'avez pas besoin d'indiquer de valeur pour la racine de contexte.
3. Cliquez sur Next. Dans le premier écran, sélectionnez Generate Default Bindings, puis cliquez sur Next.
4. Dans l'écran Application Security Warnings, cliquez sur Continue.
5. Cliquez sur Step 2, puis, sous Listener Port for the BAM Integration EJB module, saisissez :
AdobeTemplateEventMDBTopicListener
6. Cliquez sur Step 4.
7. Sélectionnez les modules ejb-jar.xml et web.xml.
8. Sous Clusters and Servers, sélectionnez l'instance de serveur créée pour exécuter
LiveCycle Workflow Server, puis cliquez sur Apply. Vérifiez que ces modules pointent maintenant vers l'instance de serveur LiveCycle et cliquez sur Next.
9. Cliquez sur Finish.
10. Cliquez sur Save to Master Configuration, puis sur Save.
➤
Pour lancer CQIntegration.ear
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Applications > Enterprise Applications.
2. Sélectionnez BAM Integration et cliquez sur Start.
Etape suivante
Vous devez à présent configurer les propriétés BAM sur LiveCycle Workflow Server et BAM Server.
Reportez-vous à la section
« Prise en main de BAM Server », page 166 .
15
Configuration de WebSphere 6.0.2.9 pour BAM Server
Ce chapitre s'applique uniquement aux licences LiveCycle Workflow permettant d'utiliser
Business Activity Monitor.
Ce chapitre explique comment créer la base de métadonnées BAM, configurer BAM Server pour
WebSphere 6.0.2.9 et déployer l'application BAM Server. BAM Server est un composant de
LiveCycle Workflow.
Ce chapitre suppose que vous avez installé la base de données LiveCycle. Si ce n'est pas le cas,
reportez-vous à la section « Préparation de l'environnement », page 30 .
Création de la base de métadonnées BAM
Vous devez créer une base de métadonnées LiveCycle Workflow Business Activity Monitor pour enregistrer les définitions des métriques de processus que BAM Server surveille, ainsi que les détails relatifs aux alertes et aux données d'exécution d'objet enregistrées sur le disque.
Les métadonnées Business Activity Monitor pouvant représenter un volume important, vous devez attribuer au moins 50 Mo à la base de métadonnées BAM. Pour les déploiements de production, allouez au moins 200 Mo.
BAM Server peut nécessiter des paramètres spécifiques pour certains aspects de la configuration de la base de métadonnées Business Activity Monitor. Les paramètres dépendent du type de serveur d'applications hébergeant BAM Server et du type de serveur de base de données utilisé pour enregistrer les métadonnées Business Activity Monitor.
Comptes utilisateur
Vous devez également créer un compte utilisateur utilisable par BAM Server pour se connecter à la base de métadonnées Business Activity Monitor. Ce compte doit disposer de droits d'accès en création, en modification et en mise à jour sur la base de données.
Création de variables d'environnement pour DB2
Si vous utilisez DB2 comme base de métadonnées Business Activity Monitor, vous devez créer une variable d'environnement contenant le nom de l'instance DB2 associée. Vous devez également inclure le chemin d'accès aux bibliothèques partagées DB2 dans la variable de chemin d'accès à la bibliothèque.
Les exemples suivants illustrent les commandes permettant de configurer les variables d'environnement.
Utilisez les commandes correspondant à votre système d'exploitation. Vous devrez peut-être modifier la commande pour l'adapter à l'emplacement d'installation de DB2.
Exemple 15.1 Commandes de configuration des variables d'environnement sous Windows
Les commandes suivantes s'appliquent à une instance DB2 nommée DB2, les fichiers de bibliothèque DB2
étant installés dans C:\SQLLIB\BIN : set DB2INSTANCE=DB2 set PATH=C:\SQLLIB\BIN;%PATH%
153
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Configuration de WebSphere pour BAM Server 154
Exemple 15.2 Commandes de configuration des variables d'environnement sous Solaris
Les commandes suivantes s'appliquent à une instance DB2 nommée db2fs, les fichiers de bibliothèque
DB2 étant installés dans /opt/IBM/db2/V8.1/lib : export DB2INSTANCE=db2fs export LD_LIBRARY_PATH=/opt/IBM/db2/V8.1/lib:${LD_LIBRARY_PATH}
Exemple 15.3 Commandes de configuration des variables d'environnement sous AIX
Les commandes suivantes s'appliquent à une instance DB2 nommée db2fs, les fichiers de bibliothèque
DB2 étant installés dans /opt/IBM/db2/V8.1/lib : export DB2INSTANCE=db2fs export LIBPATH=/opt/IBM/db2/V8.1/lib:${LIBPATH}
Configuration de WebSphere pour BAM Server
Si vous installez LiveCycle Workflow tout en utilisant Business Activity Monitor, vous devez configurer manuellement WebSphere afin que BAM Server s'exécute correctement.
Vous devez exécuter les tâches suivantes :
●
●
●
●
Si ce n'est pas déjà fait, créez un serveur d'applications pour exécuter BAM Server. Reportez-vous à la
section « Création d'une instance de serveur d'applications », page 36 .
Installez les pilotes de base de données sur le serveur d'applications que vous avez créé pour
BAM Server. Reportez-vous à la section
« Installation des pilotes de base de données pour
.
Configurez la connexion à la base de métadonnées BAM. Reportez-vous à la section
« Configuration de la connexion à la base de métadonnées BAM », page 155 .
Installation des pilotes de base de données pour BAM Server
Pour permettre à WebSphere de se connecter à la base de métadonnées de BAM, vous devez installer les pilotes de base de données sur l'ordinateur sur lequel WebSphere est installé. Les pilotes Oracle et DB2 (le cas échéant) ont déjà été copiés dans le répertoire ${WAS_INSTALL_ROOT}/db_driver à l'étape
« Installation des pilotes de base de données », page 45
.
Vous devrez également supprimer le fichier ojdbc14.jar du répertoire [racine du serveur
d'applications]/appserver/lib du serveur d'applications WebSphere.
➤
Pour installer les pilotes de base de données pour SQL Server :
1. Accédez au répertoire ${WAS_INSTALL_ROOT}/db_driver.
2. Téléchargez le pilote SQL Server 2000 pour JDBC depuis le site Web suivant : www.microsoft.com/sql/downloads . Ce téléchargement installe les fichiers msbase.jar, mssqlserver.jar et msutil.jar requis.
Remarque :
il se peut que ces pilotes soient déjà installés sur l'ordinateur hébergeant la base de données. Reportez-vous à la section
« Installation des procédures stockées JTA », page 33 .
3. Copiez les fichiers mssqlserver.jar, msbase.jar et msutil.jar dans le répertoire ${WAS_INSTALL_ROOT}/db_driver.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Configuration de la connexion à la base de métadonnées BAM 155
Configuration de la connexion à la base de métadonnées BAM
Vous devez configurer une source de données pour la base de métadonnées BAM sur WebSphere de sorte que BAM Server puisse récupérer les informations sur les métriques de processus à contrôler :
●
(DB2) Créez un alias d'authentification JAAS pour la base de métadonnées BAM. Reportez-vous à la
.
●
●
Créez le pool de connexion JDBC. Reportez-vous à la section
« Création du fournisseur JDBC pour la base de métadonnées BAM », page 155 .
Créez la source de données. Reportez-vous à la section
« Création de la source de données pour la base de métadonnées BAM », page 156 .
Création d'un alias d'authentification JAAS pour la base de métadonnées
BAM sur DB2
Si vous stockez les métadonnées BAM dans une base de données DB2, vous devez créer un alias d'authentification JAAS pour un compte utilisateur ayant accès à la base de métadonnées BAM.
➤
Pour créer un alias d'authentification JAAS pour la base de métadonnées BAM sur DB2 :
1. Démarrez le serveur d'applications WebSphere.
2. Dans le panneau de navigation de la console d'administration WebSphere, sélectionnez Security >
Global Security > JAAS Configuration > J2C Authentication Data.
3. Sur la page J2C Authentication Data Entries, cliquez sur New.
4. Sur la page qui s'affiche, spécifiez les valeurs des propriétés suivantes, puis cliquez sur OK :
●
Alias : nom de l'alias. Saisissez
BAMDB2
●
●
●
User ID : nom d'utilisateur du compte utilisateur ayant accès à la base de métadonnées BAM sur DB2.
Password : mot de passe associé à l'ID utilisateur spécifié.
Description : (Facultatif ) description de l'alias.
Création du fournisseur JDBC pour la base de métadonnées BAM
Vous devez créer le fournisseur JDBC que vous utiliserez pour créer la connexion à la base de métadonnées
BAM.
➤
Pour créer le fournisseur JDBC :
1. Démarrez le serveur d'applications WebSphere.
2. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Resources > JDBC Providers.
3. Dans la zone des fournisseurs JDBC, sélectionnez la variable scope créée pour le serveur BAM, cliquez sur Apply, puis sur New.
4. Dans le menu JDBC Provider, sélectionnez le pilote de base de données correspondant au type de base de données que vous utilisez pour stocker les métadonnées BAM.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Configuration de la connexion à la base de métadonnées BAM 156
5. (Oracle) Sélectionnez les valeurs suivantes :
●
Oracle à l'étape 1
●
●
Oracle JDBC Driver à l'étape 2
Connection pool data source à l'étape 3
6. (DB2) Sélectionnez les valeurs suivantes :
●
DB2 à l'étape 1
●
●
DB2 Universal JDBC Driver Provider à l'étape 2
Connection pool data source à l'étape 3
7. (SQL Server) Sélectionnez les valeurs suivantes :
●
SQL Server à l'étape 1
●
●
WebSphere embedded ConnectJDBC driver for MS SQL Server à l'étape 2
Connection pool data source à l'étape 3
8. Cliquez sur Next, puis sur Apply.
9. Dans la zone Classpath, ajoutez les chemins d'accès aux fichiers à la suite des autres entrées de la zone, en fonction du type de base de données que vous utilisez pour stocker les métadonnées BAM. Si vous devez ajouter plusieurs chemins de classe, n'oubliez pas d'ajouter un retour chariot après chaque chemin d'accès :
●
Oracle :
{WAS_INSTALL_ROOT}/db_driver/ojdbc14.jar
●
●
DB2 :
{WAS_INSTALL_ROOT}/db_driver/db2jcc.jar
{WAS_INSTALL_ROOT}/db_driver/db2jcc_license_cu.jar
SQL Server :
{WAS_INSTALL_ROOT}/db_driver/mssqlserver.jar
{WAS_INSTALL_ROOT}/db_driver/msbase.jar
{WAS_INSTALL_ROOT}/db_driver/msutil.jar
Remarque :
veillez à ne pas supprimer les entrées existantes dans la zone Classpath.
10. Cliquez sur OK au bas de l'onglet.
11. Enregistrez les modifications apportées à la configuration principale.
Création de la source de données pour la base de métadonnées BAM
Vous devez créer une source de données pour permettre à BAM Server de se connecter à la base de métadonnées BAM.
➤
Pour créer la source de données pour la base de métadonnées BAM :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Resources > JDBC Providers.
2. Cliquez sur le fournisseur JDBC que vous avez créé pour la base de métadonnées BAM.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Configuration de la connexion à la base de métadonnées BAM 157
3. Dans le tableau Additional Properties, sélectionnez Data Sources.
4. Cliquez sur New et spécifiez les valeurs suivantes pour les propriétés :
●
Name :
com.celequest.metadata.metaDatasource
●
JNDI Name :
jdbc/com.celequest.metadata.metaDatasource
●
●
●
Container managed persistence : sélectionnez cette option
Datasource Helper Class Name : (Oracle 10g uniquement) com.ibm.websphere.rsadapter.Oracle10gDataStoreHelper
Container-managed Authentication Alias : (DB2)
BAMDB2
5. (Oracle) Cliquez sur URL, saisissez la valeur suivante pour la propriété URL, puis cliquez sur Apply : jdbc:oracle:thin:@[nomhôte]:[port]:[nom DB BAM]
[nomhôte]
correspondant au nom de l'ordinateur sur lequel Oracle est exécuté,
[port]
au port utilisé pour accéder à la base de données Oracle et
[nom DB BAM]
au nom de la base de données
Oracle.
6. (Oracle) Sous Related Items, sélectionnez J2EE Connector Architecture (J2C) authentication data
entries.
7. (Oracle) Cliquez sur New, puis tapez un nom (par exemple, MyAlias) dans la zone
Alias
.
8. (Oracle) Entrez le compte utilisateur [admin DB BAM] et le mot de passe connexe, puis cliquez sur Apply et sur OK.
9. (SQL Server, DB2) Spécifiez les valeurs des propriétés ci-après suivant le type de base de données utilisé pour stocker les métadonnées BAM :
●
DB2 :
serverName : nom de l'ordinateur ou adresse IP de l'ordinateur hébergeant DB2.
portNumber : port utilisé pour accéder à DB2. La valeur par défaut est de 50000.
●
databaseName : [nom DB BAM] (voir
« Configuration de WebSphere pour BAM Server », page 154
.)
SQL Server :
serverName : nom d'hôte ou adresse IP de l'ordinateur exécutant la base de données
portNumber : port utilisé pour accéder à SQL Server. La valeur par défaut est de 1433.
databaseName : [nom DB BAM] (voir
« Configuration de WebSphere pour BAM Server », page 154
.)
10. Cliquez sur Apply, puis sous Additional Properties, cliquez sur Custom Properties.
11. Sur la page Custom Properties, cliquez sur New, spécifiez les valeurs des propriétés suivantes, puis cliquez sur OK :
●
Name :
user
(cette propriété est sensible à la casse et n'accepte que des minuscules)
●
●
Value : nom d'utilisateur du compte utilisateur ayant accès à la base de métadonnées BAM. Pour
SQL Server et DB2, le nom d'utilisateur doit être [nom DB BAM]. Reportez-vous à la section
« Configuration de WebSphere pour BAM Server », page 154
.
Description : (Facultatif ) description de la propriété.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Création de la source de données d'intégration 158
12. Sur la page Custom Properties, cliquez sur New, spécifiez les valeurs des propriétés suivantes, puis cliquez sur OK :
●
●
Name :
password
(cette propriété est sensible à la casse et n'accepte que des minuscules)
Value : mot de passe du compte utilisateur ayant accès à la base de métadonnées BAM.
●
Description : (Facultatif ) description de la propriété.
13. Enregistrez les modifications apportées à la configuration principale.
Test de la connexion à la base de données
Vous devez tester la configuration du fournisseur JDBC à l'aide de la fonction de test de la connexion de
WebSphere.
➤
Pour tester la connexion à la base de données :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez JDBC
Providers > [Fournisseur] > Data Sources.
2. Sélectionnez le fournisseur com.celequest.metadata.metaDatasource.
3. Cliquez sur Test Connection.
La zone Message située en haut de la page affiche les résultats du test. Si le test échoue, utilisez les fonctions de génération de rapports d'erreurs de WebSphere pour identifier l'origine du problème.
Création de la source de données d'intégration
Vous devez créer une source de données pour permettre à de se connecter à la base de données LiveCycle.
➤
Pour créer la source de données pour la base de données LiveCycle :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Resources > JDBC Providers.
2. Cliquez sur le fournisseur JDBC que vous avez créé pour la base de métadonnées BAM.
3. Sous Additional Properties, sélectionnez Data Sources.
4. Cliquez sur New, spécifiez les valeurs suivantes pour les propriétés, puis cliquez sur OK :
●
●
●
●
Name : com.celequest.adobe
JNDI Name : jdbc/com.celequest.adobe
Container managed persistence : sélectionnez cette option
Datasource Helper Class Name : (Oracle 10g uniquement) com.ibm.websphere.rsadapter.Oracle10gDataStoreHelper
5. (Oracle) Cliquez sur URL, saisissez la valeur suivante pour la propriété URL, puis cliquez sur Apply : jdbc:oracle:thin:@[hôte]:[port]:[base de données]
[hôte]
correspondant au nom de l'ordinateur sur lequel Oracle est exécuté,
[port]
au port utilisé pour accéder à la base de données Oracle et
[base de données]
au nom de la base de données
LiveCycle.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Création de la source de données d'intégration 159
6. (DB2) Spécifiez les valeurs des propriétés suivantes et cliquez sur Apply :
●
serverName : nom de l'ordinateur ou adresse IP de l'ordinateur hébergeant DB2.
●
●
portNumber : port utilisé pour accéder à DB2. La valeur par défaut est de 50000.
databaseName : nom de la base de données LiveCycle.
7. (SQL Server) Spécifiez les valeurs des propriétés suivantes et cliquez sur Apply :
●
serverName : nom d'hôte ou adresse IP de l'ordinateur exécutant la base de données
●
●
portNumber : port utilisé pour accéder à SQL Server. La valeur par défaut est de 1433.
databaseName : nom de la base de données LiveCycle.
8. Sous Related Items, sélectionnez J2EE Connector Architecture (J2C) authentication data entries.
9. Cliquez sur New, puis tapez un nom (par exemple, MyAliasLiveCycle) dans la zone
Alias
.
10. (Oracle) Entrez le compte utilisateur [admin DB LiveCycle] et le mot de passe connexe, puis cliquez sur
Apply et sur OK.
11. Enregistrez les modifications apportées à la configuration principale.
12. Revenez à JDBC Providers > [base de métadonnées BAM] > Data Sources et sélectionnez
com.celequest.adobe.
13. Dans la zone Component-managed Authentication Alias, sélectionnez l'alias d'authentification pointé vers la base de données Adobe LiveCycle (MyAliasLiveCycle), puis cliquez sur OK.
14. Enregistrez les modifications apportées à la configuration principale.
Test de la connexion à la base de données d'intégration
Vous devez tester la configuration du fournisseur JDBC à l'aide de la fonction de test de la connexion de
WebSphere.
➤
Pour tester la connexion à la base de données :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez JDBC
Providers > [Fournisseur] > Data Sources.
2. Sélectionnez com.celequest.adobe.
3. Cliquez sur Test Connection.
La zone Message située en haut de la page affiche les résultats du test. Si le test échoue, utilisez les fonctions de génération de rapports d'erreurs de WebSphere pour identifier l'origine du problème.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Configuration des paramètres de WebSphere 160
Configuration des paramètres de WebSphere
Vous devez configurer plusieurs paramètres de serveur dans WebSphere pour assurer la prise en charge de
BAM Server.
➤
Pour définir les paramètres du serveur d'applications :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez Servers >
Application Servers, puis cliquez sur le nom du serveur d'applications sur lequel vous allez déployer
BAM Server.
2. Cliquez sur l'onglet Configuration, puis sous Server Infrastructure, développez Java and Process
Management et cliquez sur Process Definition.
3. Sur la page Process Definition, sous Additional Properties, cliquez sur Java Virtual Machine.
4. Sur la page de configuration de la machine virtuelle Java, renseignez les zones Initial Heap et
Maximum Heap.
Ces paramètres dépendent des possibilités de votre système. Vous devez leur attribuer la valeur la plus
élevée possible. Il est recommandé de spécifier des valeurs au moins égales à 128 et 512.
5. Ajoutez le texte suivant dans la zone Generic JVM Arguments pour prendre en charge UTF-8 :
-Dfile.encoding=utf8
6. Cliquez sur Apply.
7. Sous Additional Properties, cliquez sur Custom Properties, puis sur New et spécifiez les valeurs appropriées pour la propriété suivante :
●
Name :
com.celequest.metadata.jdbcDriver.
●
Value : spécifiez l'une des valeurs suivantes, en fonction du type de base de données utilisé pour stocker les métadonnées BAM :
●
(Oracle) oracle.jdbc.driver.OracleDriver
●
●
(SQL Server) com.microsoft.jdbc.sqlserver.SQLServerDriver
(DB2) com.ibm.db2,jcc.DB2Driver
8. Cliquez sur OK pour appliquer les modifications et revenir à la page Custom Properties.
9. Cliquez sur New pour créer la propriété com.celequest.metadata.jdbcURL, puis attribuez un nom et une valeur à la propriété personnalisée :
●
Name :
com.celequest.metadata.jdbcURL.
●
Value : spécifiez l'une des valeurs suivantes, en fonction du type de base de données utilisé pour stocker les métadonnées BAM :
●
DB2 : jdbc: db2://[nomhôte]:[port]/[nom DB BAM]:user=[nomutilisateur];password=
[mot de passe];
[nomhôte]
correspondant au nom de l'ordinateur sur lequel DB2 est exécuté,
[port]
au port utilisé pour accéder à la base de données DB2 représentée par
[nom DB BAM]
dans l'adresse,
[nomutilisateur]
au nom du compte utilisateur utilisé pour accéder à la base de données et
[
mot
de passe] au mot de passe du nom d'utilisateur spécifié pour le paramètre
[nomutilisateur]
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Paramètres JVM WebSphere facultatifs 161
●
SQL Server : jdbc:microsoft:sqlserver://[nomhôte]:[port];databaseName=
[nom DB BAM] ;
;selectMethod=Cursor;user=[admin DB BAM];password=[mot de passe] ;
[nomhôte]
correspondant au nom de l'ordinateur sur lequel SQL Server est exécuté,
[port]
au port utilisé pour accéder à la base de données SQL Server et
[motdepasse
] au mot de passe du compte d'utilisateur [admin DB BAM].
●
Oracle : jdbc:oracle:thin:[admin DB BAM]/[mot de passe]@[nomhôte]:[port]:
[nom DB BAM] ;
[mot de passe]
correspondant au mot de passe associé au nom du compte utilisateur spécifié pour l'utilisateur de base de données [admin DB BAM],
[nomhôte]
au nom de l'ordinateur sur lequel Oracle est exécuté et
[port]
au port utilisé pour accéder à la base de données Oracle représentée par
[nom DB BAM]
dans l'adresse.
Ces valeurs doivent correspondre à l'URL Oracle spécifiée dans la source de données de la base de métadonnées BAM. Reportez-vous à la section
« Création de la source de données pour la base de métadonnées BAM », page 156
.
10. (Facultatif ) Cliquez sur New pour créer une nouvelle propriété pour spécifier les propriétés JVM facultatives associées à la base de métadonnées BAM, puis saisissez le nom et la valeur de la propriété personnalisée :
●
Name : saisissez le nom de la propriété au format suivant : com.celequest.property.[PARAMETRE]
●
Value : saisissez la valeur de la propriété.
Pour plus de détails sur les noms et valeurs des propriétés JVM facultatives, reportez-vous à la section
« Paramètres JVM WebSphere facultatifs », page 161 .
pour chaque propriété JVM facultative que vous souhaitez spécifier.
12. Cliquez sur OK et enregistrez les modifications apportées à la configuration principale.
13. Revenez à la page principale du serveur en cliquant sur son nom en haut de la page. Sous Container
Settings, développez Container Services, puis cliquez sur Transaction Service.
14. Sur la page Transaction Service, tapez
600
dans la zone Total transaction lifetime timeout.
15. Cliquez sur OK pour revenir à la page Custom Properties.
16. Enregistrez les modifications apportées à la configuration principale.
17. Redémarrez WebSphere.
Paramètres JVM WebSphere facultatifs
Vous pouvez configurer plusieurs paramètres JVM facultatifs associés à la base de métadonnées Business
Activity Monitor, notamment la langue, le pays et le niveau d'assemblage. Ces paramètres JVM sont exprimés parles propriétés personnalisées de la machine virtuelle Java. Les propriétés personnalisées possèdent les attributs suivants :
●
Nom : com.celequest.property.[PARAMETRE]
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Déploiement de BAM Server sur WebSphere 162
●
Valeur :
[VALEUR]
Ce tableau fournit les valeurs valides de
[PARAMETRE]
et
[VALEUR]
.
Paramètre Description
LANGUAGE
Code ISO pour la langue du serveur.
Par exemple, pour définir la langue sur le portugais, la propriété personnalisée com.celequest.property.LANGUAGE
doit avoir la valeur
PT
.
COUNTRY
LOCALESORT
STRENGTH
DECOMPOSITION
Code ISO pour le pays du serveur.
Cette option permet d'indiquer si les chaînes sensibles aux paramètres locaux ont
été comparées. Les valeurs valides sont true
et false
:
●
Indiquez true
si vous souhaitez comparer les chaînes sensibles aux paramètres locaux.
●
Indiquez false
si vous ne souhaitez pas comparer les chaînes sensibles aux paramètres locaux.
La valeur par défaut est false
.
Niveau de force d'assemblage correspondant au degré selon lequel les caractères non anglais sont comparés et assemblés.
Les valeurs valides (de la moins sélective à la plus sélective) sont les suivantes : primary
, secondary
, tertiary
et identical
. La valeur par défaut est tertiary
.
Pour plus d'informations sur les paramètres d'assemblage, consultez la documentation de Sun Java à l'adresse suivante : http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html
.
Remarque :
ce paramètre n'est opérationnel que si
LOCALESORT
est défini sur true
.
Mode de décomposition de l'assemblage. Les valeurs valides sont none
, canonical
et full
. La valeur par défaut est canonical
.
Pour plus d'informations sur les paramètres d'assemblage, consultez la documentation de Sun Java à l'adresse suivante : http://java.sun.com/j2se/1.4,2/docs/api/java/util/Locale.html
Remarque :
ce paramètre n'est opérationnel que si
LOCALESORT
est défini sur true
.
Déploiement de BAM Server sur WebSphere
Vous devez déployer le fichier EAR de BAM Server (CAS_Adobe.ear) sur le serveur d'applications configuré pour exécuter BAM Server. Vous devez également déployer le fichier EAR d'intégration de BAM Server
(CQIntegration.ear) sur le serveur d'applications configuré pour exécuter LiveCycle Workflow Server.
Pour éviter les problèmes de déploiement sous Windows, vous devez prédéployer le fichier EAR de BAM
Server. Avant d'exécuter la procédure suivante, vérifiez que les installations précédentes de BAM Server sont arrêtées et désinstallées, et que le serveur d'applications WebSphere n'est pas en cours d'exécution.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Déploiement de BAM Server sur WebSphere 163
➤
(Windows) Pour prédéployer le fichier EAR de BAM Server :
1. Créez un répertoire de travail, par exemple c:\wrk.
2. Créez un répertoire temporaire, par exemple c:\tmp.
3. Créez un répertoire de destination, par exemple c:\bam.
4. Copiez le fichier CAS_Adobe.ear du répertoire [racine LiveCycle]/components/bam/common dans le répertoire de travail que vous avez créé.
5. Ouvrez une invite de commande et remplacez le répertoire de travail actuel par le répertoire [racine du
serveur d'applications]/AppServer/bin.
6. Saisissez la commande suivante pour créer un nouveau fichier EAR contenant les EJB déployés : ejbDeploy.bat [répertoire de travail]/CAS_Adobe.ear [répertoire temporaire]
[répertoire de destination]/CAS_websphere_deploy.ear
[répertoire de travail]
correspondant au répertoire de travail,
[répertoire temporaire]
au répertoire temporaire et
[répertoire de destination]
au répertoire de destination que vous avez créés.
Cette commande crée un nouveau fichier EAR nommé CAS_websphere_deploy.ear dans le répertoire
[répertoire de destination]
.
Remarque :
a l'issue de l'exécution de la commande, assurez-vous que son interpréteur de commandes n'indique aucune erreur. Un avertissement et un message d'information sont tolérés.
➤
Pour déployer le fichier EAR de BAM Server :
1. Lancez le serveur d'applications WebSphere et l'instance de serveur d'applications BAM créée à la
section « Création d'une instance de serveur d'applications », page 36 .
2. Dans l'arborescence de navigation, sélectionnez Applications > Install New Application.
3. Cliquez sur Browse pour parcourir le répertoire [racine du serveur d'applications]/InstallableApps, spécifiez le chemin au fichier EAR de Business Activity Monitor, puis cliquez sur Next :
●
●
(Windows) Spécifiez le fichier EAR créé lors du prédéploiement du fichier EAR de BAM Server,
à savoir [répertoire de destination]/CAS_websphere_deploy.ear.
(Linux, UNIX) Spécifiez [racine LiveCycle]/components/bam/common/CAS_Adobe.ear.
4. Sélectionnez Generate Default Bindings, puis cliquez sur Next.
5. Dans la zone Directory to Install Application, saisissez le chemin d'accès du répertoire côté serveur où vous souhaitez installer l'application, puis cliquez sur Next.
6. Dans Map modules to servers :
●
Sélectionnez les fichiers ejb-jar.xml et web.xml.
●
Sous Clusters and Servers, sélectionnez l'instance de serveur créée pour exécuter
LiveCycle Workflow Server, puis cliquez sur Apply. Vérifiez que ces modules pointent maintenant vers l'instance de serveur BAM et cliquez sur Next.
7. Dans le menu Deploy EJBs Option - Database Type, sélectionnez le type de base de données que vous utilisez pour stocker les métadonnées BAM, puis cliquez sur Next :
●
(DB2) Sélectionnez
DB2UDB_V81
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Déploiement de BAM Server sur WebSphere 164
●
●
(SQL Server) Sélectionnez
MSSQLSERVER_2000
.
(Oracle) Sélectionnez
ORACLE_V9I
.
Remarque :
(Windows) l'étape Deploy EJBs Option - Database Type n'apparaît pas durant l'installation.
8. Dans l'écran Provide JNDI Names for Beans, vérifiez que la zone JNDI est configurée pour être pré-remplie à l'aide de ejb/PublishRowSession
et cliquez sur Next.
9. Acceptez les valeurs par défaut en cliquant sur Next jusqu'à ce que la page Summary apparaisse, puis cliquez sur Finish.
Remarque :
(Websphere 6.0.2.9) vous pouvez recevoir un message Resource Warning que vous pouvez ignorer
10. Enregistrez les modifications apportées à la configuration principale.
11. Redémarrez le serveur BAM.
Avant de configurer les spécification d'activation de JMS et de déployer CQIntegration.ear sur WebSphere, vous devez revenir au serveur d'applications que vous avez configuré pour exécuter LiveCycle Workflow.
➤
Pour définir les spécifications d'activation de JMS :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, cliquez sur Resources >
JMS Providers > Default messaging.
2. Sous Scope, sélectionnez Server, puis cliquez sur Apply.
3. Sous Activation Specifications, cliquez sur JMS activation specification.
4. Cliquez sur New, spécifiez les valeurs suivantes, puis cliquez sur OK :
Sous Administration, spécifiez :
Name :
Template_Event_AS
JNDI Name :
Template_Event_AS
Sous Destination, spécifiez :
Destination Type :
Topic
Destination JNDI name : topic/adobe_TemplateEventTopic
.
Bus name : sélectionnez IDP_JMS_BUS
Sous Additional, spécifiez :
Maximum bath size :
1
Maximum concurrent endpoints :
10
5. Cliquez sur OK.
6. Cliquez sur Save to Master Configuration, puis sur Save.
➤
Pour déployer le fichier CQIntegration.ear :
1. Dans l'arborescence de navigation de la console d'administration WebSphere, sélectionnez
Applications > Install New Application.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Configuration de WebSphere 6.0.2.9 pour BAM Server
Déploiement de BAM Server sur WebSphere 165
2. Cliquez sur Browse pour accéder au répertoire [racine LiveCycle]/components/bam/common, puis sélectionnez le fichier CQIntegration.ear. Vous n'avez pas besoin d'indiquer de valeur pour la racine de contexte.
3. Cliquez sur Next. Dans le premier écran, sélectionnez Generate Default Bindings, puis cliquez sur Next.
4. Dans l'écran Application Security Warnings, cliquez sur Continue.
5. Cliquez sur Step 2 : Map modules to servers:
●
Sélectionnez les fichiers ejb-jar.xml et web.xml.
●
Sous Clusters and Servers, sélectionnez l'instance de serveur créée pour exécuter
LiveCycle Workflow Server, puis cliquez sur Apply. Vérifiez que ces modules pointent maintenant vers l'instance de serveur BAM et cliquez sur Next.
6. Cliquez sur Step 3: Provide listener bindings for message-driven beans, puis sous Bindings :
● sélectionnez Activation Specification.
●
Dans la zone JNDI name, entrez le nom de l'événement associé au sujet servant d'exemple
d'événements spécifié à l'étape 4
sur la définition des, spécifications d'activation de JMS. Par exemple, saisissez
Template_Event_AS
.
7. Cliquez sur Step 5: Summary, puis cliquez sur Finish.
8. Cliquez sur Save to Master Configuration, puis sur Save.
Etape suivante
Vous devez à présent configurer les propriétés BAM sur LiveCycle Workflow Server et BAM Server.
Reportez-vous à la section
« Prise en main de BAM Server », page 166 .
16
Prise en main de BAM Server
Ce chapitre explique comment exécuter la configuration initiale de LiveCycle Workflow Server pour permettre à BAM Server de surveiller l'activité d'un processus. Vous devez configurer les paramètres de
LiveCycle Workflow Server et BAM Server :
●
●
« Configuration de LiveCycle Workflow Server pour BAM Server », page 166
« Configuration de BAM Server », page 167
Configuration de LiveCycle Workflow Server pour BAM Server
Vous pouvez configurer LiveCycle Workflow pour vous connecter à BAM Server à l'aide de Administrator.
Vous devez indiquer le serveur sur lequel BAM Server est exécuté et les informations relatives au compte utilisateur utilisé pour accéder à BAM Server.
➤
Pour configurer LiveCycle Workflow Server pour BAM Server :
1. Connectez-vous à Administrator. Reportez-vous à la section
« Accès à Administrator », page 67 .
2. Cliquez sur Services, puis sur Adobe LiveCycle Workflow.
3. Cliquez sur Paramètres du serveur, puis sur Paramètres de configuration BAM.
4. Spécifiez les valeurs des propriétés suivantes :
●
Hôte : nom d'hôte ou adresse IP du serveur sur lequel BAM Server est exécuté. La valeur par défaut est localhost
.
●
●
Port : port de service du serveur d'applications sur lequel BAM Server est exécuté. (Pour WebSphere
5.1.1.5, saisissez
9091
(reportez-vous à la section
« Création d'un alias d'hôte virtuel », page 150 ).
Pour WebSphere 6.0.2.9, vous trouverez la valeur du port en cliquant sur Servers > Application
Servers > [BAM Server] > Ports).
Nom d'utilisateur : (facultatif ) nom du compte utilisateur de l'administrateur que LiveCycle Workflow
Server utilise pour accéder à BAM Server. Le nom d'utilisateur par défaut est system
.
Remarque :
si vous spécifiez le nom d'utilisateur d'un autre compte utilisateur, vous devez vous assurer que l'utilisateur possède des droits d'administration complets pour BAM Server.
Pour plus de détails sur l'administration des comptes utilisateur de BAM, consultez l'aide
de BAM Workbench ou le guide Using LiveCycle Workflow Workbench.
●
Mot de passe : (facultatif ) mot de passe valide du nom d'utilisateur spécifié ci-dessus. Le mot de passe par défaut est manager
.
5. Cliquez sur Enregistrer et redémarrez LiveCycle.ear.
166
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Accès à BAM Workbench et à BAM Dashboard 167
Accès à BAM Workbench et à BAM Dashboard
Une fois BAM Server déployé et exécuté sur le serveur d'applications, vous pouvez accéder à
BAM Workbench et à Business Activity Monitor (BAM) Dashboard par l'intermédiaire d'un navigateur Web.
BAM Workbench comprend des outils d'administration de BAM Server et de configuration de rapports que les utilisateurs consultent dans BAM Dashboard.
Pour vous connecter aux pages de Business Activity Monitor, vous devez saisir un nom d'utilisateur et un mot de passe. Lorsque vous déployez BAM Server, un compte d'administration par défaut est créé ; le nom d'utilisateur system et le mot de passe manager lui sont attribué.
Conseil :
vous pouvez créer un autre utilisateur d'administration ou modifier l'utilisateur existant à l'aide de BAM Workbench. Si vous modifiez l'utilisateur existant, vous devez adapter les propriétés correspondantes sur LiveCycle Workflow Server. Reportez-vous à la section
LiveCycle Workflow Server pour BAM Server », page 166 .
Pour plus de détails sur l'utilisation des outils fournis avec la structure d'administration, connectez-vous
à BAM Workbench et consultez l'aide.
➤
Pour accéder à BAM Workbench :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Dans le champ User Name, saisissez un nom d'utilisateur valide, puis renseignez le champ Password avec le mot de passe correspondant. Vous pouvez utiliser le nom d'utilisateur et le mot de passe par défaut, soit respectivement system
et manager
.
➤
Pour accéder à BAM Dashboard :
1. Démarrez BAM Dashboard en saisissant http://[nomhôte]:[port]/celequest/dashboard dans la ligne d'adresse d'un navigateur Web.
2. Dans le champ User Name, saisissez un nom d'utilisateur valide, puis renseignez le champ Password avec le mot de passe correspondant. Vous pouvez utiliser le nom d'utilisateur et le mot de passe par défaut, soit respectivement system
et manager
.
Configuration de BAM Server
Vous pouvez configurer BAM Server pour la surveillance des processus de LiveCycle Workflow à l'aide de
BAM Workbench. Reportez-vous à la section « Accès à BAM Workbench et à BAM Dashboard », page 167 .
Vous devez utiliser BAM Workbench pour exécuter les tâches suivantes :
● configurer les paramètres du serveur SMTP pour l'envoi de courriers électroniques ;
● modifier l'agent JDBC par défaut pour qu'il soit basé sur une URL ;
●
● importer les définitions des métadonnées utilisées pour surveiller les processus de LiveCycle Workflow ; configurer les paramètres du serveur LDAP pour BAM Server.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Configuration des paramètres SMTP 168
Configuration des paramètres SMTP
BAM Server utilise un serveur SMTP pour envoyer des courriers électroniques aux utilisateurs de
Business Activity Monitor. Vous devez indiquer le serveur sur lequel le serveur SMTP est exécuté ainsi que les informations relatives au compte utilisateur avec lequel BAM Server peut accéder au serveur SMTP.
➤
Pour configurer les paramètres SMTP :
1. Vérifiez que LiveCycle Workflow Server et les applications BAM Server sont en cours d'exécution.
2. Vérifiez que la base de métadonnées BAM est lancée.
3. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
4. Ouvrez une session à l'aide du nom d'utilisateur et du mot de passe configurés pour administrer
Business Activity Monitor. Vous pouvez utiliser le nom d'utilisateur et le mot de passe par défaut, soit respectivement system
et manager
.
5. Si vous vous connectez pour la première fois à BAM Workbench, la boîte de dialogue First Time Setup apparaît. Le cas échéant, cliquez sur Open System Settings, puis sur l'onglet SMTP Configuration.
6. Spécifiez les valeurs des propriétés suivantes :
●
SMTP Host : nom du réseau ou adresse IP du serveur SMTP que BAM Server utilise pour envoyer des messages électroniques.
●
●
●
SMTP From Address : adresse électronique que BAM Server utilise pour recevoir des messages
électroniques.
SMTP User : nom d'utilisateur du compte de messagerie que BAM Server utilise.
SMTP Password : mot de passe de l'utilisateur SMTP.
7. Sélectionnez l'onglet Checkpoint Configuration, puis indiquez l'emplacement du répertoire des journaux de récupération dans le champ Recovery Log Directory.
8. Sélectionnez l'onglet Logging, puis indiquez l'emplacement du répertoire de consignation dans le champ Logging Directory.
9. Cliquez sur OK.
Importation des définitions de métadonnées de LiveCycle Workflow
Vous devez importer les définitions de métadonnées de LiveCycle Workflow pour configurer les métriques de processus contrôlées par BAM Server.
➤
Pour importer les définitions de métadonnées de LiveCycle Workflow :
1. Vérifiez que LiveCycle Workflow Server et les applications BAM Server sont lancés.
2. Vérifiez que la base de métadonnées BAM est lancée.
3. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
4. Cliquez sur l'onglet Administration Console, puis sur Import/Export.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 169
5. Sélectionnez Import Metadata from a JAR file (upload) et saisissez le chemin d'accès complet à l'emplacement du modèle de métadonnées de LiveCycle Workflow BAM adapté au type de base de données utilisé pour la base de données LiveCycle :
●
●
●
(SQL Server) adobeimport_SQLServer.jar
(Oracle) adobeimport_Oracle.jar
(DB2) adobeimport_DB2.jar
Ces fichiers figurent dans le répertoire [racine LiveCycle]/Workflow/bam/BAMAppTemplate.
6. Cliquez sur OK.
Configuration des paramètres LDAP pour BAM Server
Outre la création manuelle d'utilisateurs et de leurs autorisations, Business Activity Monitor vous permet d'importer les informations relatives aux utilisateurs à partir des fournisseurs LDAP pris en charge. Vous pouvez planifier des synchronisations automatiques ou exécuter des synchronisations manuelles avec le serveur LDAP pour mettre automatiquement à jour les utilisateurs et les rôles existants.
Lors de la synchronisation avec le serveur LDAP, le DN de base de l'utilisateur, l'identification et le mot de passe de connexion, le nom complet, la description et les propriétés de l'adresse électronique sont mis en cache dans la base de métadonnées BAM.
Lorsque BAM Server importe des utilisateurs à partir du serveur LDAP, les groupes LDAP sont convertis en rôles Business Activity Monitor. Les rôles sont attribués aux utilisateurs en fonction du groupe auquel ils appartiennent dans LDAP. Pour plus de détails, reportez-vous à la section
« Restrictions de la connectivité
LDAP de BAM Server », page 169
.
Remarque :
BAM Server s'intègre à tous les fournisseurs LDAP prenant en charge le protocole LDAP version 3.
Restrictions de la connectivité LDAP de BAM Server
Les restrictions suivantes s'appliquent à la connectivité de BAM Server avec le serveur LDAP :
●
Vous pouvez configurer une connexion vers un seul serveur LDAP.
●
BAM Server crée des rôles suivant les groupes définis sur le serveur LDAP. Lorsque BAM Server rencontre un groupe dont le rôle n'a pas encore été créé, il le crée et lui attribue un ensemble d'autorisations nulles. Vous pouvez modifier ultérieurement les autorisations selon vos besoins.
Reportez-vous à la section « Configuration du mappage du rôle LDAP », page 172
.
●
●
Si BAM Server importe un utilisateur qui n'appartient pas à un groupe auquel un rôle Business Activity
Monitor correspond, l'utilisateur est créé mais aucun rôle ne lui est attribué.
Vous ne pouvez pas modifier le rôle attribué à un utilisateur si ce dernier est importé du serveur LDAP.
Vous pouvez attribuer des rôles aux utilisateurs importés en apportant des modifications au serveur LDAP. Vous pouvez, cependant, affecter des utilisateurs créés manuellement aux rôles créés en fonction des groupes LDAP.
Pratiques conseillées pour la connectivité LDAP de BAM Server
Lors de la configuration de la connectivité de BAM Server avec le serveur LDAP, nous vous recommandons fortement de respecter les meilleures pratiques suivantes :
●
Si la connexion au serveur LDAP n'est pas sécurisée, utilisez le protocole SSL.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 170
●
●
Pour l'authentification, Simple Authentication and Security Layer (SASL) constitue la méthode recommandée. En outre, elle est bien prise en charge par LDAP.
Pour des raisons de sécurité, les autorisations d'accès de l'utilisateur de la synchronisation LDAP doivent être limitées à l'interrogation du serveur LDAP. Pour plus de détails sur l'utilisateur de la
.
Attention :
le mot de passe de cet utilisateur est enregistré dans les métadonnées de BAM Server au moyen d'un cryptage symétrique réversible. Par conséquent, toute personne ayant accès aux métadonnées peut obtenir ce mot de passe.
Configuration de la synchronisation LDAP automatique
Vous pouvez planifier la synchronisation automatique de BAM Server à l'aide du serveur LDAP. La synchronisation garantit que les comptes utilisateur et les définitions de rôle que BAM Server enregistre dans la base de métadonnées BAM sont mises à jour avec le contenu du serveur LDAP.
Pendant la synchronisation, BAM Server crée de nouveaux rôles en fonction des nouveaux groupes présents sur le serveur LDAP et supprime les rôles existants en fonction des groupes supprimés du serveur
LDAP depuis la précédente synchronisation.
Remarque :
les rôles sont supprimés même si des utilisateurs créés manuellement leur sont affectés. Pour ces utilisateurs, si les rôles sont supprimés du fait de la synchronisation, les comptes utilisateur continuent d'exister mais ne sont plus affectés aux rôles.
➤
Pour configurer la synchronisation LDAP automatique :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP Synchronization.
4. Sélectionnez l'option LDAP Enabled, si elle n'est pas déjà cochée.
5. Spécifiez les valeurs des propriétés suivantes :
●
●
●
●
●
Initial Context Factory : nom JNDI par l'intermédiaire duquel BAM Server se connecte au serveur LDAP. La valeur par défaut est com.sun.jndi.ldap.LdapCtxFactory
. Il n'est probablement pas nécessaire de modifier cette valeur.
LDAP Server : nom DNS ou adresse IP du serveur LDAP.
LDAP Port : port sur lequel le serveur LDAP fonctionne. Il s'agit généralement du port 389.
Toutefois, si vous sélectionnez l'option SSL, le port par défaut est habituellement le port 636.
Vous devez vérifier auprès de votre administrateur LDAP le numéro de port à utiliser..
LDAP SSL : sélectionnez cette option si le serveur LDAP est configuré pour utiliser SSL. La sélection de cette option peut avoir un impact sur le paramètre Port LDAP.
LDAP Authentication : méthode d'authentification utilisée par le serveur LDAP. Sélectionnez l'une des options suivantes :
●
Simple
●
●
SASL (Simple Authentication and Security Layer). Sélectionnez cette option pour Sun ONE.
Compare Encrypted Password
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 171
●
●
●
●
LDAP Principal DN Prefix : dans le cadre de la méthode d'authentification simple, le texte que vous indiqué est inséré avant le nom de connexion de l'utilisateur :
●
●
Pour les serveurs LDAP requérant une connexion DN, définissez cette option sur la valeur de propriété appropriée suivi du signe = (par exemple, cn=
ou uid=
).
Pour ActiveDirectory, n'indiquez aucune valeur.
LDAP Principal DN Suffix : dans le cadre de la méthode d'authentification simple, le texte que vous indiquez est inséré après le nom de connexion de l'utilisateur :
●
Pour les serveurs LDAP requérant une connexion DN, définissez cette option sur la chaîne de valeurs appropriée. Le premier caractère du suffixe doit être une virgule (« , »). Par exemple :
,ou=Users,dc=domain,dc=name
●
Pour ActiveDirectory, qui requiert une connexion simple avec une adresse électronique, définissez cette option sur le symbole
@
suivi du nom de domaine utilisé pour ActiveDirectory.
LDAP Synchronization User : utilisateur qui se connecte au serveur et lit les listes d'utilisateurs et de rôles. Par mesure de sécurité, vous devez spécifier un compte utilisateur qui ne peut que lire le répertoire LDAP.
LDAP Synchronization Password : mot de passe associé à l'utilisateur spécifié pour l'option LDAP
Synchronization User.
6. Cliquez sur Test Connection. La connexion ainsi que la configuration des mappages de l'utilisateur et du rôle sont testées. Si les paramètres de connexion sont corrects, un message indique que la connexion a réussi. Si vous n'avez pas encore configuré le mappage de l'utilisateur et du rôle LDAP, le message renvoie une erreur.
7. Pour configurer le calendrier de synchronisation LDAP, utilisez les boutons Add Schedule, Edit
Schedule et Remove Schedule pour créer le calendrier souhaité.
Remarque :
vous devez configurer la synchronisation au moment où les utilisateurs connectés sont le moins nombreux.
8. Cliquez sur OK.
Configuration du mappage de l'utilisateur LDAP
Vous pouvez configurer les paramètres de mappage de l'utilisateur déterminant les utilisateurs importés et synchronisés à partir du serveur LDAP. Ces paramètres dépendent du fournisseur du serveur LDAP utilisé.
➤
Pour configurer les paramètres de mappage de l'utilisateur LDAP :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP User Mapping.
4. Spécifiez les valeurs des paramètres suivants :
●
LDAP User Base DN : racine de l'arborescence utilisée pour rechercher des utilisateurs. Par exemple :
●
(Sun ONE)
OU=people,DC=your domain,DC=com
●
(Active Directory)
CN=Users,DC=yourdomain,DC=com
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 172
●
●
●
●
●
●
LDAP User Search Filter : format approprié au type de serveur LDAP utilisé. Par exemple, votre serveur LDAP peut intégrer un groupe spécial pour les utilisateurs Business Activity Monitor.
Ce filtre permet de s'assurer que seuls les utilisateurs de ce groupe sont importés.
LDAP User LoginID : ID de connexion du fournisseur indiqué. Cette valeur devient l'ID de connexion de l'utilisateur dans Business Activity Monitor.
LDAP User Full Name : entrez cn
si vous utilisez Sun ONE ou Active Directory.
LDAP User Description : entrez description
si vous utilisez Sun ONE ou Active Directory.
LDAP User PrimaryEmail : entrez userPrincipalName
. Ceci renvoie à l'adresse électronique de l'utilisateur dans le répertoire LDAP.
LDAP User EncryptedPassword : entrez le mot de passe associé à l'utilisateur spécifié si vous utilisez Sun ONE ou Tivolie. Ne remplissez pas ce champ pour Active Directory.
5. Cliquez sur l'onglet LDAP Synchronization, puis sur Test Connection pour savoir si l'importation des utilisateurs a réussi.
6. Cliquez sur OK.
Configuration du mappage du rôle LDAP
Vous pouvez configurer les paramètres de mappage du rôle déterminant les groupes ou rôles importés, synchronisés ou les deux. Ces paramètres dépendent du fournisseur du serveur LDAP utilisé.
➤
Pour configurer les paramètres de mappage du rôle LDAP :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP Role Mapping.
4. Spécifiez les valeurs des paramètres suivants :
●
LDAP Role Base DN : format approprié au type de serveur LDAP utilisé :
●
●
(Sun ONE)
OU=Groups,DC=your domain,DC=com
(Active Directory)
CN=Users,DC=yourdomain,DC=com
●
●
●
●
●
LDAP Role Search Filter : format approprié au type de serveur LDAP utilisé :
●
(Sun ONE)
(&(objectclass=groupOfUniqueNames))
●
(Active Directory)
(&(objectclass=group))
LDAP Role LoginID : entrez cn
si vous utilisez Sun ONE ou Active Directory.
LDAP Role Full Name : entrez displayname
si vous utilisez Sun ONE ou Active Directory.
LDAP Role Description : entrez description
si vous utilisez Sun ONE ou Active Directory.
LDAP Role Member : nom de la propriété à plusieurs valeurs contenant les membres du rôle :
●
(Sun ONE) uniqueMember
●
(Active Directory)
member
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 173
●
LDAP Role Member is : utilisez l'une des options suivantes :
●
●
Distinguished Name
, si les propriétés de membre du rôle identifient les utilisateurs par l'intermédiaire de leur identifiant, comme cn=jadmin,ou=people,dc=your domain,dc=com
.
Login identification
, si les propriétés de membre du rôle identifient les utilisateurs par la valeur de la propriété utilisée comme identifiant de connexion Business Activity Monitor.
5. Cliquez sur l'onglet LDAP Synchronization, puis sur Test Connection pour savoir si l'importation des utilisateurs a réussi.
6. Cliquez sur OK.
Synchronisation manuelle avec le serveur LDAP
Vous pouvez synchroniser manuellement BAM Server avec le serveur LDAP à tout moment. Les demandes de synchronisation sont placées en file d'attente pour empêcher les synchronisations simultanées.
➤
Pour procéder à une synchronisation manuelle avec le serveur LDAP :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP Synchronization.
4. Cliquez sur Synchronize Now. Le délai d'exécution de la synchronisation dépend de votre environnement. Un message apparaît une fois la synchronisation terminée.
5. Cliquez sur OK.
Etapes suivantes
Vous pouvez à présent installer LiveCycle Workflow Designer. Reportez-vous à la section
LiveCycle Workflow Designer », page 174 .
17
Installation de LiveCycle Workflow Designer
Ce chapitre décrit l'installation de LiveCycle Workflow Designer.
Installation de LiveCycle Workflow Designer
Vous devez exécuter un programme d'installation pour installer LiveCycle Workflow Designer et configurer une connexion à LiveCycle Workflow Server. Lorsque vous lancez le programme d'installation, vous devez spécifier le nom du serveur sur lequel LiveCycle Workflow Server est déployé.
Avant d'installer LiveCycle Workflow Designer, vous devez disposer de J2SDK version 1.05.2_04 ou d'une version ultérieure à la 1.4.2 (la version 1.4.2_10 n'est pas prise en charge).
Lorsque LiveCycle Workflow Server est déployé sur WebSphere, les conditions suivantes s'appliquent :
●
WebSphere Pluggable Client doit être installé au moyen du support d'installation de WebSphere avant d'installer LiveCycle Workflow Designer. Au cours de cette procédure, vous devez effectuer une installation personnalisée et sélectionner Pluggable Application Client. Pour plus détails, consultez la documentation de WebSphere.
●
Vous devez utiliser WebSphere Pluggable Client version 5.1 avec WebSphere 5.1.1, et WebSphere
Pluggable Client version 6.0 avec WebSphere 6.
●
●
●
Lorsque vous installez WebSphere Client sur l'ordinateur LiveCycle Workflow Designer, vous pouvez uniquement vous connecter à des instances de LiveCycle Workflow Server déployées sur WebSphere.
Si vous réinstallez et configurez LiveCycle Workflow Designer pour vous connecter à des instances du serveur déployées sur d'autres types de serveurs d'applications, tels que JBoss ou WebLogic, les tentatives de connexion aux serveurs échouent.
Pour utiliser le même ordinateur client lors de la connexion aux instances de LiveCycle Workflow Server déployées sur un autre type de serveur d'applications, vous devez désinstaller WebSphere Client et
LiveCycle Workflow Designer, puis réinstaller LiveCycle Workflow Designer.
Si le serveur d'applications WebSphere sur lequel LiveCycle Workflow Server est déployé utilise
SSL/IIOP, vous devez désactiver SSL/IIOP lorsque vous utilisez LiveCycle Workflow Designer. Sinon,
LiveCycle Workflow Designer ne pourra pas se connecter au serveur d'applications.
LiveCycle Workflow Designer est installé à l'emplacement suivant par défaut :
●
(Windows) C:\Adobe\LiveCycle\WorkflowDesigner
●
(Linux) /opt/adobe/livecycle/workflow_designer
➤
Pour installer LiveCycle Workflow Designer :
1. Lancez le programme d'installation situé à la racine du support d'installation en saisissant la commande suivante :
●
●
(Windows) adobe_lc_workflow_721_des.exe
(Linux) adobe_lc_workflow_721_des.bin
2. Dans l'écran de bienvenue, cliquez sur Suivant.
3. Lisez l'accord de licence, sélectionnez I accept the terms of the license agreement, puis cliquez sur Next.
174
Adobe LiveCycle Installation de LiveCycle Workflow Designer
Installation et configuration de LiveCycle pour WebSphere Connexion au serveur d'applications par le biais de ports autres que les ports par défaut 175
4. Acceptez le répertoire d'installation par défaut ou cliquez sur Browse et recherchez le répertoire dans lequel vous souhaitez installer le produit, puis cliquez sur Next.
Remarque :
si vous saisissez le nom d'un répertoire qui n'existe pas, ce dernier est créé pour vous.
5. Sélectionnez WebSphere comme type de serveur d'applications hébergeant
LiveCycle Workflow Server, puis cliquez sur Next.
6. Accédez au répertoire [emplacement d'installation du client ws]/WebSphere/AppClient. Il s'agit du répertoire de WebSphere Pluggable Client.
7. Dans la zone de texte, saisissez le nom de l'ordinateur exécutant LiveCycle Workflow Server et cliquez sur Next.
8. Vérifiez les détails de l'installation, puis cliquez sur Back pour modifier les paramètres ou cliquez sur
Install pour continuer.
9. Cliquez sur Finish.
10. Si vous n'installez pas LiveCycle Workflow Designer sur le même ordinateur que LiveCycle Workflow
Server, vérifiez que l'heure de l'horloge système est correctement configurée.
Si cette dernière n'est pas comprise dans les deux heures du fuseau horaire utilisé, LiveCycle Workflow
Designer ne peut pas se connecter au serveur d'applications. L'heure de l'horloge système du serveur d'applications doit également être correctement définie.
Connexion au serveur d'applications par le biais de ports autres que les ports par défaut
La configuration par défaut de LiveCycle Workflow Designer utilise des ports JNDI et HTTP par défaut pour la connexion au serveur d'applications. Si le serveur d'applications utilise des numéros de ports non définis par défaut, vous devez modifier manuellement le fichier de configuration de LiveCycle
Workflow Designer.
➤
Pour modifier le port utilisé pour les connexions JNDI et HTTP :
1. Ouvrez le fichier qlc-config.xml dans un éditeur de texte depuis l'emplacement suivant :
●
●
(Windows) [racine LiveCycle]/WorkflowDesigner/qlc/
(Linux) [racine LiveCycle]/workflow_designer/qlc/
2. Recherchez l'élément property
portant l'attribut name
de java.naming.provider.url
, puis modifiez l'URL dans l'attribut value
afin d'intégrer le port à utiliser pour les connexions JNDI.
Par exemple, l'élément property
suivant configure le port à utiliser pour les connexions JNDI à 2809 :
<property name="java.naming.provider.url" value="iiop://localhost:
2809
/"/>
3. Recherchez l'élément application-services
et remplacez la valeur de l'attribut port
par le port que votre serveur d'applications utilise pour ses connexions HTTP.
Par exemple, l'élément application-services suivant configure le port à utiliser pour les connexions
HTTP sur 9080 :
<application-services host="localhost" port="
9080
" context="adobe-services"/>
4. Enregistrez le fichier, puis fermez-le.
Adobe LiveCycle
Installation et configuration de LiveCycle pour WebSphere
Installation de LiveCycle Workflow Designer
Désinstallation de LiveCycle Workflow Designer 176
Désinstallation de LiveCycle Workflow Designer
LiveCycle Workflow Designer intègre un programme de désinstallation créé pendant l'installation.
Le programme de désinstallation supprime les fichiers produit.
➤
Pour supprimer LiveCycle Workflow Designer :
1. Lancez le programme de désinstallation :
●
(Windows) Accédez au répertoire [racine LiveCycle]/WorkflowDesigner/_uninst/ et double-cliquez sur uninstall.exe.
●
(Linux) Accédez au répertoire [racine LiveCycle]/workflow_designer/_uninst/ et exécutez uninstall.bin.
2. Lorsque vous y êtes invité, sélectionnez la langue souhaitée pour le programme de désinstallation et cliquez sur OK.
3. Dans l'écran de bienvenue, cliquez sur Suivant.
4. Vérifiez les informations affichées, puis cliquez sur Uninstall.
5. Si la boîte de dialogue Remove Existing File s'affiche, cliquez sur Yes To All.
6. Cliquez sur Finish.
Etapes suivantes
Vous pouvez maintenant déployer les QPAC. (Consultez le guide Création de flux de production ou l'aide de
LiveCycle Workflow Designer.)
Si vous avez installé Watched Folder et LiveCycle Assembler, vous pouvez créer des flux de production
LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder », page 182 .
公開リンクが更新されました
あなたのチャットの公開リンクが更新されました。