FileNet P8 Workplace XT, 版本 1.1.5       應用程式伺服器:  JBOSS Application Server     

針對 Workplace XT 配置 JBoss 應用程式伺服器

您必須先將 Workplace XT Web 應用程式配置成使用 JBoss 應用程式伺服器,之後才能使用該應用程式。

如果要配置 JBoss 應用程式伺服器,請執行下列動作:
  1. 停止 JBoss 應用程式伺服器(如果正在執行的話)。
  2. Workplace XT 伺服器上配置 LDAP 設定,使其完全符合 Content Engine 設定。
    提示: 變更之前,先建立 login-config.xml 檔的備份。
    1. Workplace XT 伺服器上,開啟位於 JBoss_home/server/server_name/conflogin-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 應用程式伺服器 5.0.1)移除屬於 JBoss 應用程式伺服器 5.0.1 安裝一部分的 JSF 1.2。

    移除檔案以及 web.xml 檔中的檔案參照,可讓 JBoss 應用程式伺服器 使用 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 應用程式伺服器 記載,以防止所部署的 IBM® FileNet® 軟體中出現非預期的行為。

    停用記載時,JBoss 應用程式伺服器 主控台中仍會顯示錯誤訊息。

    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

      其中不包括應設為 INFO 的 CONSOLE 附加器臨界值,如下列粗體所示:
      <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. 移除根種類的優先順序值(若有的話),如下列粗體所示:
      <!-- ======================= -->
      <!-- Setup the Root category -->
      <!-- ======================= -->
      <root>
      <priority value="ERROR"/>
      <appender-ref ref="CONSOLE"/>
      <appender-ref ref="FILE"/>
      </root>
    6. 儲存並關閉 log4j.xml 檔。
  7. 選擇性的: 如以下所示啟動 JBoss 應用程式伺服器,以驗證配置變更已成功:
    選項 敘述
    UNIX ./run.sh
    Windows run.bat


意見

前次更新: 2013 年 3 月
wxtip031.htm

© Copyright IBM Corp. 2013.
這個資訊中心採用 Eclipse 技術。(http://www.eclipse.org)