FileNet P8 Application Engine, Versión 5.2.1       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.

Acerca de esta tarea

High availabilityRecuerde: 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 environmentsRecuerde: 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:

Procedimiento

  1. Detenga la instancia JBoss Application Server si se está ejecutando.
  2. Realice una copia de seguridad del archivo run.conf (AIX, HPUX, Linux, Linux on System z, Solaris) o run.conf.bat (Windows) y del script de inicio, dependiendo de su plataforma:
    Opción Descripción
    AIX, HPUX, Linux, Linux on System z, Solaris run.sh
    Windows y JBoss versión 5.0 run.bat
    Windows y JBoss versión 5.1 run.conf.bat
  3. Edite la configuración Java de los archivos run.sh, run.conf o run.conf.bat:
    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.

      Ajustar este valor evita que el servidor de aplicaciones se quede sin memoria, una condición en la que los usuarios no podrían iniciar la 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 conocer las recomendaciones específicas de IBM®, consulte Ajuste de rendimiento de los componentes de IBM FileNet P8.

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

      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

      Este aumento de valor evita 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 del archivo run.conf o run.conf.bat inmediatamente después de la línea del subpaso anterior. Esta edición de JAVA_OPTS mejora el rendimiento.
      AIX, HPUX, Linux, Linux on System z, Solaris
      Busque la siguiente línea 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 siguiente línea en el archivo run.bat o run.conf.bat:

      set JAVA_OPTS=%JAVA_OPTS%

      y cámbiela por esta (sin retorno de carro):

      set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2 
      -Dfilenet.pe.peorb.pool.max=5
    5. High availabilityEn entornos de alta disponibilidad, configure la búsqueda JNDI para conectarse a Content Engine y permitir la migración tras error.
      En cada nodo, edite el archivo run.bat o run.sh para incluir lo siguiente, especificado en una sola línea:
      -DFileNet.EJB.ContextProperties=java.naming.factory.initial=
      org.jboss.naming.NamingContextFactory
    6. Guarde las ediciones y cierre el archivo.
  4. Configure el inicio de sesión de JAAS.

    Añada uno de los siguientes inmediatamente después de la entrada "$JAVA" $JAVA_OPTS (AIX, HPUX, Linux, Linux on System z, Solaris) o "%JAVA%" %JAVA_OPTS (Windows) en el archivo run.sh o el archivo run.bat, respectivamente

    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.

    La vía de acceso puede ser ligeramente diferente en función de la versión de las instalaciones de cliente o de si ha elegido una vía de acceso personalizada para la instalación. Verifique la ubicación del archivo antes de especificar la vía de acceso.

    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. Guarde y cierre el archivo run.sh, run.bat o run.conf.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. Inicie la instancia de JBoss Application Server.
  7. Establezca los permisos para el usuario que ejecuta el servidor de aplicaciones.

    En Windows, el siguiente requisito solo se aplica a particiones formateadas 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 modalidad de desarrollo, JBoss Application Server crea varios mensajes de registro HTTP Access, 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 (directorio_inicial_JBOSS/server/nombre_servidor/conf/log4j.xml) para editarlo.
    2. Cambie todos los valores de umbral y valores de prioridad de INFO, DEBUG o TRACE a ERROR.
    3. Suprima o comente Conservar mensajes en un archivo local para desactivar el registro del servidor.
    4. Para desactivar el registro de acceso HTTP, abra el archivo jboss-service.xml con un editor de texto u suprima o comente la sección "Access logger".

      Ubicación de jboss-service.xml:

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

    5. Abra web.xml para editar y cambiar el valor de logVerbosityLevel a FATAL.

      Ubicación de web.xml:

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

    6. Reinicie la instancia de JBoss Application Server.


Última actualización: Octubre de 2015
p8pin061.htm

© Copyright IBM Corp. 2013, 2015.