FileNet P8 Application Engine, V 5.2.1       应用程序服务器:  JBOSS Application Server     

JBoss Application Server 上配置 Application Engine

在安装 Application Engine 服务器之后,必须配置 JBoss Application Server 才能使用 Application Engine。另外,还可以为 SSO 之类的可选方式配置更改。

关于此任务

High availability切记: 在场环境和集群环境中,在所有节点上对 JBoss Application Server 配置 Application Engine
High availability clustered server environments切记: 在高可用性集群服务器配置中,要执行需要 Java™ 虚拟机 (JVM) 设置的步骤,请确保对应用程序服务器配置中的每个节点进行这些更改。

要为 Application Engine 配置 JBoss Application Server,请完成下列步骤:

过程

  1. 如果 JBoss Application Server 实例处于运行状态,请将其停止。
  2. 根据平台的不同,备份 run.conf(AIX®、HPUX、Linux、Linux on System z® 和 Solaris)或 run.conf.bat (Windows) 文件和启动脚本:
    选项 描述
    AIX、HPUX、Linux、Linux on System z 和 Solaris run.sh
    Windows 和 JBoss 5.0 run.bat
    Windows 和 JBoss 5.1 run.conf.bat
  3. 编辑 run.shrun.confrun.conf.bat 文件 Java 设置:
    1. 添加一行以指定 JBoss Application Server 所提供的 JDK 的路径,如以下示例所示 (Windows): set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_06

      如果您的 JDK 版本不是 V1.5.0,请将以上版本替换为您的版本。

    2. 更新 JAVA_OPTS 内存设置。

      调整此设置旨在避免应用程序服务器耗尽内存,在这种情况下,用户将无法登录到 Workplace

      JAVA_OPTS 行中,根据您的配置来更改 -Xms 和 -Xmx 值。

      示例 (Windows):set JAVA_OPTS=%JAVA_OPTS% -Xms 128m -Xmx 512m

      请参阅应用程序服务器供应商有关初始堆大小值和最大堆大小值的建议。要获取 IBM® 的特定建议,请参阅IBM FileNet® P8组件进行性能调整

    3. (仅限于 Sun JVM 用户)将 JAVA_OPTS 中的 MaxPermSize 值设为 128m,如下所示:

      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

      增大此值旨在防止发生可能导致 JBoss Application Server 停止的耗尽内存错误。

    4. 如果应用程序服务器使用 IBM JVM,请编辑 run.confrun.conf.bat 文件中紧跟在上一子步骤中的行之后的 JAVA_OPTS 变量。此项 JAVA_OPTS 编辑有助于提高性能。
      AIX、HPUX、Linux、Linux on System z 和 Solaris
      run.conf 文件中找到下面这一行:
      JAVA_OPTS="$JAVA_OPTS
      将其更改为(请不要换行):
      JAVA_OPTS="$JAVA_OPTS -Dfilenet.pe.peorb.pool.min=2 
      -Dfilenet.pe.peorb.pool.max=5"
      Windows
      run.batrun.conf.bat 文件中找到以下一行:

      set JAVA_OPTS=%JAVA_OPTS%

      将其更改为(请不要换行):

      set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2 
      -Dfilenet.pe.peorb.pool.max=5
    5. High availability对于高可用性环境,请配置 JNDI 查询以连接到 Content Engine 并允许进行故障转移。
      在每个节点上,编辑 run.batrun.sh 文件以使它包含以下内容(在同一行中输入):
      -DFileNet.EJB.ContextProperties=java.naming.factory.initial=
      org.jboss.naming.NamingContextFactory
    6. 保存编辑并关闭文件。
  4. 配置 JAAS 登录。

    run.sh 文件中,正好在 "$JAVA" $JAVA_OPTS(AIX、HPUX、Linux、 Linux on System z 和 Solaris)或 "%JAVA%" %JAVA_OPTS (Windows) 条目之后添加下列其中一项。

    要点: 在一行输入 jaas_login 条目,请不要换行。请不要从本指南中复制并粘贴文本,这是因为,隐藏的格式控制字符会导致条目出现问题。而是,您应该在脚本中输入该条目。

    根据客户机安装版本不同以及您是否选择定制安装路径,路径可能略有不同。因此,在输入路径之前,请验证文件位置。

    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. 保存并关闭 run.shrun.batrun.conf.bat 文件。
  6. Application Engine 配置 LDAP 设置并使这些设置与 Content Engine 设置完全匹配。
    1. Application Engine 服务器上,打开 JBoss_home/server/server_name/conf 中的 login-config.xml 以进行编辑。
    2. 设置 <application-policy name="FileNet"> 条目,使其与 Content Engine 服务器上 login-config.xml 文件中的相应条目完全相同。
    3. 设置 <application-policy name="FileNetP8Engine"> 条目,使其与 Content Engine 服务器上 login-config.xml 文件中的相应条目完全相同。
    4. 复制新的 <application-policy name="FileNetP8Engine"> 条目,并将该条目正好粘贴到您所复制的条目 (<application-policy name="FileNetP8Engine">) 之前。
    5. 将 <application-policy name="FileNetP8Engine"> 的第一个实例更改为 <application-policy name="FileNetP8">。
    6. 将所有与 FileNet 相关的 <application-policy name=> 条目移至 <application-policy name="other"> 条目之前。
    7. 将更改保存到 Application Engine 服务器上的 login-config.xml 文件。
    8. 启动 JBoss Application Server 实例。
  7. 为运行应用程序服务器的用户设置许可权。

    在 Windows 上,以下需求仅适用于 NTFS 格式化的分区。

    如果运行应用程序服务器的用户有别于安装 Application Engine 的用户,那么必须将 Application Engine 所安装在的文件夹 (AE_install_path) 的读和写许可权授予该用户。

  8. (可选)禁用 JBoss Application Server 日志记录。

    在开发方式中,JBoss Application Server 会创建许多 HTTP 访问、INFO、DEBUG 和 TRACE 日志消息。这可能会导致所部署的 IBM FileNet 软件发生意外的行为。您可以对这种过度的 JBoss Application Server 日志记录进行限制。

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

    1. 打开 log4j.xml 文件 (JBOSS_home/server/server_name/conf/log4j.xml) 以进行编辑。
    2. 将所有阈值和优先级值从 INFO、DEBUG 或 TRACE 更改为 ERROR。
    3. 删除或注释掉 Preserve messages in a local file(将消息保留在本地文件中)以关闭服务器日志。
    4. 要关闭 HTTP 访问日志记录,请使用文本编辑器来打开 jboss-service.xml 并删除或注释掉“Access logger”部分。

      jboss-service.xml 的位置:

      JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/META-INF

    5. 打开 web.xml 以进行编辑并将 logVerbosityLevel 更改为 FATAL。

      web.xml 的位置:

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

    6. 重新启动 JBoss Application Server 实例。


最近一次更新时间: 2016 年 3 月
p8pin061.htm

© Copyright IBM Corporation 2013, 2016.