Vous êtes sur la page 1sur 30

424852728.

doc

Guía de Resolución de Problemas


(GUI-010-20090211)

U.T. - DAFP

Proyecto Sistema de Información y


Gestión del Empleo Público para el
Estado Colombiano- SIGEP
11 de Febrero de 2009.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 1 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

Historial de Revisiones

Versión Descripción Autor Acción Fecha


01.00 Creación del documento Eric Backstrom Creación 11-02-2009

Revisión Cargo Nombre Partes del Firma Fecha


Proyecto
Gerente Patricia Escobar UT
Proyecto
Líder Mario Federico UT
Proyecto Herrera
Líder Calidad Olga Yamile UT
Huertas
Jefe Oficina Victoria Díaz DAFP
de Sistemas
Interventoría PWC

Aprobación Cargo Nombre Partes del Firma Fecha


Proyecto
Gerente Patricia Escobar UT
Proyecto
Líder Mario Federico UT
Proyecto Herrera
Jefe Oficina Victoria Díaz DAFP
de Sistemas
Interventoría PWC

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 2 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

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

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 3 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

INTRODUCCIÓN

1.1 INTRODUCCIÓN

El Departamento Administrativo de la Función Pública (DAFP), atendiendo los


requerimientos de Ley, en representación del Gobierno Nacional de Colombia y en atención
a las necesidades de información y de gestión del empleo público de las entidades del
estado, establece el proyecto Sistema de Información y Gestión del Empleo Público –
SIGEP, el cual hace parte integral de la oferta en Sistemas de información que el Gobierno
Nacional está gestionando actualmente y facilitará la interoperabilidad entre los sistemas de
información del estado, a fin de reducir la duplicidad de información entre ellos.
En este documento se presenta la guía de resolución de problemas de funcionamiento del
sistema SIGEP, basado en tecnología Peoplenet-Meta4 versión 7.1 SP2.

1.2 ALCANCE

Este documento contiente la lista de verificación de la instalación del software y parámetros


necesarios para identificar y corregir los principales problemas de funcionamiento del
sistema SIGEP en cualquier ambiente de instalación. Este documento aplica únicamente
para los componentes Peoplenet versión 7.1 SP2.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 4 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

2 RESOLUCIÓN DE PROBLEMAS ESPECÍFICOS DE


EJECUCIÓN EN CLIENTES RICH WEB

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.

2.1 Requisitos previos para la instalación del cliente Rich Web:

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.

2.2 Problemas de instalación en el cliente Rich Web


Descripción del Síntomas Posibles causas Solución
problema presentados

1
Ver documento de matriz de certificaciones para Peoplenet 7.1 SP2
(SEPT08_Certif_71SP2_60SP6_ESP.doc)

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 5 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

No puede No puede ejecutarse 1) Falta de permisos de 1) Revise que la cuenta de


iniciarse o el instalador del ejecución en sistema operativo. usuario que se utiliza para la
ejecutarse el cliente Rich Web instalación inicial de Rich Web
instalador de Rich 2) No está activo el servicio de tiene privilegios administrativos
Web desde el actualización de componentes en el sistema operativo.
portal SIGEP meta4
2) Revise que servicios de
actualización de componentes
Rich Web Meta4
(m4updateservices) se
encuentran en ejecución.
Internet Explorer 1) Falta de permisos de 1) Verifique que el dominio de
muestra el error ejecución en el navegador SIGEP esté marcado como de
“ActiveX component Internet Explorer. confianza en Internet Explorer.
can’t create object Verifique se tienen permisos de
‘M4Loader.functions’” 2) No está instalado el ejecución scripts (JScript,
al principio de la componente VBScript) y componentes ActiveX
instalación m4adminservices.msi para el sitio SIGEP.

2) Verifique que se ha instalado el


componente de adminservices
(m4adminservices.msi). Entre al
panel de control, “Agregar o
quitar Programas” y verifique que
en la lista de programas aparece
el componente instalado.
Se produce el No está instalado en el servidor Ejecutar en el servidor de Rich
mensaje “Fatal Error el Hotfix 005 del SP2: Web, en la carpeta
During Installation” TC60SP6_71SP2_HF005 m4updateservices, el
durante la instalación procedimiento de actualización del
o se escribe en el visor Hotfix TC60SP6_71SP2_HF005.
de sucesos de
Windows la siguiente
entrada:

“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

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 6 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

Se muestra el 1) Falta de permisos de 1) Revise que la cuenta de


