Après la mise à niveau du serveur Application Engine à partir de la version 3.5, vous devez configurer JBoss Application Server pour qu'il fonctionne avec Application Engine. Vous pouvez aussi configurer des modifications pour des modes facultatifs tels que la connexion unique (SSO).
Important : 
Dans un environnement à haute disponibilité, les mises à niveau d'
Application Engine doivent être effectuées sur tous les noeuds du serveur d'applications .
Pour configurer JBoss Application Server pour Application Engine :
- Arrêter JBoss Application Server s'il fonctionne.
- Faites une copie de sauvegarde de run.conf et du script de démarrage, en fonction de votre plateforme :
Option |
Description |
UNIX |
run.sh |
Windows |
run.bat |
- Editez les paramètres Java du fichier run.conf.
- Ajoutez une ligne pour indiquer le chemin du kit Java Development Kit fourni par JBoss Application Server,
comme dans l'exemple ci-dessous (Windows) : set
JAVA_HOME=C:\Program Files\Java\jdk1.5.0_06
Important : Si la version de votre kit Java Development Kit n'est pas 1.5.0, indiquez-la à la place de celle de la liste ci-dessus.
- Mettez à jour les paramètres de mémoire JAVA_OPTS.
En ajustant ce paramètre, vous éviterez que le serveur manque de mémoire, ce qui empêcherait les utilisateurs de se connecter à Workplace.
Sur la ligne JAVA_OPTS,
adaptez les valeurs -Xms et -Xmx à votre configuration.
Par exemple (Windows) : set JAVA_OPTS=%JAVA_OPTS%
-Xms 128m -Xmx 512 m
Conformez-vous aux recommandations du fournisseur du serveur d'applications pour choisir les tailles de pile initiale et maximale. Pour obtenir
les recommandations spécifiques à IBM, voir le document IBM® FileNet P8 Performance Tuning Guide.
- (Utilisateurs de la machine virtuelle Java Sun seulement) Attribuez la valeur 128m à
MaxPermSize dans JAVA_OPTS, comme suit :
UNIX
JAVA_OPTS=%JAVA_OPTS%
-Xms128m -Xmx512m -XX:MaxPermSize=128m
Windows
set JAVA_OPTS=%JAVA_OPTS%
-Xms128m -Xmx512m -XX:MaxPermSize=128m
L'augmentation de ces valeurs évite les erreurs de mémoire qui peuvent arrêter le serveur JBoss Application Server.
- Si votre serveur d'applications utilise la machine virtuelle Java d'IBM, modifiez la variable JAVA_OPTS dans le fichier run.conf immédiatement après la ligne mentionnée ci-dessus. Cette modification de JAVA_OPTS améliore les performances.
- UNIX
- Dans le fichier run.conf, trouvez la ligne :
JAVA_OPTS="$JAVA_OPTS
et transformez-la (sans retour à la ligne) en :
JAVA_OPTS="$JAVA_OPTS
-Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"
- Windows
- Dans le fichier run.conf, trouvez la ligne :
set
JAVA_OPTS=%JAVA_OPTS%
et transformez-la (sans retour à la ligne) en :
set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2
-Dfilenet.pe.peorb.pool.max=5
- Sauvegardez les modifications.
- Configurez la connexion JAAS.
Saisissez l'une des lignes suivantes immédiatement après l'entrée "$JAVA" $JAVA_OPTS (UNIX) ou "%JAVA%" %JAVA_OPTS (Windows) dans le fichier run.sh pour UNIX ou run.bat pour Windows.
Important : Saisissez la variable jaas_login sur une seule ligne, sans retour à la ligne. Ne copiez pas le texte du présent document pour le coller ensuite. Les codes de formatage cachés poseraient des problèmes. Saisissez plutôt la ligne dans le script.
Conseil : Le chemin peut être légèrement différent selon la version de vos installations client, ou si vous avez choisi un chemin d'installation personnalisé. Vérifiez l'emplacement du fichier avant de saisir son chemin.
- UNIX
"$JAVA" $JAVA_OPTS
-Djava.security.auth.login.config=
"/opt/FileNet/AE/CE_API/config/jaas.conf.JBoss"
"-Djava.endorsed.dirs=$JBOSS_ENDORSED_DIRS" -classpath
"$JBOSS_CLASSPATH" org.jboss.Main $@
- Windows
"%JAVA%" %JAVA_OPTS%
"-Djava.security.auth.login.config=C:\Program
Files\FileNet\AE\CE_API\config\jaas.conf.JBoss"
"-Djava.endorsed.dirs=%JBOSS_ENDORSED_DIRS%" -classpath
"%JBOSS_CLASSPATH%" org.jboss.Main %*
- Sauvegardez et fermez le fichier run.sh ou run.bat.
- Configuration des paramètres LDAP sur Application Engine pour qu'ils correspondent exactement aux paramètres de Content Engine.
- Sur le serveur Application Engine,
éditez login-config.xml, situé dans JBoss_home/server/nom_de_serveur/conf.
- Définissez l'entrée <application-policy
name="FileNet"> de façon qu'elle soit exactement identique à l'entrée correspondante du fichier login-config.xml sur le serveur Content Engine.
- Définissez l'entrée <application-policy
name="FileNetP8Engine"> de façon qu'elle soit exactement identique à l'entrée correspondante du fichier login-config.xml sur le serveur Content Engine.
- Copiez la nouvelle entrée <application-policy
name="FileNetP8Engine">, et collez-la juste au-dessus de l'entrée copiée(<application-policy
name="FileNetP8Engine">).
- Modifiez la première occurrence d'<application-policy
name="FileNetP8Engine"> en <application-policy
name="FileNetP8">.
- Sauvegardez les modifications du fichier login-config.xml sur le serveur Application Engine.
- Redémarrez JBoss Application Server.
- Définissez les droits de l'utilisateur exécutant le serveur d'applications.
Sous Windows,
ce qui suit n'est nécessaire que pour les partitions formatées NTFS.
Si l'utilisateur qui doit exécuter le serveur d'applications n'est pas celui qui a installé Application Engine,
vous devez lui donner les droits de lecture et d'écriture sur le dossier sur lequel est installé Application Engine (chemin_d_installation_d_AE).
- (facultatif) Désactivez la consignation JBoss Application Server.
En mode développement, JBoss Application Server crée de nombreux messages de consignation de type accès HTTP, "INFO", "DEBUG" et "TRACE".
Cela peut engendrer un comportement inattendu du logiciel IBM FileNet déployé.
En utilisant la procédure ci-après, vous pouvez limiter ce type de consignation excessive de JBoss Application Server.
Lorsque la consignation est désactivée, les messages d'erreur continuent à s'afficher dans la console de JBoss Application Server.
- Editez le fichier log4j.xml
(JBOSS_home/server/nom_de_serveur/conf/log4j.xml).
- Modifiez toutes les valeurs de seuil et de priorité d'"INFO", de "DEBUG",
ou de "TRACE" en "ERROR".
- Supprimez ou mettez en commentaire "Preserve messages in a local
file" pour arrêter le journal serveur.
- Pour arrêter la consignation d'accès HTTP, ouvrez jboss-service.xml dans un éditeur de texte et supprimez ou mettez en commentaire la section "Access logger".
Emplacement de jboss-service.xml :
JBoss_Home/server/nom_de_serveur/deploy/jbossweb-tomcat55.sar/META-INF
- Editez web.xml et définissez logVerbosityLevel à "FATAL".
Emplacement de web.xml :
JBoss_Home/server/nom_de_serveur/deploy/jbossweb-tomcat55.sar/conf
- Redémarrez le serveur JBoss Application Server.