Partie III : Configuration après le déploiement. Adobe Workflow, Form Manager, PDF Generator, assembler, forms, PRINT
Partie III : Configuration après le déploiement
Cette section du guide décrit les opérations de configuration complémentaires nécessaires après le déploiement des produits LiveCycle sur le serveur d'applications et l'initialisation de la base de données
LiveCycle.
71
11
Configuration de SSL sur JBoss
Ce chapitre décrit la procédure de création d'informations d'identification et de configuration SSL sur le serveur d'applications afin d'accroître la sécurité de la communication avec le serveur d'applications.
Les informations contenues dans ce chapitre s'appliquent aux méthodes d'installation clé en main et manuelle.
Remarque :
il est conseillé de terminer la procédure d'installation, de configuration et de déploiement des produits LiveCycle et de vérifier qu'ils s'exécutent correctement avant de configurer SSL sur le serveur d'applications.
Il est important de vérifier que les paramètres de sécurité configurés sur le serveur d'applications et dans le fichier LiveCycle.ear sont homogènes.
Attention :
si vous installez et déployez plusieurs produits LiveCycle, vous devez consulter le guide
Installation et configuration approprié pour obtenir les paramètres SSL et de sécurité spécifiques à chaque produit LiveCycle installé.
Si vous n'avez pas encore activé le protocole SSL sur le module Data Manager (assemblé en tant que partie du fichier LiveCycle.ear), exécutez Configuration Manager pour reconfigurer et réassembler les produits en activant
SSL, puis redéployez le fichier LiveCycle.ear. Le mot de passe SSL que vous spécifiez dans Configuration Manager doit correspondre à celui que vous saisissez lors de la configuration de SSL sur le serveur d'applications.
Reportez-vous à la section « Configuration des produits LiveCycle à déployer », page 49
.
Pour configurer SSL sur le serveur d'applications, vous devez effectuer les tâches suivantes :
O
« Création d'informations d'identification SSL », page 72
O
« Configuration de SSL sur JBoss », page 74
Création d'informations d'identification SSL
Pour configurer SSL sur JBoss, vous avez besoin d'informations d'identification SSL à des fins d'authentification. Vous pouvez utiliser l'outil IBM de gestion des clés installé avec l'outil de génération de clés Java pour exécuter les tâches suivantes dans le but de créer des informations d'identification :
O
O
O
Créez une paire de clés publique/privée.
Conservez la clé publique dans un certificat X.509 v1 auto-signé enregistré en tant que chaîne de certificats à un seul élément.
Enregistrez la chaîne de certificats et la clé privée dans un nouveau fichier de stockage des clés.
La commande keytool se situe généralement dans le répertoire Java jre/bin. Utilisez la commande keytool
-genkey pour lancer l'outil de génération des clés et créer une paire de clés. La commande keytool doit comprendre plusieurs options et valeurs d'option, répertoriées dans le tableau suivant. La commande keytool se situe généralement dans le répertoire Java jre/bin et doit comprendre plusieurs options et valeurs d'option, répertoriées dans le tableau suivant.
72
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Création d'informations d'identification SSL 73
Option de génération des clés
-alias
-keyalg
-keystore
-validity
-storepass
Description
Alias du fichier de stockage des clés.
Valeur de l'option
ads-credentials
Algorithme utilisé pour générer la paire de clés.
RSA
Vous pouvez utiliser un autre algorithme, en fonction de la stratégie de votre entreprise.
L'emplacement et le nom du fichier de stockage de clés.
[racine du serveur
d'applications]/server/all/svcnative/ads-ssl.jks
L'emplacement peut comprendre le chemin d'accès absolu au fichier ou dépendre du répertoire courant de l'invite de commande dans laquelle la commande keytool a été saisie.
Nombre de jours pendant lesquels le certificat est considéré comme valide.
Mot de passe protégeant le contenu du fichier de stockage de clés.
3650
Vous pouvez utiliser une autre valeur, en fonction de la stratégie de votre entreprise.
Le mot de passe du fichier de stockage de clés doit correspondre au mot de passe d'identification SSL spécifié pour le module Data Manager à l'aide de
Configuration Manager.
-keypass
-dname
Mot de passe protégeant la clé privée de la paire de clés.
Appliquez le mot de passe utilisé pour l'option
-storepass
. Le mot de passe de clé doit comprendre au moins 6 caractères.
Nom identifiant la personne possédant le fichier de stockage de clés.
"CN=[User name],OU=[Group Name],
O=[Company Name], L=[City Name],
S=[State or province], C=[Country
Code]"
O
[User name]
correspond à l'identifiant de l'utilisateur possédant le fichier de stockage de clés.
O
O
O
O
O
[Group Name]
correspond au groupe de l'entreprise auquel le propriétaire du fichier de stockage de clés appartient.
[Company Name]
correspond au nom de l'entreprise.
[City Name]
correspond à la ville dans laquelle votre entreprise est implantée.
[State or province]
correspond à la région dans laquelle votre entreprise est implantée.
[Country Code]
correspond au code à deux chiffres propre au pays dans lequel votre entreprise est implantée.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Configuration de SSL sur JBoss 74
Vous pouvez exécuter le fichier de stockage de clés au moyen d'une seule commande qui comprend toutes les informations requises pour créer un tel fichier. Pour plus de détails sur l'utilisation de la commande keytool, consultez le fichier keytool.html inclus dans votre documentation JDK.
³
Pour créer des informations d'identification SSL :
1. Ouvrez une invite de commande et recherchez [racine du serveur d'applications]/server all/svcnative.
2. Entrez la commande suivante :
[JAVA_HOME]
/bin/keytool -genkey -v -alias ads-credentials -keyalg RSA
-keystore "ads-ssl.jks" -validity 3650 -storepass store_password
-keypass key_password -dname "CN=User ID, OU=Group Name, O=Company Name,
L=City Name, S=State, C=Country Code"
Remarque :
vous devez remplacer
[JAVA_HOME]
par le répertoire dans lequel JDK est installé, puis remplacer le texte en gras par les valeurs correspondant à votre environnement.
Le fichier de stockage de clés est créé dans le répertoire [racine du serveur
d'applications]/server/all/svcnative.
Configuration de SSL sur JBoss
Vous pouvez activer SSL sur le serveur d'applications en modifiant les fichiers indiqués dans cette section.
Une fois le protocole SSL configuré, vous devez démarrer manuellement JBoss.
³
Pour configurer SSL sur JBoss :
1. Dans un éditeur de texte, ouvrez le fichier jacorb.properties situé dans le répertoire [racine du serveur
d'applications]/server/all/conf, puis modifiez la configuration SSL afin qu'elle contienne le texte suivant :
#########################
### SSL Configuration ###
#########################
# the qualified classname of the ssl socket factory class jacorb.ssl.socket_factory=org.jacorb.security.ssl.sun_jsse.SSLSocket
Factory
# the qualified classname of the ssl server socket factory class jacorb.ssl.server_socket_factory=org.jacorb.security.ssl.sun_jsse.
SSLServerSocketFactory
# The name and location of the keystore. This should be absolute
# to the directory where this property file resides.
#jacorb.security.keystore=c:/jboss-3.2.5/server/all/svcnative/ ads-ssl.jks
jacorb.security.keystore=<--remplacer par le chemin complet d'ads-ssl.jks--> jacorb.security.keystore_password=votre mot de passe SSL
# trusted ca certs are also in the same keystore jacorb.security.jsse.trustees_from_ks=on jacorb.security.support_ssl=on
#client side ssl supported or enforced?
jacorb.security.ssl.client.supported_options=60 jacorb.security.ssl.client.required_options=0
#client side ssl supported or enforced?
jacorb.security.ssl.server.supported_options=60 jacorb.security.ssl.server.required_options=60
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Configuration de SSL sur JBoss 75
2. Enregistrez le fichier jacorb.properties.
3. Dans un éditeur de texte, ouvrez le fichier server.xml dans le répertoire [racine du serveur
d'applications]/server/all/deploy/jbossweb-tomcat50.sar, puis annulez la mise en commentaire de la section suivante :
<!-- SSL/TLS Connector configuration using the SSL domain keystore
<Connector port="8080" address="${jboss.bind.address}" maxThreads="100" minSpareThreads="5" maxSpareThreads="15" scheme="https" secure="true" clientAuth="false" keystoreFile="${jboss.server.home.dir}/conf/chap8.keystore" keystorePass="rmi+ssl" sslProtocol = "TLS" />
-->
4. Remplacez la valeur de l'attribut keystoreFile
par
"${jboss.server.home.dir}/svcnative/ads-ssl.jks"
, qui représente l'emplacement du fichier de stockage de clés.
5. Remplacez la valeur de l'attribut keystorePass
par le mot de passe du fichier de stockage de clés spécifié lors de la création du fichier de stockage de clés.
6. Enregistrez le fichier server.xml.
7. Dans un éditeur de texte, ouvrez le fichier iiop-service.xml du répertoire [racine du serveur
d'applications]/server/all/deploy, puis annulez la mise en commentaire du texte suivant :
<!-- (uncomment to use IIOP over SSL)
<mbean code="org.jboss.security.plugins.JaasSecurityDomain"
name="jboss.security:service=JaasSecurityDomain,domain=IIOP+SSL">
<constructor>
<arg type="java.lang.String" value="IIOP+SSL"/>
</constructor>
<attribute name="KeyStoreURL">iiop-over-ssl.keystore</attribute>
<attribute name="KeyStorePass">iiop-over-ssl</attribute>
</mbean>
-->
8. Définissez les valeurs des attributs
KeyStoreURL
et
KeyStorePass
pour les adapter à votre configuration :
<attribute name="KeyStoreURL">
[racine du serveur d'applications]/server/all/svcnative/ads-ssl.jks
</attribute>
<attribute name="KeyStorePass">
Mot de passe du fichier de stockage de clés
</attribute>
9. Dans la section
CORBA ORB service
, annulez la mise en commentaire du texte suivant :
<!-- (uncomment to use IIOP over SSL)
<attribute name="SecurityDomain">java:/jaas/IIOP+SSL</attribute>
<depends>jboss.security:serivce=JaasSecurityDomain,domain=IIOP+SSL
</depends>
</mbean>
-->
10. Enregistrez le fichier iiop-service.xml.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Configuration de SSL sur JBoss 76
11. Redémarrez le serveur d'applications.
12. Pour accéder à Administrator au moyen de SSL, entrez l'adresse suivante dans un navigateur Web : https://
[nomhôte]:[port]
/adminui
Le port par défaut pour JBoss est 8443.
,
Etape suivante
Si vous installez LiveCycle Workflow Business Activity Monitor, vous pouvez maintenant configurer un serveur d'applications pour héberger BAM Server. (Reportez-vous à la section
JBoss pour BAM Server », page 77
.) Vous pouvez également installer LiveCycle Workflow Designer.
Reportez-vous à la section
« Installation de LiveCycle Workflow Designer », page 98 .
12
Configuration manuelle de JBoss pour BAM Server
Ce chapitre s'applique aux licences LiveCycle Workflow permettant d'utiliser Business Activity Monitor
uniquement.
Il explique comment créer la base de métadonnées LiveCycle Workflow Business Activity Monitor et configurer le serveur d'applications JBoss pour BAM Server, un composant de LiveCycle Workflow.
Si vous installez les produits à l'aide de la méthode clé en main, JBoss et MySQL sont automatiquement installés et configurés et il n'est pas nécessaire d'effectuer les procédures de ce chapitre.
Dans ce chapitre, le répertoire racine de l'instance de JBoss que vous configurez pour BAM Server est appelé [racine bam jboss]. Reportez-vous à la section
« Conventions utilisées dans ce guide », page 8
.
Ce chapitre suppose que vous avez installé la base de données LiveCycle. Si ce n'est pas le cas, reportez-vous au point
« Préparation de l'environnement », page 42
.
Installation du serveur d'applications JBoss
Si vous configurez manuellement JBoss pour exécuter BAM Server, vous devez télécharger JBoss
Application Server 3.2.6 et l'installer. Vous pouvez télécharger JBoss à l'adresse suivante : http://labs.jboss.com/portal/jbossas/download
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.
77
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Configuration de JBoss pour BAM Server 78
Configuration de JBoss pour BAM Server
Si vous installez LiveCycle Workflow et le déployez manuellement sur JBoss, vous devez installer et configurer manuellement JBoss afin que BAM Server s'exécute correctement.
BAM Server doit être déployé sur une autre instance de JBoss que celle sur laquelle
LiveCycle Workflow Server est déployée. Vous devez configurer les zones suivantes sur l'instance de JBoss exécutant BAM Server :
O
Installez les pilotes de base de données dont JBoss a besoin pour communiquer avec la base de métadonnées Business Activity Monitor et la base de données LiveCycle. Reportez-vous à la section
« Installation des pilotes de base de données sur JBoss pour BAM Server », page 78
.
O
O
O
O
O
O
Créez un fichier de source de données pour permettre à BAM Server de se connecter à la base de métadonnées Business Activity Monitor. Reportez-vous à la section
« Connexion de JBoss à la base de métadonnées BAM », page 78 .
Créez un fichier de source de données pour permettre à BAM Server de se connecter à la base de
Configurez la machine virtuelle Java (JVM) exécutant le serveur d'applications JBoss (reportez-vous à la
section « Configuration des options JVM de JBoss requises », page 83 .)
.
Configurez JBoss afin que les événements Business Activity Monitor ne soient pas dupliqués dans les
.
Changez les ports JBoss pour éviter les conflits avec les autres applications en cours d'exécution sur le même ordinateur. Reportez-vous à la section
« Personnalisation des numéros de port », page 86 .
Installation des pilotes de base de données sur JBoss pour BAM Server
Pour permettre à BAM Server de se connecter à la base de métadonnées Business Activity Monitor et à la base de données LiveCycle, vous devez installer les pilotes des types de bases de données que vous utilisez.
³
Pour installer le pilote JDBC pour SQL Server :
O
Copiez les fichiers de pilote de base de données de SQL Server 2000 (msbase.jar, mssqlserver.jar et msutil.jar) dans le répertoire [racine bam jboss]/server/default/lib.
Remarque :
LiveCycle et BAM Server sont exécutés dans des arborescences complètement différentes de JBoss, ce qui signifie que les pilotes doivent être présents dans chaque arborescence.
En conséquence, il vous faut réinstaller ces pilotes pour BAM Server. Reportez-vous à la section
« Pour télécharger le pilote JDBC pour SQL Server et le copier : », page 62 .
Connexion de JBoss à la base de métadonnées BAM
Vous devez configurer une connexion à la base de métadonnées Business Activity Monitor sur l'instance de JBoss exécutant BAM Server de manière à ce qu'il récupère des informations sur les métriques de processus qu'il surveille.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss à la base de métadonnées BAM 79
La procédure de configuration de la connexion que vous utilisez dépend du type de base de données utilisé pour stocker les métadonnées Business Activity Monitor :
O
« Connexion à la base de métadonnées BAM sur SQL Server », page 79
Connexion à la base de métadonnées BAM sur SQL Server
Pour permettre à BAM Server de se connecter à la base de données SQL Server stockant les métadonnées Business Activity Monitor, vous devez créer un fichier de source de données et le déployer sur les instances de JBoss exécutant BAM Server. Vous devez également modifier les mappages des types de données par défaut sur JBoss.
³
Pour créer une source de données pour la base de métadonnées Business Activity Monitor sur
SQL Server :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.metadata.metaDatasource</jndi-name>
<connection-url><!--Insert jdbcURL --></connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Remplacez
<!--Insert jdbcURL -->
à l'intérieur de l'élément connection-url
par le texte suivant :
O
O
O
O
O jdbc:microsoft:sqlserver://[nomhôte]:[port];SelectMethod=cursor; databaseName=[nombd];user=[nom_utilisateur];password=[motdepassebd]
[nom hôte]
correspond au nom de l'ordinateur sur lequel SQL Server 2000 est en cours d'exécution.
[port]
correspond au port utilisé pour accéder à la base de données. Le port par défaut de SQL
Server 2000 est le port 1433.
[nombd]
correspond au nom de la base de métadonnées BAM.
[nom_utilisateur]
correspond au nom du compte utilisateur de la base de données pouvant accéder à la base de métadonnées BAM.
[motdepassebd]
correspond au mot de passe de l'utilisateur
[nom_utilisateur]
.
3. Enregistrez le fichier sous celequest_metadata-ds.xml dans le répertoire [racine bam
jboss]/server/default/deploy.
³
Pour modifier les mappages des types de données par défaut sur SQL Server :
1. Recherchez le répertoire [racine bam jboss]/server/default/conf et ouvrez le fichier standardjbosscmp-jdbc.xml dans un éditeur de texte.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss pour BAM Server à la base de données LiveCycle 80
2. Dans la section
<defaults>
qui se trouve vers le haut du fichier, modifiez le paramètre indiqué en gras ci-dessous :
<datasource>java:/com.celequest.metadata.metaDatasource</datasource>
<datasource-mapping>MS SQLSERVER2000</datasource-mapping>
<create-table>false</create-table>
...
<list-cache-max>10000</list-cache-max>
3. Recherchez l'élément type-mappings
possédant un élément enfant name
contenant le texte
MS SQLSERVER2000
, puis insérez le code suivant sous l'élément function-mapping
final :
<mapping>
<java-type>com.celequest.metadata.ejb.BigString</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.jar.Jar</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertFiring</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertAck</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertInstance</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.util.misc.SerializableWrapper</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
4. Enregistrez le fichier, puis fermez-le.
5. Redémarrez JBoss.
Connexion de JBoss pour BAM Server à la base de données LiveCycle
Vous devez configurer une connexion à la base de données LiveCycle sur l'instance de JBoss exécutant
BAM Server de manière à ce qu'il récupère des informations sur les données d'exécution du processus.
La procédure de configuration de la connexion que vous utilisez dépend du type de base de données utilisé pour enregistrer les données LiveCycle :
O
O
« Connexion à la base de données LiveCycle sur SQL Server », page 81
« Connexion à la base de données LiveCycle sur MySQL », page 81
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss pour BAM Server à la base de données LiveCycle 81
Connexion à la base de données LiveCycle sur SQL Server
Pour permettre à BAM Server de se connecter à la base de données LiveCycle, vous devez créer un fichier de source de données et le déployer sur l'instance de JBoss exécutant BAM Server.
³
Pour créer une source de données pour la base de données LiveCycle sur SQL Server 2000 :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.adobe</jndi-name>
<connection-url><!--Insert jdbcURL --></connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver
</driver-class>
<!-- The login and password -->
<user-name><!--Insert dbUsername --></user-name>
<password><!--Insert dbPassword --></password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Remplacez
<!--Insert jdbcURL -->
dans l'élément connection-url
par le texte suivant : jdbc:microsoft:sqlserver://[nomhôte]:[port];SelectMethod=cursor; databaseName=[nombd];user=[utilisateurbd];password=[motdepassebd]
O
[nom hôte]
correspond au nom de l'ordinateur sur lequel SQL Server 2000 est en cours d'exécution.
O
O
O
O
[port]
correspond au port utilisé pour accéder à la base de données LiveCycle. Le port par défaut de SQL Server 2000 est le port 1433.
[nombd]
correspond au nom de la base de données LiveCycle.
[utilisateurbd]
correspond au nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
[motdepassebd]
correspond au mot de passe de l'utilisateur
[utilisateurbd]
.
3. Remplacez
<!--Insert dbUsername -->
dans l'élément
<user-name>
par le nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
4. Remplacez
<!--Insert dbPassword -->
dans l'élément
<password>
par le mot de passe du nom d'utilisateur spécifié dans l'élément
<user-name>
.
5. Enregistrez le fichier sous adobe-ds.xml dans le répertoire [racine bam jboss]/server/default/deploy/.
Connexion à la base de données LiveCycle sur MySQL
Pour permettre à BAM Server de se connecter à la base de données LiveCycle, vous devez créer un fichier de source de données et le déployer sur l'instance de JBoss exécutant BAM Server.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss pour BAM Server à la base de données LiveCycle 82
³
Pour installer le pilote JDBC pour MySQL :
1. Téléchargez le fichier mysql-connector-java-3.0.15-ga-bin-jar depuis le site Web de MySQL : http://www.mysql.com/products/connector/j/
2. Copiez le fichier dans le répertoire [racine bam jboss]/server/default/lib.
³
Pour créer une source de données pour la base de données LiveCycle sur MySQL :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.adobe</jndi-name>
<connection-url><![CDATA[<!--Insert jdbcURL -->]]>
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<!-- The login and password -->
<user-name><!--Insert dbUsername --></user-name>
<password><!--Insert dbPassword --></password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Remplacez
<!--Insert jdbcURL -->
dans l'élément connection-url
par le texte suivant :
O
O
O
O jdbc:mysql://[nom_hôte]/[nom_bd]?user=[nom_utilisateur_bd]&password=
[motdepassebd]&autoReconnect=true&autoReconnectForPools=true
[nom_hôte]
correspond au nom de l'ordinateur sur lequel MySQL est en cours d'exécution.
[nom_bd]
correspond au nom de la base de données LiveCycle.
[nom_utilisateur_bd]
correspond au nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
[motdepassebd]
correspond au mot de passe de l'utilisateur
[nom_utilisateur_bd]
.
3. Remplacez
<!--Insert dbUsername -->
dans l'élément user-name
par le nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
4. Remplacez
<!--Insert dbPassword -->
dans l'élément password
par le mot de passe du nom d'utilisateur spécifié dans l'élément
<user-name>
.
5. Enregistrez le fichier sous adobe-ds.xml dans le répertoire [racine bam jboss]/server/default/deploy.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Configuration des options JVM de JBoss requises 83
Configuration des options JVM de JBoss requises
Vous devez configurer la machine virtuelle Java (JVM) pour prendre en charge BAM Server.
³
Pour configurer les options JVM de JBoss :
1. Accédez au répertoire [racine bam jboss]/bin et ouvrez le fichier de script de démarrage dans un éditeur de texte :
O
O
(Windows) run.bat
(Linux) run.sh
2. Remplacez les paramètres de mémoire
JAVA_OPTS
par 128 M minimum et 768 M maximum, puis ajoutez -server pour optimiser les performances :
O
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -server -Xms128m -Xmx768m
(Linux) JAVA_OPTS="$JAVA_OPTS -server -Xms128m -Xmx768m"
Dans le cadre de charges de données importantes, augmentez la mémoire maximale à -
Xmax1536m
(1,5 Go).
3. Ajoutez un paramètre
JAVA_OPTS
pour désactiver la double consignation de la sortie système. Voici la solution au bogue 877974 dans JBoss :
O
Windows : définissez JAVA_OPTS=%JAVA_OPTS%
-Dorg.jboss.logging.Log4jService.catchSystemOut=false
-Dorg.jboss.logging.Log4jService.catchSystemErr=false
O
Linux :
JAVA_OPTS="$JAVA_OPTS
-Dorg.jboss.logging.Log4jService.catchSystemOut=false
-Dorg.jboss.logging.Log4jService.catchSystemErr=false"
4. Ajoutez un paramètre
JAVA_OPTS
pour activer la prise en charge des caractères UTF-8 :
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=utf8
O
(Linux) JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8”
5. Ajoutez un caractère JAVA_OPTS pour augmenter la taille de la pile de thread à 300 :
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -XX:ThreadStackSize=300
O
(Linux) JAVA_OPTS="$JAVA_OPTS -XX:ThreadStackSize=300”
6. (Facultatif ) Ajoutez un paramètre JAVA_OPTS pour intégrer les options facultatives de JVM :
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% [options JVM]
O
(Linux)
JAVA_OPTS="$JAVA_OPTS [options JVM]
[options JVM]
correspond aux options à inclure au format
-Dcom.celequest.property.[PARAMETRE]=[VALEUR]
7. Enregistrez le fichier du script de démarrage et fermez-le.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Options facultatives de JVM pour JBoss 84
Options facultatives de JVM pour JBoss
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 par des commandes au format suivant :
-Dcom.celequest.property.[PARAMETRE]=[VALEUR]
Ce tableau fournit les valeurs valides de
[PARAMETRE]
et
[VALEUR]
.
Paramètre Description
LANGUAGE
Code ISO pour la langue du serveur.
Par exemple, dans la commande suivante, le paramètre LANGUAGE est défini sur le portugais :
-Dcom.celequest.property.LANGUAGE=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
:
O
Indiquez true
si vous souhaitez comparer les chaînes sensibles aux paramètres locaux.
O
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
.
Pour configurer plusieurs propriétés, séparez chaque commande par un espace. Par exemple, les commandes suivantes définissent la langue sur le portugais et le paramètre local sur Brésil :
-Dcom.celequest.property.LANGUAGE=PT -Dcom.celequest.property.LOCALE=BR
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Modification de la configuration des threads de JBoss 85
Modification de la configuration des threads de JBoss
Avant de déployer BAM Server sur JBoss, vous devez modifier la configuration des threads dans le fichier server.xml de JBoss.
³
Pour modifier la configuration des threads :
1. Recherchez le répertoire [racine bam jboss]/server/default/deploy/jbossweb-tomcat50.sar et ouvrez le fichier server.xml.
2. Recherchez l'en-tête
<!-- A HTTP/1.1 Connector on port 8080 -->
.
Remarque :
la valeur de port peut être 9080 si vous exécutez l'installation clé en main et que vous modifiez les threads de JBoss.
3. Modifiez les valeurs de port HTTP dans l'élément
Connector
afin qu'elles correspondent au texte en gras du code XML suivant :
<!-- A HTTP/1.1 Connector on port 9080 -->
<Connector port="9080" address="${jboss.bind.address}"
maxThreads="400"
minSpareThreads="100" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"/>
4. (Facultatif ) Ajoutez les attributs compression
et socketBuffer
au même élément
Connector pour optimiser les performances globales de Business Activity Monitor, comme illustré par le texte en gras de l'exemple suivant :
<!-- A HTTP/1.1 Connector on port 9080 -->
<Connector port="9080" address="${jboss.bind.address}" maxThreads="400" minSpareThreads="100" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"
compression="on" socketBuffer="1045576"
/>
5. Enregistrez le fichier server.xml, puis fermez-le.
6. Redémarrez JBoss.
Configuration de la consignation sur JBoss
Il est possible d'enregistrer les messages envoyés aux journaux de Business Activity Monitor dans le fichier server.log de JBoss. Par défaut, JBoss consigne tous les messages publiés par BAM Server en plus de ses propres messages et de ceux des applications qu'il héberge. Vous pouvez modifier le fichier log4j.xml de
JBoss afin d'empêcher la consignation des messages de Business Activity Monitor dans le fichier journal de JBoss.
Attention :
n'exécutez pas cette procédure lorsque JBoss est en cours d'exécution, faute de quoi JBoss duplique les messages dans la console et le fichier journal.
Remarque :
par défaut, les serveurs Business Activity Monitor publient les messages de gravité des informations. Vous pouvez modifier les messages publiés au moyen de la console d'administration de Business Activity Monitor (BAM) Workbench.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Personnalisation des numéros de port 86
³
Pour limiter l'enregistrement de messages Business Activity Monitor par JBoss :
1. Arrêtez JBoss.
2. Dans un éditeur de texte, ouvrez le fichier log4j.xml depuis le répertoire [racine bam
jboss]/default/conf/.
3. Recherchez le code XML suivant :
<root>
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</root>
4. Supprimez l'élément appender-ref
possédant l'attribut ref
de la valeur
FILE
. L'élément root
doit désormais apparaître comme le code XML suivant :
<root>
<appender-ref ref="CONSOLE"/>
</root>
5. Recherchez la section
Categories
du fichier, puis ajoutez l'élément category
suivant de sorte que
JBoss envoie tous les messages des catégories « org » à la console (comme les messages publiés par
JBoss) sans consigner les messages de la catégorie « com » (com.celequest, par exemple) dans le fichier de consignation :
<category name="org">
<appender-ref ref="FILE"/>
</category>
6. Enregistrez le fichier log4j.xml et redémarrez JBoss.
Personnalisation des numéros de port
Vous devez modifier les ports que JBoss utilise afin d'éviter les conflits avec les ports utilisés par d'autres applications sur l'ordinateur hôte, comme l'instance de JBoss exécutant LiveCycle Workflow Server.
³
Pour modifier les ports :
1. Recherchez le répertoire [racine bam jboss]/server/default/deploy/jbossweb-tomcat50.sar et ouvrez le fichier server.xml dans un éditeur de texte.
2. Modifiez les paramètres de port HTTP et de port de redirection se trouvant dans la section
HTTP/1.1
Connector
:
<!-- A HTTP/1.1 Connector on port 9080 -->
<Connector port="9080" address="${jboss.bind.address}" maxThreads="400" minSpareThreads="100" maxSpareThreads="75" enableLookups="false" redirectPort="18443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"/>
3. Modifiez les paramètres du port AJP et du port de redirection :
<!-- A AJP 1.3 Connector on port 18009 -->
<Connector port="18009" address="${jboss.bind.address}" enableLookups="false" redirectPort="18443" debug="0" protocol="AJP/1.3"/>
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Personnalisation des numéros de port 87
4. Modifiez la définition du port SSL/TSL :
<!-- SSL/TLS Connector configuration using the admin devl guide keystore
<Connector port="18443" address="${jboss.bind.address}" maxThreads="100" minSpareThreads="5" maxSpareThreads="15" scheme="https" secure="true" clientAuth="false" keystoreFile="${jboss.server.home.dir}/conf/chap8.keystore" keystorePass="rmi+ssl" sslProtocol = "TLS" />
-->
5. Enregistrez le fichier server.xml, puis fermez-le.
6. Recherchez le répertoire [racine bam jboss]/server/default/deploy/http-invoker.sar/META-INF et ouvrez le fichier jboss-service.xml dans un éditeur de texte.
7. Mettez à jour toutes les occurrences de l'attribut
InvokerURLSuffix
:
<attribute name="InvokerURLSuffix">:9080/invoker/...
8. Enregistrez le fichier jboss-service.xml, puis fermez-le.
9. Recherchez le répertoire [racine bam jboss]/server/default/conf et ouvrez le fichier jboss-service.xml.
10. Dans la section
Class Loading
, recherchez l'élément
<mbean code="org.jboss.web.WebService" name="jboss:service=WebService">
et définissez le port sur 18083 :
<attribute name="Port">18083</attribute>
11. Dans la section
JNDI
, recherchez l'élément
<mbean code="org.jboss.naming.NamingService" name="jboss:service=Naming" xmbeandd="resource:xmdesc/NamingService-xmbean.xml">
et définissez le port sur
11099
:
<attribute name="Port">11099</attribute>
12. Associez l'attribut RmiPort au numéro de port
11098
:
<attribute name="RmiPort">11098</attribute>
13. Dans la section
Invokers to the JMX node
, recherchez l'élément
<mbean code="org.jboss.invocation.pooled.server.PooledInvoker" name="jboss:service=invoker,type=pooled"> et associez l'attribut RMIObjectPort au numéro de port
14444
:
<attribute name="RMIObjectPort">14444</attribute>
14. Associez l'attribut
ServerBindPort
au numéro de port
14445
:
<attribute name="ServerBindPort">14445</attribute>
15. Enregistrez le fichier jboss-service.xml, puis fermez-le.
16. Recherchez le répertoire [racine bam jboss]/server/default/deploy/jms et ouvrez le fichier uil2-service.xml dans un éditeur de texte.
17. Dans l'
élément
<mbean code="org.jboss.mq.il.uil2.UILServerILService" name="jboss.mq:service=InvocationLayer,type=UIL2">
, associez l'attribut
ServerBindPort
au numéro de port
18093
:
<attribute name="ServerBindPort">18093</attribute>
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
18. Enregistrez le fichier uil2-service.xml, puis fermez-le.
Configuration manuelle de JBoss pour BAM Server
Déploiement de BAM Server 88
Déploiement de BAM Server
Vous déployez BAM Server sur JBoss en copiant le fichier CAS_Adobe.ear sur l'instance de JBoss configurée pour BAM Server et le fichier CQIntegration.ear sur l'instance de JBoss configurée pour LiveCycle Workflow
Server. JBoss peut être exécuté ou arrêté lorsque vous copiez les fichiers dans les répertoires. Une fois les fichiers copiés, démarrez ou redémarrez le serveur afin de vous assurer que les services démarrent correctement.
³
Pour déployer BAM Server sur Jboss :
1. Copiez le fichier CAS_Adobe.ear du répertoire [racine
LiveCycle]/configurationManager/working/bam/common dans le répertoire [racine bam
jboss]/server/default/deploy.
2. Redémarrez l'instance de JBoss que vous avez configurée pour BAM Server.
3. Copiez le fichier CQIntegration.ear du répertoire [racine
LiveCycle]/configurationManager/working/bam/common dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
4. Redémarrez l'instance de JBoss que vous avez configurée pour LiveCycle Workflow Server.
Etape suivante
Vous devez à présent configurer les propriétés Business Activity Monitor sur LiveCycle Workflow Server et
BAM Server. Reportez-vous à la section « Prise en main de BAM Server », page 90 .
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.