FileNet P8 Workplace XT, Version 1.1.5       Serveur d'applications :  JBOSS Application Server     

Configuration de JBoss Application Server pour Workplace XT

Avant de pouvoir utiliser l'application Web Workplace XT, vous devez d'abord la configurer pour qu'elle fonctionne avec JBoss Application Server.

Pour configurer JBoss Application Server, procédez comme suit :
  1. Arrêtez JBoss Application Server s'il est en cours.
  2. Configurez les paramètres LDAP sur le serveur Workplace XT de sorte qu'ils correspondent exactement aux paramètres de Content Engine.
    Conseil : Créez une copie de sauvegarde du fichier login-config.xml avant d'effectuer les modifications.
    1. Sur le serveur Workplace XT, éditez login-config.xml, situé dans racine JBoss/server/nom du serveur/conf.
    2. Ajoutez l'entrée <application-policy name="FileNet">, identique à celle du fichier login-config.xml sur le serveur Content Engine. Cette entrée doit être ajoutée à la fin du fichier, avant la dernière ligne </policy>.
      <authentication>
      <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" 
      flag="required"/>
      </authentication>
      </application-policy>
      <application-policy name="FileNet">
      <authentication>
      <login-module code="org.jboss.security.auth.spi.LdapExtLoginModule" 
      flag="sufficient">
      <module-option name="java.naming.provider.url">ldap://cm-nihuevm9:389
      </module-option>
      <module-option name="java.naming.security.authentication">simple
      </module-option>
      <module-option name="allowEmptyPasswords">false</module-option>
      <module-option name="bindDN">cn=ceadmin,ou=shared,ou=engineering,
      ou=filenet,dc=apple</module-option>
      <module-option name="bindCredential">Password1</module-option>
      <module-option name="baseCtxDN">dc=apple</module-option>
      <module-option name="baseFilter">(cn={0})</module-option>
      <module-option name="rolesCtxDN">dc=apple</module-option>
      <module-option name="roleFilter">(cn={0})</module-option>
      <module-option name="roleAttributeID">memberOf</module-option>
      <module-option name="roleAttributeIsDN">true</module-option>
      <module-option name="roleRecursion">-1</module-option>
      </login-module>
      </authentication>
      </application-policy>
      </policy>

    Vous pouvez copier l'entrée du fichier login-config.xml du serveur Content Engine. Si le fichier login-config.xml sur le serveur Workplace XT ne contient pas d'entrées personnalisées, vous pouvez le remplacer directement par celui du serveur Content Engine.

  3. Définissez les droits de l'utilisateur exécutant le serveur d'applications.

    Si l'utilisateur qui exécute le serveur d'applications n'est pas celui qui a installé Workplace XT, vous devez lui donner les droits de lecture et d'écriture sur le dossier suivant :

    chemin d'installation/IBM/FileNet/WebClient

    Sous Windows, ce qui suit n'est nécessaire que pour les partitions formatées NTFS.

  4. (JBoss Application Server 5.0.1 seulement) Supprimez JSF 1.2 dans l'installation JBoss Application Server 5.0.1.

    La suppression des fichiers et des références aux fichiers dans le fichier web.xml permet à JBoss Application Server d'utiliser JSF 1.1 fourni dans Workplace XT.

    1. Supprimez tous les fichiers jar du dossier jsf-libs sur le serveur Web, mais ne supprimez pas le dossier jsf-libs :

      racine JBoss/server/nom du serveur/deploy/jbossweb.sar/jsf-libs

    2. Editez le fichier web.xml (racine JBoss/server/default/deployers/jbossweb.deployer/web.xml).
    3. Dans le fichier web.xml, mettez en commentaire les références à l'implémentation de JSF 1.2, comme dans l'exemple suivant.
      <!--
      <context-param>
      <param-name>com.sun.faces.injectionProvider</param-name>
      <param-value>org.jboss.web.jsf.integration.injection.
      JBossDelegatingInjectionProvider</param-value>
      </context-param>
       -->
      <!--
      <listener>
      <listener-class>org.jboss.web.jsf.integration.config.
      JBossJSFConfigureListener</listener-class>
      </listener>
      -->
      
      <!--
      <listener>
      <listener-class>com.sun.faces.application.WebappLifecycleListener
      </listener-class>
      </listener>
       -->
      
       <!--
      <init-param>
      <description>JSF standard tlds</description>
       <param-name>tagLibJar0</param-name>
      <param-value>jsf-libs/jsf-impl.jar</param-value>
      </init-param>
      <init-param>
      <description>JSTL standard tlds</description>
      <param-name>tagLibJar1</param-name>
      <param-value>jstl.jar</param-value>
      </init-param>
       -->
  5. Supprimez tous les fichiers et tous les dossiers dans les répertoires temporaires suivants :

    racine JBoss/server/nom du serveur/tmp/deploy

    racine JBoss/server/nom du serveur/work/jboss.web/localhost

  6. Désactivez la consignation JBoss Application Server pour éviter un comportement inattendu dans le logiciel IBM® FileNet déployé.

    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 ou jboss-log4j.xml (racine JBoss/server/nom du serveur/conf/log4j.xml).
    2. Ajoutez la ligne suivante (en gras) pour l'ajouteur FILE, sous la section Preserve messages in a local file :
      <!-- A time/date based rolling appender -->
      <appender name="FILE" class= "org.jboss.logging.appender.
      DailyRollingFileAppender">
      <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
      <param name="File" value="${jboss.server.log.dir}/server.log"/>
      <param name="Append" value="false"/>
      <param name="Threshold" value="ERROR"/>
    3. Remplacez toutes les valeurs de seuil et de priorité

      INFO

      DEBUG

      TRACE

      par

      ERROR

      sauf pour l'ajouteur CONSOLE, dont la valeur de seuil doit être INFO, comme ci-dessous :
      <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
      <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
      <param name="Target" value="System.out"/>
      <param name="Threshold" value="INFO"/>
    4. Ajoutez les catégories spécifiques à IBM FileNet, afin d'éviter la multiplication des messages de trace dans la console et de maintenir les performances. Ajoutez les lignes qui suivent à la fin de la section Limit categories, juste avant la section Setup the Root category :
      <category name="filenet_error.api">
      <priority value="ERROR"/>
      </category>
      <category name="filenet_tracing.api">
      <priority value="OFF"/>
      </category>
      
      <category name="com.filenet.wcm.api">
      <priority value="ERROR"/>
      </category>
      
      <category name="com.filenet-trace">
      <priority value="OFF"/>
      </category>
      
      <category name="com.filenet-debug">
      <priority value="ERROR"/>
      </category>

      Si d'autres messages de trace spécifiques à IBM FileNet s'affichent dans la console et affectent les performances, ajoutez également les catégories de ces messages.

    5. Si elle est définie, supprimez la valeur de priorité de la catégorie Root, en gras ci-dessous :
      <!-- ======================= -->
      <!-- Setup the Root category -->
      <!-- ======================= -->
      <root>
      <priority value="ERROR"/>
      <appender-ref ref="CONSOLE"/>
      <appender-ref ref="FILE"/>
      </root>
    6. Sauvegardez et fermez le fichier log4j.xml.
  7. Facultatif : Démarrez JBoss Application Server à l'aide des commandes suivantes, pour vérifier que les changements de configuration ont bien été pris en compte :
    Option Description
    UNIX ./run.sh
    Windows run.bat


Commentaires

Dernière mise à jour : Mars 2013
wxtip031.htm

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