mensaje “Error ejecución en sistema operativo. usuario que se utiliza para la
Message not Available instalación inicial de Rich Web
0x800C0006” durante 2) El servidor Web no muestra tiene privilegios administrativos
el proceso de todos los archivos del sitio o no en el sistema operativo. Esto
instalación está configurado para servir incluye, permisos de escritura en
archivos ejecutables. disco, permisos de escritura en el
registro de Windows. Verifique
que puede obtener y ejecutar
archivos con la extensión .exe del
sitio de Rich web.

2) Verifique desde el navegador


Web puede obtener directamente
los archivos del sitio Rich Web,
por ejemplo:

http://www.sitio.com/packages/c
ore/m4windowsclient_core.exe

http://www.sitio.com/packages/c
ore/m4packconfig.xml

De lo contrario, puede ser que los


permisos de lectura del usuario
del Servidor Web sean erróneos o
los tipos MIME para archivos .exe,
.reg o .msi no estén
especificados.

En el caso de IIS, verifique que


los permisos de ejecución del sitio
sean únicamente para scripts
(scripts Only). Verifique que
herramientas como IISLockDown
Tool no estén bloqueando el envío
de archivos desde el servidor IIS
al navegador Web.
No puede Se produce el Es necesario que el computador 1) Ejecutar el instalador
instalarse el mensaje tenga instalados componentes m4adminservices_3dparty.exe.
componente Windows no reconoce básicos de “Microsoft Windows
m4adminservices los archivos con Installer” y del producto 2) Si existe algún problema,
.msi. extensión MSI o se “InstallShield”, instalar manualmente los
muestra el mensaje componentes “Windows Installer”
Windows no “Setup Is Unable To Verificar que los archivos MSI y IsScript Engine 10.5
reconoce el Find or Update están asociados al componente correspondientes a su sistema
archivo con ISScript.msi” durante “Windows Installer” operativo:
extensión MSI o la instalación
el instalador falla Verificar si existe la carpeta http://msdn.microsoft.com/es-
con el mensaje “Common mx/library/aa372856(en-
de error “Setup Files\InstallShield\Driver\1050\I us,VS.85).aspx
Is Unable To Find ntel 32”,
or Update Dentro de “c:\Archivos de http://consumerdocs.installshield.
ISScript.msi”. programa” y contiene los com/selfservice/viewContent.do?
archivo necesarios del motor externalId=Q108158&sliceId=1
IsScript.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 7 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

2.3 Ubicación de los archivos de trazas del cliente Rich Web

Abrir el archivo de configuración de Meta4 ubicado en “C:\Documents and Settings\All


Users\Application Data\meta4\regmeta4.xml”2 y buscar la entrada correspondiente a la
generación de logs o trazas:

<LOG DebugDir='C:\Documents and Settings\All Users\Application Data\meta4\M4Temp' ShowData='1'


MaxLDBInspSize='10' SystemDebugLevel='0' MaxRollingFileNum='5' SystemDebugEnable='0'
TraceTransferData='0' MaxRollingFileSize='1024' MultipleFilesTrace='0' SystemDebugDetailLevel='0'>

</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.

2.4 Problemas de ejecución en el cliente Rich Web


Descripción del Síntomas Posibles causas Solución
problema presentados
No se ven todos No se ven todos los 1) Faltan plantillas (templates) 1) Copie los archivos faltantes a la
los elementos elementos gráficos de específicos en la aplicación Web carpeta packages\suppfiles del
gráficos de Rich Rich Web, algunos de Rich Web para la generación sitio web “m4updateservices”.
Web, algunos reportes no pueden de reportes.
reportes no ejecutarse. 2) Instale los archivos
pueden 2) No se han instalado los complementarios (Supplemental
ejecutarse. archivos complementarios Files) en la aplicación Web de Rich
(Supplemental Files) en la Web desde el CD de producto.
aplicación Web de Rich Web.
No se instalan No se instalan No se ha actualizado en el Ejecute en el servidor, dentro del
automáticamente automáticamente las servidor Web donde está directorio del portal Web de
las actualizaciones de los publicado el portal de los servicios de actualización de
actualizaciones hotfixes o no puede servicios de actualización de Meta4 “M4UpdateServices” el
de los hotfixes o verse el archivo de Meta4 “M4UpdateServices” el archivo m4packmerger.bat, que
no puede verse el ayuda, al presionar la archivo de configuración se encargará de actualizar el
archivo de ayuda, tecla F1. m4applicationconfig.xml archivo de configuración, que es
al presionar la usado para que el cliente pueda
tecla F1. detectar los nuevos componentes
y archivos publicados en Rich
Web.
Las sesiones del La sesión del usuario El tiempo de inactividad de la Aumente el tiempo de inactividad
usuario expiran expira y es necesario sesión es muy pequeño en el de cada servidor de aplicaciones
demasiado volver a ingresar el servidor de aplicaciones al valor deseado. Reinicie los
pronto usuario y contraseña Servidores de aplicación.
Se inicia la Se muestra alguno de 1) Se encuentra instalada una 1) Revise el archivo de traza
pantalla de Login los siguientes versión tecnológica distinta de ubicado en “C:\Documents and
inicial de Meta4, mensajes, después de Meta4 en la base de datos Settings\All Users\Application
y permite capturar usuario y comparada con la instalada en Data\meta4\M4Temp\logfile.html”
capturar usuario contraseña: el cliente Rich Web. para mayor detalle del problema.
y contraseña, sin
embargo, se “Meta4Object 2) Se han aplicado parches 2) Verifique que la versión de la
muestra alguno incorrectly defined. incorrectamente a la base de base de datos Meta4 corresponde
2
En Windows Vista la ruta cambia a “C:\ProgramData\meta4\regmeta4.xml”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 8 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

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-30) Error


