FileNet P8 Application Engine, Versión 5.0.+       Servidor de aplicaciones:  JBOSS Application Server     

Configuración de Application Engine en JBoss Application Server

Tras instalar el servidor de Application Engine, debe configurar JBoss Application Server para trabajar con Application Engine. También puede configurar cambios para modalidades opcionales como SSO.

High availability Recuerde: En entornos en clúster y de conjunto de servidores, configure Application Engine en JBoss Application Server en todos los nodos.
High availability clustered server environments Recuerde: En configuraciones de servidores en clúster de alta disponibilidad, para realizar las tareas que requieren valores de máquina virtual Java™ (JVM), asegúrese de realizar estos cambios en todos los nodos de la configuración del servidor de aplicaciones.

Para configurar JBoss Application Server para Application Engine:

  1. Detenga JBoss Application Server, si se está ejecutando.
  2. Haga una copia de seguridad del archivo run.conf y el script de inicio, dependiendo de la plataforma:
    Opción Descripción
    UNIX® run.sh
    Windows® run.bat
  3. Edite los valores Java del archivo run.conf.
    1. Añada una línea para especificar la vía de acceso del JDK proporcionada por JBoss Application Server, tal como se muestra en el siguiente ejemplo (Windows): set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_06

      Si el JDK no es el de la versión 1.5.0, sustituya su versión por la que aparece en la lista.

    2. Actualice los valores de memoria de JAVA_OPTS.

      Si ajusta este valor, evitará que el servidor de aplicaciones se quede sin memoria, una condición en la que los usuarios no pueden iniciar una sesión en Workplace.

      En la línea JAVA_OPTS, cambie los valores de -Xms y -Xmx de su configuración.

      Por ejemplo (Windows): set JAVA_OPTS=%JAVA_OPTS% -Xms 128m -Xmx 512 m

      Consulte la recomendación del proveedor del servidor de aplicaciones para los valores de tamaño de almacenamiento dinámico inicial y máximo. Para ver las recomendaciones específicas de IBM®, consulte la publicación IBM FileNet P8 Performance Tuning Guide.

    3. (Sólo para usuarios de JVM) Establezca el valor de MaxPermSize de JAVA_OPTS en 128m, de la siguiente manera:

      UNIX

      JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m

      Windows

      set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m

      Este aumento del valor evita que se produzcan errores de falta de memoria, que pueden detener JBoss Application Server.

    4. Si el servidor de aplicaciones utiliza la JVM de IBM, edite la variable JAVA_OPTS en el archivo run.conf inmediatamente después de la línea en el subpaso anterior. Esta edición de JAVA_OPTS mejora el rendimiento.
      UNIX
      Busque la línea siguiente en el archivo run.conf:

      JAVA_OPTS="$JAVA_OPTS

      y cámbiela por ésta (sin un retorno de carro):

      JAVA_OPTS="$JAVA_OPTS -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"

      Windows
      Busque la línea siguiente en el archivo run.conf:

      set JAVA_OPTS=%JAVA_OPTS%

      y cámbiela por ésta (sin un retorno de carro):

      set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5

    5. Guarde las ediciones y cierre el archivo.
  4. Configure el inicio de sesión de JAAS.

    Añada uno de los valores siguientes después de la entrada "$JAVA" $JAVA_OPTS (UNIX) o "%JAVA%" %JAVA_OPTS (Windows) en el archivo run.sh para UNIX o run.bat para Windows.

    Importante: Especifique la entrada jaas_login en una sola línea, sin saltos de línea. No copie y pegue el texto de esta guía, ya que el formato oculto puede provocar problemas con la entrada. En su lugar, escriba la entrada en el script.

    Es posible que su vía de acceso sea algo diferente, dependiendo de la versión de las instalaciones del cliente, o de si ha elegido una vía de acceso personalizada para la instalación. Compruebe la ubicación del archivo antes de especificar la vía de acceso.

    UNIX
    "$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. Guarde y cierre el archivo run.sh o run.bat.
  6. Configure los valores LDAP en Application Engine para que coincidan exactamente con los valores de Content Engine.
    1. En el servidor de Application Engine, abra login-config.xml, que se encuentra en inicio_JBoss/server/nombre_servidor/conf, para editarlo.
    2. Establezca la entrada <application-policy name="FileNet"> para que coincida exactamente con la entrada correspondiente en el archivo login-config.xml del servidor de Content Engine.
    3. Establezca la entrada <application-policy name="FileNetP8Engine"> para que coincida exactamente con la entrada correspondiente en el archivo login-config.xml del servidor de Content Engine.
    4. Copie la nueva entrada <application-policy name="FileNetP8Engine"> y pegue la entrada copia directamente antes de la entrada que ha copiado (<application-policy name="FileNetP8Engine">).
    5. Cambie la primera instancia de <application-policy name="FileNetP8Engine"> por <application-policy name="FileNetP8">.
    6. Mueva todas las entradas <application-policy name=> relacionadas con FileNet encima de la entrada <application-policy name="other">.
    7. Guarde los cambios en el archivo login-config.xml en el servidor de Application Engine.
    8. Reinicie JBoss Application Server.
  7. Establezca los permisos para el usuario que ejecute el servidor de aplicaciones.

    En Windows, lo siguiente sólo es necesario para particiones formateadas de NTFS.

    Si el usuario que ejecuta el servidor de aplicaciones es distinto del usuario que ha instalado Application Engine, debe asignar al usuario permisos de lectura y escritura en la carpeta donde se ha instalado Application Engine (vía_acceso_instalación_AE).

  8. (Opcional) Inhabilite el registro de JBoss Application Server.

    En la modalidad de desarrollo, JBoss Application Server crea muchos mensajes de registro de acceso HTTP, "INFO", "DEBUG" y "TRACE". Esto puede generar un comportamiento inesperado en el software de IBM FileNet desplegado. Puede limitar este tipo de registro excesivo de JBoss Application Server.

    Cuando se inhabilita el registro, los mensajes de error continúan apareciendo en la consola de JBoss Application Server.

    1. Abra el archivo log4j.xml (inicio_JBOSS/server/nombre_servidor/conf/log4j.xml) para editarlo.
    2. Cambie todos los valores de umbral y de prioridad de "INFO", "DEBUG" o "TRACE" por "ERROR".
    3. Suprima o comente la sección "Conservar mensajes en un archivo local" para desactivar el registro del servidor.
    4. Para desactivar el registro de acceso de HTTP, abra jboss-service.xml con un editor de texto y suprima o comente la sección "Registrador de acceso".

      Ubicación de jboss-service.xml:

      inicio_JBoss/server/nombre_servidor/deploy/jbossweb-tomcat55.sar/META-INF

    5. Abra web.xml para editarlo y cambie el logVerbosityLevel a "FATAL".

      Ubicación de web.xml:

      inicio_JBoss/server/nombre_servidor/deploy/jbossweb-tomcat55.sar/conf

    6. Reinicie el servidor de JBoss Application Server.


Comentarios

Última actualización: Noviembre de 2010


© Copyright IBM Corp. 2010.
Este Information Center se basa en la tecnología Eclipse. (http://www.eclipse.org)