Utilización de los registros: Everyplace Synchronization Server

Logging Toolkit for Java (JLog o kit de utilidades de registro para Java) es una infraestructura de IBM que proporciona muchas funciones de registro y rastreo. Synchronization Server utiliza este kit de utilidades como ayuda para el diagnóstico de problemas de ejecución. JLog crea archivos de registro y de depuración detallados mientras se ejecuta en segundo plano, con lo que se reduce el uso de recursos del sistema.

JLog soporta el registro de mensajes como errores y como avisos y de información de estado. También soporta el registro de mensajes de depuración denominados rastreos. Los rastreos son de gran ayuda para la resolución de problemas. Sin embargo, a fin de ahorrar recursos del sistema, los rastreos están desactivados por omisión.

Además de los registros de Synchronization Server, el software de prerrequisito y correquisito también proporcionan registros que pueden ser de ayuda en la resolución de problemas.

Registros de Synchronization Server

Synchronization Server crea un nuevo archivo de registro de mensajes para cada día. Para facilitar la gestión y clasificación de los registros de mensajes, se agrega la fecha a cada archivo de registro. Por ejemplo, el registro de mensajes del 31 de julio de 2002 aparecería en el directorio de registros de la siguiente manera: ESS_MessageLog_2002.07.31.log. Es importante tener en cuenta que Synchronization Server no limita el tamaño de los archivos de registro. Puesto que Synchronization Server crea un nuevo archivo de registro cada día, debe suprimir archivos periódicamente para gestionar el espacio en disco.

Ubicación de los archivos de registro

Los archivos de registro creados por JLog se encuentran en el directorio <raíz_ess>\logs\.

Registros de mensajes

Para conseguir una mayor flexibilidad, puede definir el nivel del registro de mensajes. Synchronization Server proporciona tres niveles de registro de mensajes: Error, Aviso e Informativo.

Error es el nivel mínimo de registro de mensajes disponible y está siempre habilitado. Incluye los errores y los mensajes graves. Los mensajes de error se emiten cuando se detecta una situación potencialmente crítica, pero Synchronization Server sigue estando operativo. Los mensajes graves se emiten cuando Synchronization Server no está operativo.
Los avisos son los mensajes que se emiten cuando se detectan problemas menores. Este nivel también incluye mensajes de error.
Los mensajes informativos proporcionan información útil sobre las operaciones realizadas por Synchronization Server. Este nivel también incluye avisos y errores.

Registros de rastreo

El registro de rastreo es principalmente una herramienta de depuración y sólo debe habilitarse para resolver problemas. El uso del registro de rastreo puede repercutir en el rendimiento del sistema. La utilización prolongada del registro también puede consumir grandes cantidades de espacio de disco. Proporciona tres niveles de rastreo: bajo, medio y alto.

El nivel bajo informa del estado del sistema con los mínimos detalles.
El nivel medio informa de las operaciones básicas del sistema con detalles moderados.
El nivel alto proporciona un análisis completo de resolución de problemas ampliamente detallado, si está disponible.

Configuración de registros

Los registros de Synchronization Server se configuran mediante los Portlets de administración de Everyplace Synchronization. Una vez que inicie la sesión en WebSphere Portal y acceda a los Portlets de administración de Everyplace Synchronization, puede editar el nivel de registro de mensajes, activar y desactivar el registro de rastreo y establecer el nivel de registro de rastreo.

Para configurar los registros:

Inicie el Portlet de administración.
- En Windows, pulse Inicio Programas IBM Everyplace Synchronization Server Portlet de administración.
- En AIX, abra un navegador Web y especifique este URL:
Inicie la sesión en WebSphere Portal, como administrador de Synchronization Server.
Seleccione la pestaña Everyplace Synchronization.
Seleccione la pestaña Valores de servidor.
Configure los valores de registro y rastreo según sea necesario.
Pulse Guardar y reinicie Synchronization Server para que los cambios entren en vigor.

Puede establecer el nivel de registro de mensajes, activar o desactivar el registro de rastreo y establecer el nivel de rastreo. Acuérdese de inhabilitar los registros de rastreo una vez que haya acabado de resolver un problema.

Registros de instalación de Synchronization Server

El Gestor de configuración configura su entorno y crea bases de datos para dar soporte a Synchronization Server. Para obtener más detalles sobre la instalación y la resolución de problemas de sincronización, examine los registros de instalación.

Hay varios registros de instalación:

El registro install.log proporciona información sobre cada paso de la instalación. Consulte este archivo de registro para confirmar que se han creado las bases de datos de Synchronization Server y que se ha configurado el servidor de aplicaciones. Este registro se encuentra en: <raíz_ess>\.
El registro createcadb.txt proporciona información sobre la creación de la base de datos de Synchronization Server. Este registro no está disponible si la base de datos se encuentra en una máquina remota. Consulte este archivo de registro para confirmar que se ha creado la base de datos. Este registro se encuentra en: <raíz_ess>\logs\.
El registro createtssdb.log proporciona información sobre la creación de la base de datos de TrueSync. Este registro no está disponible si la base de datos se encuentra en una máquina remota. Consulte este archivo de registro para confirmar que se ha creado la base de datos. Este registro se encuentra en: <raíz_ess>\logs\.
El registro installAdminPortal.log proporciona información sobre la instalación del portlet de administración de Synchronization Server. Consulte este registro si no puede acceder a los portlets de Synchronization Server después de completar la instalación. Este registro se encuentra en: <raíz_ess>\.
El registro configwas.log proporciona información sobre la creación de la aplicación Synchronization Server y el origen de datos en el servidor de aplicaciones. Este registro se encuentra en: <raíz_ess>\logs\.
El registro configwas2.log proporciona información sobre el inicio de la aplicación Synchronization Server en el servidor de aplicaciones. Este registro se encuentra en: <raíz_ess>\logs\.
El registro dsysample.log proporciona información sobre la creación de la base de datos de ejemplo de DB2 Everyplace. Este registro se encuentra en:
El registro dsy_was40_install.log proporciona información sobre la instalación del servlet de sincronización de DB2 Everyplace como una aplicación de empresa. Este registro se encuentra en:

Registros de portlet

WebSphere Portal proporciona registros para los portlets. Puesto que la administración de Synchronization Server se lleva a cabo mediante portlets, debería habilitar los registros de portlet. Los registros de portlet se encuentran en el directorio <raíz_wps>\log. WebSphere Portal agrega la fecha y hora de inicio al archivo de registro. El nombre del archivo de registro es wps_yyyy.mm.dd-hh.mm.ss.log. También hay un archivo llamado appserver-out.log. Si los portlets no aparecen, compruebe si hay errores en este archivo.

Para habilitar los registros de portlet, edite el archivo jlog.properties en el directorio <raíz_was>\lib\app\config. Reinicie el servidor de aplicaciones para que los cambios entren en vigor.

Para habilitar los registros de portlet:

Abra el archivo jlog.properties .
Quite el comentario de la siguiente línea.
baseGroup.PortletMessageLogger.isLogging=true
Reinicie Portal Server desde la Consola del administrador de WebSphere Application Server.

Tiene que repetir estos pasos después de actualizar WebSphere Portal.

Para habilitar los registros de rastreo de portlet al resolver problemas:

Abra el archivo jlog.properties.
Quite el comentario de la siguiente línea.
baseGroup.PortletTraceLogger.isLogging=true

Registros de servlet

Los servlets de Synchronization Server convierten las peticiones de sincronización entrantes. Para resolver problemas de servlet, consulte los registros del servidor de aplicaciones de Synchronization Server, appserver-stderr.log y appserver-stdout.log. Estos registros se encuentran en el directorio de registros de Synchronization Server (<raíz_ess>\logs\).

El registro appserver-stderr.log proporciona información de los errores con los que se encuentra el servidor de aplicaciones al iniciar o ejecutar los servlets.
El registro appserver-stdout.log proporciona información sobre los servlets de Synchronization Server en el entorno de ejecución del servidor de aplicaciones.

DB2 Everyplace también proporciona registros de servlet. Estos registros se encuentran en <raíz_ess>\DB2e\Server\.

El registro dsystderr.txt proporciona información de los errores con los que se encuentra el servidor de aplicaciones al iniciar o ejecutar el servlet de sincronización de DB2 Everyplace.
El registro dsystdout.log proporciona información sobre el servlet de sincronización de DB2 Everyplace en el entorno de ejecución del servidor de aplicaciones.

Registros de DB2 Everyplace

Cuando necesite resolver problemas de la sincronización de bases de datos relacionales, consulte los siguientes archivos de registro y de rastreo.

Registros de WebSphere Application Server
- dsystdout.txt: WebSphere Application Server graba información en este registro. Por ejemplo, cuando DB2 Everyplace Sync Server recibe información de usuario autenticada (señal LPTA) del servidor de aplicaciones, graba esta señal en este registro. Por lo tanto, puede revisar este registro para verificar la autenticación del usuario.
- systderr.txt: WebSphere Application Server graba errores en este registro.
Estos registros se encuentran en la siguiente ubicación: <raíz_ess>\db2e\Server\
Registro de WebSphere Everyplace Access
- Registro de servicios de usuario (UsersServices.log): WebSphere Everyplace Access anota las llamadas de DB2 Everyplace a los Servicios de usuario en este registro.
Este registro se encuentra en la siguiente ubicación: <raíz_ess>\db2e\Server\
Registros de Synchronization Server
- Registro de DB2 Everyplace (syncadapterinit.log): Si DB2 Everyplace Sync Server encuentra errores al intercambiar información de configuración de dispositivo con Everyplace Client (cliente de base de datos), graba esta información en el archivo syncadapterinit.log.
  
  Este registro se encuentra en la siguiente ubicación:
- Registros de usuario (userID.log): Si DB2 Everyplace Sync Server no puede identificar el ID de dispositivo y no puede intercambiar información de configuración de dispositivo ni información de base de datos relacional, el servidor actualiza el archivo de registro de usuario. El nombre del archivo de registro de usuario se designa de acuerdo con el ID de usuario de la petición de sincronización, por ejemplo SyncUser1.log. Este archivo de registro siempre se crea cuando el rastreo está habilitado. Revise este registro para determinar qué mensajes de petición de sincronización se han intercambiado con Everyplace Client (cliente de base de datos).
  
  Este registro se encuentra en la siguiente ubicación:
Registros de Everyplace Client

El componente de Base de datos (DB2 Everyplace) proporciona registros sobre el dispositivo. Los registros más útiles son LOGDB-ISYN y TRACE_ISYN. Proporcionan el flujo de peticiones de sincronización desde la perspectiva del cliente.

Estos registros se encuentran en la siguiente ubicación: \Archivos de programa\iSync\.