al abrir la sesión.
Se ha producido un
error tecnológico al
abrir la sesión de la
aplicación para el
usuario "XXXX".
Debe consultar con el
administrador.”

“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.”

“No se puede generar


el Meta4Object
"SDC_MT_LICENSE"
de tipo "Back".
Debe consultar otros
mensajes de error.”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 9 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

“Error (0-19-4) Error


de base de datos.
Error ["942"] en base
de datos: "ORA-
00942: la tabla o vista
no existe”.
Esto sucedió en
"SYS_BUSINESS_SER
VICES" de
"M4LOAD".”
Se pueden ver Se pueden ver las 1) La aplicación Pasarela Rich 1) Reinicie, desde el contenedor
las páginas páginas iniciales de Web (M4Gateway) no está de servlets (JRun) o como servicio
iniciales de Rich Rich Web, sin ejecutándose o se encuentra de Windows, la aplicación
Web, sin embargo el sitio bloqueada en el contenedor de Pasarela Rich Web Web
embargo el sitio funciona demasiado Servlets (JRun). (M4Gateway).
funciona lento y no se puede
demasiado lento pasar de la pantalla de 2) La integración entre el 2) Ejecute el proceso de
y no se puede login. Contenedor de Servlets (JRun) integración de una aplicación Web
pasar de la que contiene la aplicación en el contenedor de sevlets
pantalla de login. Pasarela Rich Web (M4Gateway) (JRun) con el servidor Web a
y el servidor Web (IIS, SunOne, través del conector de JRun
IBM HTTP Server-Apache) no se (wsconfig.exe).
ha realizado, está
incorrectamente aplicada o se 3) Verifique que no está
ha corrompido (integración con bloqueado el puerto TCP/IP por el
conector JRun). que se entra a la pasarela Rich
Web. Eso incluye la verificación de
3) Existe algún bloqueo del reglas de Firewall del servidor o
puerto TCP/IP del Gateway del cliente Rich Web.
debido a un firewall o antivirus.

Se inicia la Se muestra alguno de 1) La aplicación Pasarela Rich 1) Reinicie, desde el contenedor


pantalla de Login los siguientes errores: Web (M4Gateway) no está de servlets (JRun) o como servicio
inicial de Meta4, ejecutandose o se encuentra de Windows, la aplicación
y permite “Error (0-23-30) bloqueada en el contenedor de Pasarela Rich Web Web
capturar usuario Error al abrir la sesión. Servlets (JRun). (M4Gateway).
y contraseña, sin Se ha producido un
embargo, se error tecnológico al 2) La integración entre el 2) Ejecute el proceso de
muestra alguno abrir la sesión de la Contenedor de Servlets (JRun) integración de una aplicación Web
de los siguientes aplicación para el que contiene la aplicación en el contenedor de sevlets
errores. usuario "M4ADM". Pasarela Rich Web (M4Gateway) (JRun) con el servidor Web a
Debe consultar con el y el servidor Web (IIS, SunOne, través del conector de JRun
administrador.” IBM HTTP Server-Apache) no se (wsconfig.exe).
ha realizado, está
“Error (0-54-66) incorrectamente aplicada o se 3) Verifique que no está
Error al ejecutar la ha corrompido (integración con bloqueado el puerto TCP/IP por el
función conector JRun). que se entra a la pasarela Rich
InternetWriteFile. Web. Eso incluye la verificación de
Error al escribir datos 3) Existe algún bloqueo del reglas de Firewall del servidor o
de la PDU, 520 bytes, puerto TCP/IP del Gateway del cliente Rich Web.
en la petición HTTP: debido a un firewall o antivirus.
The handle is in the
wrong state for the
requested operation
.
Debe consultar con el
administrador.”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 10 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

“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.”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 11 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

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)

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.

3.1 Ubicación de Trazas del Contenedor Java

