FileNet P8 Workplace XT, Version 1.1.5       Anwendungsserver:  JBOSS Application Server     

JBoss Application Server für Workplace XT konfigurieren

Bevor Sie die Workplace XT-Webanwendung verwenden können, müssen Sie die Anwendung so konfigurieren, dass sie mit JBoss Application Server verwendet werden kann.

So konfigurieren Sie JBoss Application Server:
  1. Stoppen Sie JBoss Application Server, falls der Server aktiv ist.
  2. Konfigurieren Sie die LDAP-Einstellungen auf dem Workplace XT-Server so, dass sie genau mit den Content Engine-Einstellungen übereinstimmen.
    Tipp: Erstellen Sie eine Backup-Kopie der Datei login-config.xml, bevor Sie Änderungen vornehmen.
    1. Öffnen Sie auf dem Workplace XT-Server die Datei login-config.xml (inJBoss-Ausgangsverzeichnis/server/Servername/conf) zum Bearbeiten.
    2. Fügen Sie einen identischen Eintrag <application-policy name="FileNet"> hinzu, der mit dem entsprechenden Eintrag in der Datei login-config.xml auf dem Content Engine-Server übereinstimmt. Dieser Eintrag muss am Ende der Datei vor der letzten Zeile </policy> hinzugefügt werden.
      <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>

    Sie können diesen Eintrag aus der Content Engine-Datei login-config.xml kopieren. Wenn Sie keine benutzerdefinierten Einträge in der Datei auf Ihrem Workplace XT-Server haben, können Sie die gesamte Datei aus Content Engine kopieren und die Datei login-config.xml auf dem Workplace XT-Server überschreiben.

  3. Legen Sie die Berechtigungen für den Benutzer fest, der den Anwendungsserver ausführt.

    Falls der Benutzer, der den Anwendungsserver später ausführen wird, ein anderer Benutzer ist, als der, der Workplace XT installiert hat, müssen Sie dem Benutzer die Lese-/Schreibberechtigungen für folgenden Ordner erteilen:

    Installationspfad/IBM/FileNet/WebClient

    Unter Windows ist dies nur für NTFS-formatierte Partitionen erforderlich.

  4. (Nur JBoss Application Server 5.0.1) Entfernen Sie die JSF 1.2-Komponente, die Teil der Installation von JBoss Application Server 5.0.1 ist.

    Durch das Entfernen der Dateien und Verweise auf Dateien in der Datei web.xml kann JBoss Application Server die JSF 1.1-Komponente verwenden, die von Workplace XT bereitgestellt wird.

    1. Löschen Sie alle JAR-Dateien unter dem Ordner jsf-libs des Web-Servers, löschen Sie jedoch nicht den Ordner jsf-libs:

      JBoss-Ausgangsverzeichnis/server/Servername/deploy/jbossweb.sar/jsf-libs

    2. Öffnen Sie die Datei web.xml (JBoss-Ausgangsverzeichnis/server/default/deployers/jbossweb.deployer/web.xml) zur Bearbeitung.
    3. Ändern Sie die Datei web.xml, indem Sie die Verweise auf die Implementierung von JSF 1.2 auf Kommentar setzen, wie im folgenden Beispiel gezeigt.
      <!--
      <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. Löschen Sie alle Dateien und Ordner in den folgenden temporären Verzeichnissen:

    JBoss-Ausgangsverzeichnis/server/Servername/tmp/deploy/

    JBoss-Ausgangsverzeichnis/server/Servername/work/jboss.web/localhost

  6. Inaktivieren Sie die JBoss Application Server-Protokollierung, um ein nicht erwartetes Verhalten in der implementierten IBM® FileNet-Software zu verhindern.

    Ist die Protokollierung inaktiviert, werden weiterhin Fehlernachrichten in der JBoss Application Server-Konsole angezeigt.

    1. Öffnen Sie die Datei log4j.xml oder jboss-log4j.xml (JBoss-Ausgangsverzeichnis/server/Servername/conf/log4j.xml) zur Bearbeitung.
    2. Fügen Sie die folgende Zeile (in Fettdruck) für den Appender FILE unter dem Abschnitt Preserve messages in a local file hinzu:
      <!-- 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. Ändern Sie alle Schwellenwerte und Prioritätswerte von:

      INFO

      DEBUG

      TRACE

      in:

      ERROR

      Hiervon ausgenommen ist der Schwellenwert des Appenders CONSOLE. Dieser muss auf INFO gesetzt werden, wie unten in Fettdruck gezeigt:
      <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. Fügen Sie IBM FileNet-spezifische Kategorien hinzu, um exzessive Tracenachrichten in der Konsole zu verhindern, die die Leistung beeinträchtigen können. Fügen Sie am Ende des Abschnitts Limit categories direkt vor dem Abschnitt Setup the Root category Folgendes hinzu:
      <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>

      Wenn andere IBM FileNet-spezifische Tracenachrichten in der Befehlskonsole die Leistung beeinträchtigen, fügen Sie für diese Nachrichten zusätzliche Kategorien hinzu.

    5. Entfernen Sie ggf. den Prioritätswert für die Rootkategorie wie im Folgenden in Fettdruck gezeigt:
      <!-- ======================= -->
      <!-- Setup the Root category -->
      <!-- ======================= -->
      <root>
      <priority value="ERROR"/>
      <appender-ref ref="CONSOLE"/>
      <appender-ref ref="FILE"/>
      </root>
    6. Speichern und schließen Sie die Datei log4j.xml.
  7. Optional: Starten Sie JBoss Application Server wie folgt, um zu überprüfen, ob die Konfigurationsänderungen erfolgreich waren:
    Option Bezeichnung
    UNIX ./run.sh
    Windows run.bat


Feedback

Letzte Aktualisierung: März 2013
wxtip031.htm

© Copyright IBM Corp. 2013.
Dieses Information Center basiert auf Eclipse-Technologie. (http://www.eclipse.org)