Documentos de Académico
Documentos de Profesional
Documentos de Cultura
doc
U.T. - DAFP
Historial de Revisiones
TABLA DE CONTENIDOS
TABLA DE CONTENIDOS 3
INTRODUCCIÓN 4
1.1 INTRODUCCIÓN......................................................................................4
1.2 ALCANCE................................................................................................4
2 RESOLUCIÓN DE PROBLEMAS ESPECÍFICOS DE EJECUCIÓN EN CLIENTES RICH
WEB 5
2.1 Requisitos previos para la instalación del cliente Rich Web:...........................5
2.2 Problemas de instalación en el cliente Rich Web..........................................5
2.3 Ubicación de los archivos de trazas del cliente Rich Web...............................6
2.4 Problemas de ejecución en el cliente Rich Web............................................8
3 RESOLUCIÓN DE PROBLEMAS EN PORTALES SSE (SELF SERVICE DEL
EMPLEADO), CAROPP (OPORTUNIDADES DE EMPLEO), CASHCOMP (CASH
COMPENSATIONS) Y/O PASARELA RICH WEB (M4GATEWAY) 12
3.1 Ubicación de Trazas del Contenedor Java..................................................12
3.1.1 Ubicación de trazas en JRun 4.0....................................................12
3.1.2 Ubicación de Trazas en Tomcat......................................................12
3.2 Ubicación de los archivos de traza del servidor Web...................................13
3.2.1 Trazas Internet Information Services (IIS)......................................13
3.2.2 Trazas Sun One Web Server..........................................................15
3.2.3 Trazas IBM HTTP Server-Apache....................................................16
3.3 Ubicación de los archivos de trazas de la aplicación Web Meta4 SSE (Self
Service del Empleado), Caropp (Oportunidades de Empleo), CashComp (Cash
Compensations) y/o pasarela Rich Web (M4Gateway)...........................................16
3.4 Resolución de problemas en SSE (Self Service del Empleado), Caropp
(Oportunidades de Empleo), CashComp (Cash Compensations) y/o pasarela Rich Web
(M4Gateway)..................................................................................................17
4 RESOLUCIÓN DE PROBLEMAS DEL SERVIDOR DE APLICACIONES 20
4.1 Ubicación de los archivos de traza del servidor de aplicaciones....................20
4.2 Resolución de problemas del servidor de aplicaciones.................................20
5 RESOLUCIÓN DE PROBLEMAS EN LA ESTACIÓN DE DESARROLLO (CLIENTE
DISTRIBUIDO) 23
5.1 Ubicación de los archivos de traza en la estación de desarrollo (cliente
distribuido).....................................................................................................23
5.2 Resolución de problemas en la estación de desarrollo (cliente distribuido).....23
6 RESOLUCIÓN DE PROBLEMAS EN RAM-DL 28
6.1 Ubicación de los archivos de traza en RAM-DL...........................................28
6.2 Resolución de problemas en RAM-DL........................................................28
7 Resolución de problemas en el monitor de Servidores de aplicación (AppServer
Monitor) 30
INTRODUCCIÓN
1.1 INTRODUCCIÓN
1.2 ALCANCE
Rich Web es la plataforma del usuario final con perfiles de gestión de recursos humanos en
cualquiera de las instituciones involucradas. Está basada en tecnologías ActiveX y se
ejecuta dentro del navegador Internet Explorer. En este documento se presentan los
problemas más comunes en su instalación y ejecución, y se presentan las posibles
soluciones.
Usar versiones de sistema operativo Windows e Internet Explorer con versiones certificadas
por Meta41.
Tener instalados los componentes básicos del motor Intallshield versión 10.5.
Tener instalado el entorno Java (JRE) de acuerdo a la lista de certificaciones Meta4.
Tener una cuenta de usuario en sistema operativo con permisos administrativos para la
instalación de los componentes de Rich Web.
Permitir la ejecución de VBScript y componentes ActiveX Meta4 correspondientes a la
instalación del Cliente Rich Web desde la página de SIGEP.
No instalar el cliente de Rich Web en el mismo computador donde se ha instalado
previamente el cliente distribuido de Meta4 o se tenga planeado instalarlo
Deshabilitar la opción del navegador Internet Explorer llamada “Reutilizar las Ventanas
para lanzar vínculos”
Si se utiliza autenticación de Windows en IIS, verificar que se cuenta con los permisos de
acceso.
Verificar que se han instalado los servicios de actualización de componentes Rich Web
Meta4 (m4updateservices) y estos se ejecutan automáticamente al iniciar el computador.
1
Ver documento de matriz de certificaciones para Peoplenet 7.1 SP2
(SEPT08_Certif_71SP2_60SP6_ESP.doc)
“M4WindowsClient_Co
re -- Error 1406.Could
not write value to key
\CLSID\{XXXXXXXX-
XXXX-XXXX-XXXX-
XXXXXXXXXXXX}\Inp
rocServer32. System
error . Verify that you
have sufficient access
to that key, or contact
your support
personnel”
Se muestra el No está instalado el Runtime Debe instalar el Runtime
mensaje “Necesita Enviroment de Java (JRE). Enviroment de Java (JRE), de
tener una JRE de Java acuerdo a la matriz de
versión certificada certificaciones de Meta4.
para poder instalar la
aplicación” Nota: Esta instalación sólo aplica
para instalaciones locales del
cliente Rich Web
http://www.sitio.com/packages/c
ore/m4windowsclient_core.exe
http://www.sitio.com/packages/c
ore/m4packconfig.xml
</LOG>
Donde DebugDir indica la carpeta donde se ubican los archivos de traza. Adicionalmente,
Los parámetros SystemDebugLevel, SystemDebugEnable y SystemDebugDetailLevel sirven
para activar mayor detalle en la generación de trazas, cambiando su valor de 0 a 1.
de los siguientes You cannot build datos o al cliente Rich Web, a la versión del cliente Rich Web.
errores. Meta4Object Debe verificarse la
"SCH_SESSION" with correspondencia de versiones 3) Si las versiones del software
client/server type en ambos ambientes. instalado y la base de datos no
"Front". Please refer to corresponden, es necesario
other error 3) Se ha dañado alguna tabla actualizar el cliente de Rich Web.
messages.” de sistema en la base de datos
de Meta4. Nota: Para verificar la versión
“Incorrect version. tecnológica instalada en el cliente
The Meta4Object y en el servidor, buscar el archivo
version is "46080" and m4buildversion.dll y dar clic
the current application derecho, para ver los detalles de
version is "46723". la versión.
Please install the
application correctly.” 4) Si no fue posible resolver el
problema, contacte al proveedor
“Cannot get session de Meta4.
Meta4Object. Please
contact the
Administrator”
“Error (0-23-65)
Meta4Object mal
definido.”
“No se puede
construir el
Meta4Object
"SSC_APPUSER" de
tipo cliente-servidor
"Front".
Debe consultar otros
mensajes de error. “
“Error (0-30-4)
Licencia.
No es posible validar
la licencia
instalada.Error (0-17-
64) Meta4Object mal
definido.”
“Error (0-23-16) No
se puede construir el
Meta4Object de la
sesión
Debe consultar con el
administrador.”
“Error (0-23-65)
Meta4Object mal
definido.
No se puede construir
el Meta4Object
"SCH_SESSION" de
tipo cliente-servidor
"Front".
Debe consultar otros
mensajes de error.”
Antes de resolver cualquier problema con los portales de Meta4, es importante ubicar los
archivos de trazas o logs de la aplicación. A continuación se muestra como ubicar los
archivos de log de los principales componentes, incluyendo productos de terceros,
requeridos para la ejecución de un portal Meta4.
C:\jrun4\logs\<nombre_app>-debug.log
C:\jrun4\logs\<nombre_app>-info.log
C:\jrun4\logs\<nombre_app>-warn.log
C:\jrun4\logs\<nombre_app>-error.log
C:\jrun4\logs\<nombre_app>-fatal.log
C:\tomcat\logs\catalina.out
C:\tomcat\logs\catalina-yyyy-mm.dd.out
Para detectar posibles errores entre el conector del contenedor de servlets (JRun) y el
Servidor Web (IIS, SunOne, IBM HTTP Server-Apache), es necesario localizar los archivos
de bitácora del servidor Web.
De clic derecho para obtener sus propiedades, en la sección “Sitio Web”, buscar que esté
habilitado el check “Habilitar logs”
De clic en el botón “propiedades”, ahí se mostrarán las propiedades del archivo de traza o
log generado por IIS.
Para ubicar los archivos de trazas de Sun One Web Server, entrar a la consola de
administración, gestionar el sitio Web configurado y entrar a “preferentes\settings” buscar
los parámetros “Access Log” y “Error Log”
www.misitio.com_access_log
www.misitio.com_error_log
Para ubicar los archivos detallados de las trazas de las aplicaciones Web de Meta, es
necesario buscar, dentro del contexto de la aplicación Web, el archivo de configuración
“WEB-INF\classes\properties\m4logsystem.cfg” que contienen las propiedades de los
archivos de trazas de la aplicación Meta4. Este archivo contiene dos líneas clave para
detectar los errores de la aplicación, estas son
M4_LOG_DIR=C:/m4webservices/m4gateway/WEB-INF/classes/properties/log
M4_TRACE_LEVEL=info
Se muestra la siguiente tabla con la resolución a los problemas más comunes encontrados
en portales SSE (Self Service del Empleado), Caropp (Oportunidades de Empleo) y/o
CashComp (Cash Compensations)
3
Se recomienda dejar el valor “debug” (depuración) para ambientes de desarrollo y pruebas e
“info” (informativos) para ambientes de producción, pues info genera menor cantidad de
mensajes.
de JRun.
2.1) La integración entre el
Servidor JRun que contiene la 2) Reinicie, desde JRun o como
aplicación Web correspondiente servicio de Windows, la aplicación
y el servidor Web (IIS, SunOne, web correspondiente.
IBM HTTP Server-Apache) no se
ha realizado, está 2.1) Ejecute el proceso de
incorrectamente aplicada o se integración de una aplicación Web
ha corrompido (integración con en JRun con el servidor Web a
conector JRun). través del conector de JRun
(wsconfig.exe).
El portal muestra 1) Existe una alta demanda del 1) Verifique que el nivel de tráfico
únicamente sitio. del sitio se encuentre dentro de
páginas en niveles esperados de carga. Esto
blanco 2) Está activado el filtro de puede realizarse viendo los logs
compresión de3 Meta4 y está del servidor Web o leyendo las
utilizando JRun 4.0 Updater 6.0 trazas de JRun, si se tiene
sin haber aplicado el Hotfix que activado el monitoreo de recursos
corrige el bug 61205. de JRun.
a)
http://kb.adobe.com/selfservice/v
iewContent.do?
externalId=1f472255
b)
http://www.adobe.com/support/jr
un/updaters.html
realizarse la mensaje de error inicializarse correctamente aplicación Web para verificar una
autenticación posible causa del error en la
(login y “Error de 2) Se ha perdido la inicialización.
password) en el Meta4WebServices. comunicación entre la aplicación
portal Error al inicializar el Web y un servidor de 2) Revise la conectividad entre la
servlet de aplicaciones o el dispatcher. aplicación Web y el servidor de
CheckSecurity. aplicaciones o dispatcher.
Contacte con su 3) Un servidor de aplicaciones o
administrador.” el dispatcher se han bloqueado. 3) Revise el estado de los
servidores de aplicaciones y el
dispatcher usando la herramienta
de monitoreo de servidores
Meta4. De ser necesario, reinicie
el servidor de aplicaciones o
dispatcher.
Las páginas JSP Las páginas del portal 1) Existe un problema en la 1) Revise los archivos de log de
del portal no muestran errores de compilación o la redirección a un JRun para buscar errores en Java,
compilan. compilación. archivo JSP. que indiquen problemas de
compilación (errores de
Se muestra el volcado 2) La versión de JDK (Java programación o llamadas a
de pila (Stacktrace) de Development Kit) es incorrecta métodos java obsoletos
Java o está mal instalada. (deprecated) o errores en la
redirección de las páginas, por
3) Está instalado un JRE (Java ejemplo, a archivos inexistentes.
Runtime Environment) en vez
de un JDK certificado. 2) Instale un JDK certificado por
Meta4.
4) Las clases java se compilaron
usando una versión distinta del 3) Instale un JDK certificado por
JDK Meta4.
C:\m4serversite\appserver01\temp\m4log\logfile.html
“Can`t init
LDBSubsystem
properties”
Al arranque, el Alguno de los puertos TCP/IP 1) Verifique, usando herramientas
servidor de del servidor de aplicaciones se del sistema operativo como
aplicaciones intenta encuentra en uso, o bloqueado “netstat”, que no existe un
levantar los por otro proceso. conflicto de puertos TCP/IP
ejecutores, sin utilizados por el app server y otra
embargo, estos se aplicación.
fallan inmediatamente
y el servidor de
aplicaciones se
detiene
Error initialising
Logical Database.
Please see other error
messages.
Can`t init
LDBSubsystem
properties
No se ejecutan No se ejecutan las 1) La tarea programada a 1) Revise los parámetros de
las tareas tareas programadas ejecutarse en segundo plano ejecución de la tarea programada.
programadas en en segundo plano, está mal definida.
segundo plano, usando el scheduler 2) Active, en el servidor de
usando el de Meta4. 2) No está activado el servicio aplicaciones, el servicio “Job
scheduler de de Job Scheduler en el servidor Scheduler”, en la pestaña
Meta4. de aplicaciones. “servicios” del configurador de
servidores de aplicaciones Meta4.
Donde DebugDir indica la carpeta donde se ubican los archivos de traza. Adicionalmente,
Los parámetros SystemDebugLevel, SystemDebugEnable y SystemDebugDetailLevel sirven
para activar mayor detalle en la generación de trazas, cambiando su valor de 0 a 1.
4
En Windows Vista la ruta cambia a “C:\ProgramData\meta4\regmeta4.xml”
C:\Documents and
Settings\<usuario>\Application
Data\Meta4\ regmeta4.xml
“Error (0-23-65)
Meta4Object mal
definido.”
“No se puede
construir el
Meta4Object
"SSC_APPUSER" de
tipo cliente-servidor
"Front".
Debe consultar otros
mensajes de error. “
“Error (0-30-4)
Licencia.
No es posible validar
la licencia
instalada.Error (0-17-
64) Meta4Object mal
definido.”
“Error (0-23-70) No
existen datos en el
servidor.
No se han podido
recuperar los datos
del Meta4Object
"XXXXXXX" de tipo
"delta" en el servidor.
Debe consultar con el
administrador.”
O mensajes relativos
a errores en la base
de datos:
</RAMDL>
Ahí se muestran las características y la ruta para ubicar el archivo de logs o trazas de RAM-
DL (TraceLevel, DebugLogFile).
5
En Windows Vista la ruta cambia a “C:\ProgramData\meta4\regmeta4.xml”
máquina virtual.
2) Convierta el paquete a la
versión 7.1 SP2 de acuerdo al
documento técnico SP6397 del
CSS de Meta4.