El contenedor Java es la aplicación responsable de ejecutar la lógica de las páginas JSP o


servlets de las aplicaciones Web de Meta4.

3.1.1 Ubicación de trazas en JRun 4.0


Para el Caso de JRun 4.0, se crean trazas en el directorio “C:\jrun4\logs”, donde se crean
distintos archivos por cada servidor JRun configurado, dependiendo de los niveles de trazas
activos los archivos de trazas se generan como sigue:

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

Donde “c:\jrun4” es el directorio de instalación de JRun y “<nombre-app>” es el nombre


de la configuración del servidor que contiene nuestra aplicación.

3.1.2 Ubicación de Trazas en Tomcat


Verifique los archivos siguientes en la instalación de Tomcat:

C:\tomcat\logs\catalina.out
C:\tomcat\logs\catalina-yyyy-mm.dd.out

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 12 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

Donde “c:\tomcat” es el directorio de instalación de Tomcat y “yyyy-mm-dd” es la fecha de


creación del archivo de traza.

3.2 Ubicación de los archivos de traza del servidor Web

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.

3.2.1 Trazas Internet Information Services (IIS)


En la sección de administración del servidor IIS (“Panel de control\herramientas
administrativas\Administración del servidor de Internet Information Services (IIS)”),
busque el nombre del sitio Web configurado (en el ejemplo, “rhadmin”)

De clic derecho para obtener sus propiedades, en la sección “Sitio Web”, buscar que esté
habilitado el check “Habilitar logs”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 13 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

De clic en el botón “propiedades”, ahí se mostrarán las propiedades del archivo de traza o
log generado por IIS.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 14 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

3.2.2 Trazas Sun One Web Server

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”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 15 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

3.2.3 Trazas IBM HTTP Server-Apache

Identifique, en el archivo httpd.conf, ubicado en la carpeta de configuración del servidor


Web, las entradas ErrorLog, que apuntan al archivo global de error y en caso de usar hosts
virtuales, busque los archivos que contengan el nombre de su host virtual y terminen en
_access_log y _error_log, por ejemplo:

www.misitio.com_access_log
www.misitio.com_error_log

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)

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

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 16 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

M4_LOG_DIR=C:/m4webservices/m4gateway/WEB-INF/classes/properties/log
M4_TRACE_LEVEL=info

Donde M4_LOG_DIR especifica la ruta donde se ubican los archivos de traza de la


aplicación y M4_TRACE_LEVEL indica el nivel de detalle de la traza, siendo “info” y “debug”
los valores más comunes3.

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)

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)

Descripción del Síntomas Posibles causas Solución


problema presentados
Las sesiones del La sesión del usuario El tiempo de inactividad de la Aumente el tiempo de inactividad
usuario expiran expira y es necesario sesión es muy pequeño en el de cada servidor de aplicaciones
demasiado volver a ingresar el servidor de aplicaciones al valor deseado. Reinicie los
pronto usuario y contraseña Servidores de aplicación.
No se puede El portal no responde 1) No existe conectividad con el 1) Verifique que tiene conexión a
entrar al portal peticiones de ningún portal desde Internet Internet.
tipo.
2) No existe una adecuada 2) Verifique, usando alguna
configuración de los servidores herramienta como ping, o
DNS para resolver la dirección traceroute, que la dirección del
del sitio. sitio se resuelve correctamente
desde sus instalaciones.
3) Un firewall bloquea el acceso
al sitio 3) Verifique que no exista algún
firewall (personal o de la
4) Los servicios del servidor organización) que se encuentre
Web y/o JRun no se están bloqueando el acceso al sitio.
ejecutando.
4) Verifique que los servicios del
Servidor Web (IIS, Sun One, IBM
HTTP Server-Apache) y JRun
estén ejecutandose y respondan
las peticiones.
El portal se 1) Existe una alta 1) Existe una alta demanda del 1) Verifique que el nivel de tráfico
encuentra demanda del sitio. sitio. del sitio se encuentre dentro de
anormalmente niveles esperados de carga. Esto
lento 2) Los portales no 2) La aplicación Web puede realizarse viendo los logs
funcionan correspondiente no está del servidor Web o leyendo las
adecuadamente y ejecutándose o se encuentra trazas de JRun, si se tiene
están lentos. bloqueada en JRun. activado el monitoreo de recursos

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.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 17 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

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).

Se pueden ver 1) La aplicación Web 1) Reinicie, desde JRun o como


