FileNet P8 Workplace XT, 版本 1.1.5       应用程序服务器:  JBOSS Application Server     

Workplace XT 配置 JBoss Application Server

在您可以使用 Workplace XT Web 应用程序之前,必须先将此应用程序配置为与 JBoss Application Server 一起运行。

要配置 JBoss Application Server,请完成下列步骤:
  1. 如果 JBoss Application Server 正在运行,请将它停止。
  2. Workplace XT 服务器上配置 LDAP 设置,以使这些设置与 Content Engine 设置精确匹配。
    提示: 在对 login-config.xml 文件进行更改之前,请备份该文件 。
    1. Workplace XT 服务器上,打开 JBoss_home/server/server_name/conf 中的 login-config.xml 以进行编辑。
    2. 添加一个完全相同的 <application-policy name="FileNet"> 条目,使它与 Content Engine 服务器上 login-config.xml 文件中的相应条目相匹配。应在文件末尾添加此条目,即,添加到最后一行 </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>

    您可以从 Content Engine login-config.xml 文件中复制此条目。如果您在 Workplace XT 服务器上的此文件中没有任何定制条目,那么可以从 Content Engine 中复制整个文件,用来覆盖 Workplace XT 服务器上的 login-config.xml 文件。

  3. 为运行应用程序服务器的用户设置许可权。

    如果将运行应用程序服务器的用户并不是已安装 Workplace XT 的用户,那么必须授予该用户对于以下文件夹的读/写许可权:

    install_path/IBM/FileNet/WebClient

    对于 Windows,只有 NTFS 格式分区才需要进行此授权。

  4. (仅适用于 JBoss Application Server 5.0.1)除去 JBoss Application Server 5.0.1 安装版本所包含的 JSF 1.2。

    除去文件以及 web.xml 文件中对于这些文件的引用,将使 JBoss Application Server 能够使用 Workplace XT 所提供的 JSF 1.1。

    1. 删除在 Web 服务器的 jsf-libs 文件夹下找到的所有 JAR 文件,但不要删除 jsf-libs 文件夹:

      JBoss_home/server/server_name/deploy/jbossweb.sar/jsf-libs

    2. 打开 web.xml 文件 (JBoss_home/server/default/deployers/jbossweb.deployer/web.xml) 以进行编辑。
    3. 修改 web.xml 文件以注释掉对于 JSF 1.2 实现的引用,如以下样本中所示。
      <!--
      <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. 清除下列临时目录中的所有文件和文件夹:

    JBoss_home/server/server_name/tmp/deploy

    JBoss_home/server/server_name/work/jboss.web/localhost

  6. 禁用 JBoss Application Server 日志记录,以防止已部署的 IBM® FileNet® 软件产生意外行为。

    禁用日志记录之后,错误消息仍将显示在 JBoss Application Server 控制台中。

    1. 打开 log4j.xmljboss-log4j.xml 文件 (JBoss_home/server/server_name/conf/log4j.xml) 以进行编辑。
    2. Preserve messages in a local file 这一部分,为 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. 将所有阈值和优先级值从下面这些值:

      INFO

      DEBUG

      TRACE

      更改为:

      ERROR

      但是,CONSOLE 追加器的阈值除外,应将此阈值设置为 INFO,如下所示,用粗体显示:
      <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. 添加特定于 IBM FileNet 的类别,以避免控制台中产生过多的跟踪消息,否则会影响性能。在 Limit categories 部分末尾,但是恰好在 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>

      如果命令控制台中的其他特定于 IBM FileNet 的跟踪消息会影响性能,请为这些消息添加其他类别。

    5. 如果有类别优先级值 Root,请将它除去,如下所示,用粗体显示:
      <!-- ======================= -->
      <!-- Setup the Root category -->
      <!-- ======================= -->
      <root>
      <priority value="ERROR"/>
      <appender-ref ref="CONSOLE"/>
      <appender-ref ref="FILE"/>
      </root>
    6. 保存 log4j.xml 文件,然后将它关闭。
  7. 可选: 按如下所示启动 JBoss Application Server,以验证是否成功更改了配置:
    选项 描述
    UNIX ./run.sh
    Windows run.bat


反馈

最近一次更新时间: 2013 年 3 月
wxtip031.htm

© Copyright IBM Corporation 2013.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)