FileNet P8 Application Engine, Version 5.0.+       Serveur d'applications :  JBOSS Application Server     

Configuration d'Application Engine sur JBoss Application Server

Après l'installation du serveur Application Engine, 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).

A faire : Haute disponibilité Dans les environnements en parc ou en cluster, configurez Application Engine sur JBoss Application Server sur tous les noeuds.
A faire : Environnements de serveurs en clusters haute disponibilité Dans les configurations de serveurs en cluster à haute disponibilité, pour les étapes qui requièrent un paramètrage JVM (Java Virtual Machine), vous devez effectuer les modifications sur chaque noeud de la configuration du serveur d'applications.

Pour configurer JBoss Application Server pour Application Engine :

  1. Arrêter JBoss Application Server s'il fonctionne.
  2. 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
  3. Editez les paramètres Java du fichier run.conf.
    1. 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

      Si la version de votre kit Java Development Kit n'est pas 1.5.0, indiquez-la à la place de celle de la liste.

    2. 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 la taille de pile initiale et maximale. Vous trouverez les recommandations spécifiques d'IBM® dans IBM FileNet P8 Performance Tuning Guide.

    3. (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.

    4. 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

    5. Sauvegardez et fermez le fichier.
  4. 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.

    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 %*
  5. Sauvegardez et fermez le fichier run.sh ou run.bat.
  6. Configuration des paramètres LDAP sur Application Engine pour qu'ils correspondent exactement aux paramètres de Content Engine.
    1. Sur le serveur Application Engine, éditez login-config.xml, situé dans JBoss_home/server/nom_de_serveur/conf.
    2. 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.
    3. 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.
    4. Copiez la nouvelle entrée <application-policy name="FileNetP8Engine">, et collez-la juste avant l'entrée copiée(<application-policy name="FileNetP8Engine">).
    5. Modifiez la première occurrence d'<application-policy name="FileNetP8Engine"> en <application-policy name="FileNetP8">.
    6. Déplacez toutes les entrées <application-policy name=> liées à FileNet au-dessus de l'entrée <application-policy name="other">.
    7. Sauvegardez les modifications du fichier login-config.xml sur le serveur Application Engine.
    8. Redémarrez JBoss Application Server.
  7. 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 exécute 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).

  8. (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é. 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.

    1. Editez le fichier log4j.xml (JBOSS_home/server/nom_de_serveur/conf/log4j.xml).
    2. Modifiez toutes les valeurs de seuil et de priorité d'"INFO", de "DEBUG", ou de "TRACE" en "ERROR".
    3. Supprimez ou mettez en commentaire "Preserve messages in a local file" pour arrêter le journal serveur.
    4. 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

    5. Editez web.xml et définissez logVerbosityLevel à "FATAL".

      Emplacement de web.xml :

      JBoss_Home/server/nom_de_serveur/deploy/jbossweb-tomcat55.sar/conf

    6. Redémarrez le serveur JBoss Application Server.


Commentaires

Dernière mise à jour : Novembre 2010


© Copyright IBM Corp. 2010.
Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)