elementos correspondiente no está servicio de Windows, la aplicación
estáticos del ejecutándose o se encuentra web correspondiente.
portal (imágenes, bloqueada en JRun.
estilos, páginas 2) Ejecute el proceso de
HTML), pero las 2) La integración entre el integración de una aplicación Web
páginas JSP no Servidor JRun que contiene la en JRun con el servidor Web a
pueden verse. aplicación Web correspondiente través del conector de JRun
y el servidor Web (IIS, SunOne, (wsconfig.exe).
IBM HTTP Server-Apache) no se
ha realizado, está
incorrectamente aplicada o se
ha corrompido (integración con
conector JRun).

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.

3) Existe un problema en la 2) Aplique el Hotfix que corrige el


compilación o la redirección a un bug 61205 o actualice al updater
archivo JSP. 7.0 de JRun 4.0.

a)
http://kb.adobe.com/selfservice/v
iewContent.do?
externalId=1f472255

b)
http://www.adobe.com/support/jr
un/updaters.html

3) Revise los archivos de log de


JRun para buscar errores en Java,
que indiquen problemas de
compilación (errores de
programación o llamadas a
métodos java obsoletos
(deprecated) o errores en la
redirección de las páginas, por
ejemplo, a archivos inexistentes.

No puede Se muestra el 1) La aplicación Web no pudo 1) Revise los logs de JRun y de la

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 18 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

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.

4) Compile las clases java con la


misma versión de JDK instalada
en el servidor.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 19 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

4 RESOLUCIÓN DE PROBLEMAS DEL SERVIDOR DE


APLICACIONES

4.1 Ubicación de los archivos de traza del servidor de


aplicaciones

Ubicar, en la carpeta de la configuración del servidor de aplicaciones, el archivo


“logsysserver.ini”, que contiene las rutas a los archivos de log y niveles de detalle
configurados para el servidor de aplicaciones. Por defecto siempre se creará el archivo

C:\m4serversite\appserver01\temp\m4log\logfile.html

Que contiene los mensajes básicos de error y donde, “C:\m4serversite\appserver01” es la


ruta física a la configuración del servidor de aplicaciones.

4.2 Resolución de problemas del servidor de aplicaciones


Descripción del Síntomas Posibles causas Solución
problema presentados
Las sesiones del La sesión del usuario El tiempo de inactividad de la Aumente el tiempo de inactividad
usuario expiran expira y es necesario sesión es muy pequeño en el de cada servidor de aplicaciones
demasiado volver a ingresar el servidor de aplicaciones al valor deseado. Reinicie los
pronto usuario y contraseña Servidores de aplicación.
El servidor de Al arranque, el El servidor de aplicaciones no 1) Revise el archivo de trazas
aplicaciones no servidor de puede inicializar la base de “logfile.html”, para verificar si
inicia aplicaciones no pasa datos lógica Meta4. existe un problema de
correctamente. de la sección conectividad con la base de datos
“Initializing LDB” Meta4.

En el archivo de trazas 2) Revise los parámetros de


se muestra el mensaje conexión con la base de datos.

“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

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 20 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

Al arranque, ocurre un La contraseña de usuario 1) Revise el archivo de trazas


error en la sección administrador (M4ADM) es “logfile.html”, para verificar si
“Logging in”. El incorrecta existe un problema de
servidor de conectividad con la base de datos
aplicaciones no inicia. Meta4.

2) Ajuste la contraseña del


usuario M4ADM con la
herramienta de configuración de
AppServers (Configurador
Servidor)
Se aplicó un Hotfix o La configuración del servidor de 1) Elimine la configuración del
Service Pack y el aplicaciones, ubicada en la servidor de aplicaciones anterior y
servidor de carpeta “conf” de la vuelva a crearla desde la
aplicaciones ya no configuración del App server y/o herramienta de configuración de
inicia. en el registro de Windows es AppServers (Configurador
incorrecta, apunta a directorios Servidor).
inexistentes o se generó usando
una versión distinta de Nota: Debe eliminar la carpeta de
Peoplenet. configuración del AppServer y las
entradas de registro previas, a fin
de poder crear la nueva
configuración desde cero.

2) Verifique que la versión


instalada corresponde a la versión
de la base de datos y de los
clientes.

Nota: Para verificar la versión


tecnológica instalada en el cliente
y en el servidor, buscar el archivo
m4buildversion.dll y dar clic
derecho, para ver los detalles de
la versión.

USER not found in La contraseña encriptada del Reescribir usuario y contraseña de


