FileNet P8 Application Engine, Version 5.2.1       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).

Pourquoi et quand exécuter cette tâche

High availabilityA faire : Dans les environnements en parc ou en cluster, configurez Application Engine sur JBoss Application Server sur tous les noeuds.
High availability clustered server environmentsA faire : 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 :

Procédure

  1. Arrêtez l'instance JBoss Application Server si elle fonctionne.
  2. Faites une copie de sauvegarde du fichier run.conf (AIX, HPUX, Linux, Linux on System z, Solaris) ou run.conf.bat (Windows) et du script de démarrage, en fonction de votre plateforme :
    Option Description
    AIX, HPUX, Linux, Linux on System z, Solaris run.sh
    Windows et JBoss 5.0 run.bat
    Windows et JBoss 5.1 run.conf.bat
  3. Editez les paramètres Java du fichier run.sh, run.conf, ou run.conf.bat :
    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 segment de mémoire initiale et maximale. Pour des recommandations IBM® spécifiques, voir Optimisation des performances des composants IBM FileNet P8 .

    3. (Utilisateurs de la machine virtuelle Java Sun seulement) Attribuez la valeur 128m à MaxPermSize dans JAVA_OPTS, comme suit :

      AIX, HPUX, Linux, Linux on System z, Solaris

      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 IBM, éditez la variable JAVA_OPTS dans le fichier run.conf ou run.conf.bat immédiatement après la ligne mentionnée ci-dessus. Cette modification de JAVA_OPTS améliore les performances.
      AIX, HPUX, Linux, Linux on System z, Solaris
      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
      Recherchez la ligne suivante dans le fichier run.bat ou run.conf.bat :

      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. High availabilityPour les environnements à haute disponibilité, configurez la recherche JNDI pour une connexion à Content Engine et autorisez la reprise en ligne.
      Sur chaque noeud, éditez le fichier run.bat ou run.sh et ajoutez ce qui suit, sur une seule ligne :
      -DFileNet.EJB.ContextProperties=java.naming.factory.initial=
      org.jboss.naming.NamingContextFactory
    6. Sauvegardez et fermez le fichier.
  4. Configurez la connexion JAAS.

    Ajoutez l'une des propositions suivantes tout de suite après "$JAVA" $JAVA_OPTS (AIX, HPUX, Linux, Linux on System z, Solaris) ou l'entrée "%JAVA%"%JAVA_OPTS (Windows) dans le fichier run.sh ou le fichier run.bat, respectivement

    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.

    AIX, HPUX, Linux, Linux on System z, Solaris
    "$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. Enregistrez et fermez le fichier run.sh, run.bat ou run.conf.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. Démarrez l'instance JBoss Application Server.
  7. Définissez les droits de l'utilisateur exécutant le serveur d'applications.

    Sous Windows, les conditions suivantes sont applicables uniquement aux 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 HTTP Access, INFO, DEBUG et TRACE dans les journaux. 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. Remplacez toutes les valeurs de seuil et de priorité d'INFO, de DEBUG, ou de TRACE par ERROR.
    3. Supprimez ou mettez en commentaire Preserve messages in a local file pour arrêter le journal du 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 le fichier web.xml et remplacez la valeur de logVerbosityLevel par FATAL.

      Emplacement de web.xml :

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

    6. Redémarrez l'instance de JBoss Application Server.


Dernière mise à jour : Mars 2016
p8pin061.htm

© Copyright IBM Corp. 2013, 2016.