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


Para configurar JBoss Application Server para Application Engine:
Procedimiento
- Detenga la instancia JBoss Application Server si se está ejecutando.
- 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 - Edite la configuración Java de los archivos run.sh, run.conf
o run.conf.bat:
- 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.
- 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.
- (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.
- 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:
y cámbiela por ésta (sin un retorno de carro):JAVA_OPTS="$JAVA_OPTS
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
En 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
- Guarde las ediciones y cierre el archivo.
- 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
- 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 %*
- Guarde y cierre el archivo run.sh, run.bat o run.conf.bat.
- Configure los valores LDAP en Application Engine
para que coincidan exactamente con los valores de
Content Engine.
- En el servidor de Application Engine, abra login-config.xml, que se encuentra en inicio_JBoss/server/nombre_servidor/conf, para editarlo.
- 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.
- 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.
- 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">).
- Cambie la primera instancia de <application-policy name="FileNetP8Engine"> por <application-policy name="FileNetP8">.
- Mueva todas las entradas <application-policy name=> relacionadas con FileNet encima de la entrada <application-policy name="other">.
- Guarde los cambios en el archivo login-config.xml en el servidor de Application Engine.
- Inicie la instancia de JBoss Application Server.
- 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).
- (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.
- Abra el archivo log4j.xml (directorio_inicial_JBOSS/server/nombre_servidor/conf/log4j.xml) para editarlo.
- Cambie todos los valores de umbral y valores de prioridad de INFO, DEBUG o TRACE a ERROR.
- Suprima o comente Conservar mensajes en un archivo local para desactivar el registro del servidor.
- 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
- 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
- Reinicie la instancia de JBoss Application Server.
Última actualización: Marzo de 2016
p8pin061.htm
© Copyright IBM Corp. 2013, 2016.