encripted file usuario de base de datos no es base de datos usando el
“c:\ruta\configuracion válida para esa configuración configurador de servidores de
_app\ss_appuser” del servidor de aplicaciones. aplicación de meta4 para esa
configuración.
En Windows, al En Windows, al El Dispatcher y/o controller no Verifique que ha registrado como
reiniciar el reiniciar el servidor, el se han registrado como servicio al controller y dispatcher,
servidor, el dispatcher y controller servicios de Windows. dentro del panel de
dispatcher y no inician control\Herramientas
controller no automáticamente, y Adminsitrativas\Servicios
inician es necesario iniciarlos
automáticamente manualmente.
El servidor de Se muestra en el Se ha perdido la conexión con la 1) Revise los parámetros
aplicaciones ha archivo de trazas base de datos especificados en el asistente de
dejado de alguno de los configuración del servidor de
funcionar, la siguientes mensajes aplicaciones.
instancia activa de error en la base de
se ha detenido. datos: 2) Revise la conectividad con la
base de datos, ya se usando el
Database error. Error cliente de Oracle o probando la
["17"] in database fuente de datos ODBC para Sql

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 21 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

"[Microsoft][ODBC Server en el servidor donde está


SQL Server Driver] instalado el App Server.
[Shared Memory]SQL
Server does not exist
or access denied.".

Database error. Error


["2"] in database
"[Microsoft][ODBC
SQL Server Driver]
[Shared
Memory]ConnectionO
pen (Connect())."

Database error. Error


["0"] in database
"[Microsoft][ODBC
SQL Server
Driver]Invalid
connection string
attribute".

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.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 22 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

5 RESOLUCIÓN DE PROBLEMAS EN LA ESTACIÓN DE


DESARROLLO (CLIENTE DISTRIBUIDO)

5.1 Ubicación de los archivos de traza en la estación de


desarrollo (cliente distribuido)

Abrir el archivo de configuración de Meta4 ubicado en “C:\Documents and Settings\All


Users\Application Data\meta4\regmeta4.xml”4 y buscar la entrada correspondiente a la
generación de logs o trazas:

<LOG DebugDir='C:\Documents and Settings\All Users\Application Data\meta4\M4Temp'


ShowData='1' MaxLDBInspSize='50' SystemDebugLevel='1' MaxRollingFileNum='5'
SystemDebugEnable='1' TraceTransferData='0' MaxRollingFileSize='1024'
MultipleFilesTrace='0' SystemDebugDetailLevel='1'>
</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.

5.2 Resolución de problemas en la estación de desarrollo


(cliente distribuido)
Descripción del Síntomas Posibles causas Solución
problema presentados
No se ven todos No se ven todos los 1) Faltan plantillas (templates) 1) Copie los archivos faltantes a la
los elementos elementos gráficos del específicos en la carpeta de carpeta “C:\Documents and
gráficos del cliente de desarrollo, supplemental Files (SuppFiles) Settings\All Users\Application
cliente de algunos reportes no para la generación de reportes. Data\meta4\M4SupportFiles”.
desarrollo, pueden ejecutarse.
algunos reportes 2) No se han instalado los Nota: En Windows Vista la ruta
no pueden archivos complementarios cambia a
ejecutarse. (Supplemental Files) en el “C:\ProgramData\meta4\
cliente de desarrollo. M4SupportFiles”

2) Instale los archivos


complementarios (Supplemental
Files) del cliente de desarrollo
desde el CD de producto.

4
En Windows Vista la ruta cambia a “C:\ProgramData\meta4\regmeta4.xml”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 23 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

Se cambia la Se cambia la Tiene un archivo de Revise si tiene parámetros de


configuración de configuración de la configuración personal, que es configuración de conexión a base
la base de datos base de datos usando ejecutado, ignorando los de datos distintos en los archivos:
usando el el configurador cambios realizados al archivo de
configurador ConPar, sin embargo, configuración global de Meta4. C:\Documents and Settings\All
ConPar, sin al conectarse Users\Application Data\Meta4\
embargo, al nuevamente, la regmeta4.xml
conectarse conexión anterior
nuevamente, la aparece sin cambios. Nota: En Windows Vista la ruta
conexión anterior cambia a
aparece sin “C:\ProgramData\meta4\regmeta
cambios. 4.xml”

C:\Documents and
Settings\<usuario>\Application
Data\Meta4\ regmeta4.xml

Donde <usuario> es la cuenta de


acceso del sistema operativo
usada para la estación de
desarrollo.

Se inicia la Se muestra alguno de 1) Se encuentra instalada una 1) Revise el archivo de traza


pantalla de Login los siguientes versión tecnológica distinta de ubicado en “C:\Documents and
inicial de Meta4, mensajes, después de Meta4 en la base de datos Settings\All Users\Application
y permite capturar usuario y comparada con la instalada en Data\meta4\M4Temp\logfile.html”
capturar usuario contraseña: la estación de desarrollo. para mayor detalle del problema.
y contraseña, sin
embargo, se “Meta4Object 2) Se han aplicado parches Nota: En Windows Vista la ruta
muestra alguno incorrectly defined. incorrectamente a la base de cambia a
de los siguientes You cannot build datos o la estación de “C:\ProgramData\meta4\M4Temp
errores. Meta4Object desarrollo, Debe verificarse la \logfile.html”
"SCH_SESSION" with correspondencia de versiones
client/server type en ambos ambientes. 2) Verifique que la versión de la
"Front". Please refer to base de datos Meta4 corresponde
other error 3) Se ha dañado alguna tabla a la versión de la estación de
messages.” de sistema en la base de datos desarrollo
de Meta4.
“Incorrect version. 3) Si las versiones del software
The Meta4Object instalado y la base de datos no
version is "46080" and corresponden, es necesario
the current application actualizar la estación de
version is "46723". desarrollo.
Please install the
application correctly.” Nota: Para verificar la versión
tecnológica instalada en el cliente
“Cannot get session y en el servidor, buscar el archivo
Meta4Object. Please m4buildversion.dll y dar clic
contact the derecho, para ver los detalles de
Administrator” la versión.

“Error (0-23-30) Error 4) Si no fue posible resolver el


al abrir la sesión. problema, contacte al proveedor
Se ha producido un de Meta4.
error tecnológico al
abrir la sesión de la
aplicación para el
usuario "XXXX".
Debe consultar con el
administrador.”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 24 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

“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.”

“No se puede generar


el Meta4Object
"SDC_MT_LICENSE"
de tipo "Back".
Debe consultar otros
mensajes de error.”

“Error (0-19-4) Error


de base de datos.
Error ["942"] en base
de datos: "ORA-
00942: la tabla o vista
no existe”.
Esto sucedió en
"SYS_BUSINESS_SER
VICES" de
"M4LOAD".”
No se puede Se muestra el La DLL ubicada en “C:\Archivos Cambie la DLL m4dbwrap.dll por
iniciar el cliente mensaje de error de la correspondiente en la carpeta
de desarrollo, no siguiente Programa\meta4\M4DevClient\ “C:\Archivos de
se llega a la Bin\m4dbwrap.dll” es para la Programa\meta4\M4DevClient\Bin
pantalla de login “DBWrap error. base de datos incorrecta: Se ” dependiendo del tipo de
Unexpected error in configuró la conexión para SQL conexión
the DBWrap driver” Server y la DLL es para Oracle o
viceversa OCI para Oracle
ODBC para Sql Server

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 25 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

Se muestra alguno de 1) Los parámetros especificados 1) Revise los parámetros


los siguientes en el asistente de configuración especificados en el asistente de
mensajes: “ConPar” son incorrectos. configuración “ConPar”

“Error initialising 2) No se pudo establecer una 2) Revise la conectividad con la


Logical Database. conexión a la base de de datos. base de datos, ya se usando el
Please see other error cliente de Oracle o probando la
messages.” fuente de datos ODBC para Sql
Server.
O errors relativos a la
conexión con la base
de datos:

Error (0-19-4) Error


de base de datos.
Error ["10054"] en
base de datos:
"[Microsoft][ODBC
SQL Server Driver]
[DBNETLIB]Connectio
nWrite (send()).".
Esto sucedió en
"XXXXXXXXX" de
"XXXX".

“Database error. Error


["12170"] in database
"ORA-12170:
TNS:Connect timeout
occurred”
Se trabajaba Se muestra alguno de Se ha perdido la conexión con la Salir del cliente de desarrollo y
normalmente en los siguientes base de datos. probar la conectividad con la base
la estación de mensajes: de datos. Reiniciar el cliente de
desarrollo y de desarrollo.
pronto aparecen “Error (0-23-23)
mensajes de Permisos insuficientes
error como los para construir
siguientes, M4Object.
impidiendo El usuario no tiene
continuar con el permisos para
trabajo. construir el M4Object
en el contexto de una
sociedad. Esto ocurrió
para el M4Object
XXXXXXX y la
sociedad 00nn
Revise su contexto de
seguridad.”

“Error (0-19-62) Base


de datos no operativa.
Base de datos no
operativa.
Esto sucedió en
"PROJ_TREE_VALIDAT
ION" de
"SCH_SESSION".”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 26 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

“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:

Error (0-19-4) Error


de base de datos.
Error ["10054"] en
base de datos:
"[Microsoft][ODBC
SQL Server Driver]
[DBNETLIB]Connectio
nWrite (send()).".
Esto sucedió en
"PROJ_TREE_VALIDAT
ION" de
"SCH_SESSION".

“Database error. Error


["12170"] in database
"ORA-12170:
TNS:Connect timeout
occurred”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 27 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

6 RESOLUCIÓN DE PROBLEMAS EN RAM-DL

6.1 Ubicación de los archivos de traza en RAM-DL

Abrir el archivo de configuración de Meta4 ubicado en “C:\Documents and Settings\All


Users\Application Data\meta4\regmeta4.xml”5 y buscar la entrada correspondiente a la
generación de logs o trazas de RAM-DL:

<RAMDL BUILD='71200' … TraceLevel='1' DebugLogFile='C:\Documents and Settings\All Users\Application


Data\meta4\M4Temp\RAMDLLOG.TXT' … QueryAutocommit='YES' … LastLogDirectory='C:\Documents and
Settings\All Users\Application Data\meta4\M4Temp\PM\Log' CheckPackManModel='YES'
LastCacheDirectory='C:\Documents and Settings\All Users\Application Data\meta4\M4Temp\PM\Cache' … >

</RAMDL>

Ahí se muestran las características y la ruta para ubicar el archivo de logs o trazas de RAM-
DL (TraceLevel, DebugLogFile).

6.2 Resolución de problemas en RAM-DL


Descripción del Síntomas Posibles causas Solución
problema presentados
Al conectarse a Al conectarse a una La versión de la fuente de datos 1)Cambie el parámetro “Build del
una fuente de fuente de datos, o al y de la base de datos destino repositorio” de
datos, o al ejecutar un paquete, son de versiones distintas. “Herramientas\Opciones” a la
ejecutar un RAMDL envía versión deseada del repositorio,
paquete, RAMDL mensajes de error y desactive la opción
envía mensajes no puede conectarse a “Herramientas\Opciones\Chquear
de error y no una fuente de datos. el modelo de paquetes al
puede conectarse arranque”
a una fuente de
datos. 2) Convierta el paquete a la
versión 7.1 SP2 de acuerdo al
documento técnico SP6397 del
CSS de Meta4.
Al intentar cargar El paquete tiene un error Verifique que el comando a
un paquete, específico al ejecutar un ejecutar es correcto, de lo
RAMDL envía comando. contrario, verifique el paquete con
mensajes de el consultor que lo emitió o edite
error que el comando erróneo desde
impiden “Herramientas\Editor de creación
continuar. de paquetes”
Al ejecutar un Al ejecutar un Está ejecutando un paquete de 1)Cambie el parámetro “Build del
paquete, RAMDL paquete, RAMDL pide versión distinta al repositorio repositorio” de
pide un usuario y un usuario y destino. “Herramientas\Opciones” a la
contraseña contraseña (M4ADM), versión deseada del repositorio,
(M4ADM), sin sin embargo falla No ha aplicado todos los desactive la opción
embargo falla mostrando un error de hotfixes tecnológicos a la “Herramientas\Opciones\Chquear
mostrando un la máquina virtual. instalación de RAM-DL y la base el modelo de paquetes al
error de la de datos del repositorio arranque”

5
En Windows Vista la ruta cambia a “C:\ProgramData\meta4\regmeta4.xml”

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 28 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

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.

3) Aplique los hotfixes necesarios


para que RAM-DL y los
repositorios de la base de datos
sean tecnológicamente
compatibles.

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 29 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc
424852728.doc

7 RESOLUCIÓN DE PROBLEMAS EN EL MONITOR DE


SERVIDORES DE APLICACIÓN (APPSERVER MONITOR)

Descripción del Síntomas Posibles causas Solución


problema presentados
El Monitor de El Monitor de 1) Ha marcado incorrectamente 1) Verifique que ha marcado o
servidores de servidores de el check de verificación “Host is desmarcado correctamente el
aplicaciones no aplicaciones no puede a site Dispatcher” check de “Host is a site
puede conectarse conectarse al Dispatcher”
al Dispatcher o Dispatcher o 2) El Application Server al que
Application Application Server desea conectarse se ha 2) Reinicie el servidor de
Server deseado. deseado, aunque los bloqueado. aplicaciones bloqueado.
parámetros indicados
(dirección IP, puerto, 3) Un firewall o software 3) Verifique que no existe algún
nombre de la antivirus bloquea alguno de los firewall o antivirus bloqueando el
configuración puertos de la configuración del acceso a los puertos TCP de la
usuario/contraseña) Dispatcher o Application Server. configuración.
son correctos.
4) Un firewall o software 4) Verifique que no existe algún
antivirus bloquea el puerto TCP firewall o antivirus bloqueando el
6666, que permite la interacción acceso a los puertos TCP de la
entre el monitor y el Dispatcher configuración.
o los servidores de aplicaciones.

Fin del documento

COPYRIGHT  2007 Meta4 Spain, S.A.


No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 30 de 30
DCP-20080129-SGPPR-Plantilla General de Documentación SIGEP-V01.00.doc