Registro de la aplicación web de Geoportal Server
Cuando se producen errores u otros problemas en la interfaz de Esri Geoportal Server, los archivos de registro son el mejor lugar para buscar información al respecto. El registro de la aplicación web de Geoportal Server que se describe aquí se sitúa en el contexto de implementaciones utilizando Apache Tomcat para el registro de geoportal u Oracle WebLogic para el registro de Geoportal Server como servidor de aplicación web. Para otro software de servidor de aplicación web compatible, puede utilizar los conceptos que se describen en estas secciones y aplicarlos al marco de registro de java.util.
Registro de Geoportal Server para Apache Tomcat
Los archivos de registro de Tomcat se encuentran en el directorio <Tomcat Installation Directory>\logs de forma predeterminada. Además de los archivos estándar que se crean mediante Tomcat, el directorio logs también incluirá un archivo de registro de ArcGIS Server Geoportal Server, llamado gpt.xxxxxx.log donde xxxxxx corresponde a la fecha con el formato aaaa-mm-dd. Este archivo de registro es el primer lugar en donde se deben buscar los errores. Encontrará detalles adicionales sobre el mecanismo de registro de Tomcat en el sitio de Contenedor de Servlet/JPS de Apache Tomcat 5.5.
ArcGIS Server Geoportal Server permite definir el nivel de registro para obtener más o menos detalles en los archivos de registro de Geoportal Server. El nivel de detalle que se escribe en el archivo gpt.xxxxx.log se define en el archivo <Tomcat Installation Directory>\webapps\geoportal\WEB-INF\classes\logging.properties. La variable com.esri.gpt.level determina el nivel de registro y se establece en FINE de forma predeterminada. Los valores aceptados para el nivel de inicio de sesión son:
- SEVERE
- ADVERTENCIA
- INFO
- CONFIG
- FINE
- FINER
- FINEST
- TODO
Precaución:
Establecer el nivel de registro en FINER, FINEST o ALL es una solución de problemas adecuada, pero el nivel de registro se debe establecer nuevamente en su nivel original cuando la solución de problemas esté completa. Si deja el registro establecido en estos niveles, el archivo de registro podría incrementarse mucho rápidamente y ocupar mucho espacio en el disco.
Registro de Geoportal Server para Oracle WebLogic
WebLogic no selecciona el archivo Geoportal Server logging.properties predeterminado del directorio de clases de Geoportal Server. Para que se refleje en las propiedades del registro, debe editar el logging.properties principal para el ejecutable de java que ejecuta WebLogic. En los pasos siguientes se explica cómo habilitar la generación de un archivo de registro para la aplicación web de Geoportal Server y cómo escribirlo en un directorio de salida a elección del usuario. Para obtener más información, consulte la documentación en línea de Oracle sobre el Registro de WebLogic.
- Ubique el java ejecutable que Weblogic está ejecutando y dentro de esa carpeta abra su archivo logging.properties en un editor de texto.
El archivo logging.properties del ejecutable java de WebLogic puede encontrarse en la carpeta \\bea\jrockit\jre\lib o \\Oracle\Middleware\jdk\jre\lib.
- En el archivo logging.properties, busque el parámetro java.util.logging.ConsoleHandler.level y cambie el valor predeterminado INFO a FINER.
- En ese mismo archivo, desplácese hasta el final, donde se definen las Propiedades específicas del servicio #..
- Debajo de la línea de ejemplo del servicio com.xyz.foo.level = SEVERE, introduzca lo siguiente: com.esri.gpt.level = FINER
- Guarde el archivo logging.properties.
- Examine el archivo startWebLogic.cmd y ábralo con un editor de texto.
Normalmente, el archivo startWebLogic se encuentra en la carpeta \\wlserver_10\samples\domains\wl_server\bin o en una ruta de acceso al archivo similar.
- En el archivo startWebLogic.cmd, busque la línea en la que se lee: set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
- Agregue dos parámetros adicionales a esta variable JAVA_OPTIONS.
Los dos parámetros definirán el nombre de dos archivos de registro de Geoportal Server, así como la ubicación en la que deben escribirse. En este ejemplo, estos dos archivos de registro se escriben en la unidad C:\. Los dos parámetros son: -Dweblogic.Stdout="C:\geoportal-stdout" y -Dweblogic.Stderr="C:\geoportal-stderr". La variable JAVA_OPTIONS ahora debería tener un aspecto como el del ejemplo siguiente.set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dweblogic.Stdout="C:\geoportal-stdout" -Dweblogic.Stderr="C:\geoportal-stderr"
- Guarde el archivo startWebLogic.cmd.
- Reinicie el servicio WebLogic.
Una vez iniciado el servicio, los archivos de registro de Geoportal Server se deberían escribir en la unidad C:\.
Los scripts del servidor de WebLogic registran todos los mensajes en la consola del servidor de forma predeterminada. Para redirigir estos a un archivo de registro, debe editar la secuencia de comandos de inicio de WebLogic Server.
Habilitar el registro para clientes de Geoportal Server
El inicio de sesión para Clientes de CSW, Publicar cliente y Cliente de WMC se desactiva por defecto. Para habilitar el registro, especifique la ruta de salida del archivo de registro y defina el tamaño máximo del archivo de registro. Debe configurar el archivo de propiedades para los clientes. Estos archivos de propiedades se encuentran en el directorio de instalación de ArcGIS Desktop, en la carpeta \\ArcGIS\Desktop<version>\bin, y se instalan cuando se instala el propio cliente. A continuación se muestra el archivo de propiedades correspondiente a cada Cliente.
Precaución:
Si navega al directorio \\ProgramFiles\ESRI\Geoportal\, verá subcarpetas para los clientes que también contienen archivos de propiedades. Éstas son plantillas que se usan durante la instalación del Cliente y no se hace referencia a ellas para ningún cambio de inicio de sesión. Asegúrese de que todos los cambios de registro en los archivos de propiedades los realiza en la carpeta \\ArcGIS\Desktop<version>\bin.
| Nombre de cliente de Geoportal Server | Archivo de propiedades en \\ArcGIS\Desktop10.0\bin |
|---|---|
Clientes de CSW | CswClient.properties |
Cliente de publicación | PublishClient.properties |
Cliente de WMC | WMCOpener.properties |
Cada archivo de propiedades tiene estos tres parámetros, que se pueden definir tal y como se describe. Después de cambiar el archivo de propiedades, debe volver a iniciar ArcGIS Desktop para que los cambios surtan efecto.
| Configuración | Descripción | Valores aceptados |
|---|---|---|
logFolder | Ubicación en la que deben escribirse los archivos de registro | ruta del archivo accesible en la red |
maxLogFileSizeInBytes | Tamaño máximo permitido por archivo de registro | entero |
depurar | establece el inicio de sesión en activado o desactivado Nota:a diferencia del registro de la aplicación web de Geoportal Server, solo existen dos niveles de registro para los clientes: activado o desactivado | activado/desactivado desactivado es el predeterminado |
El archivo CswClient.log para los clientes de CSW
Una vez que haya habilitado el registro para los clientes de CSW, puede investigar el archivo de registro para ver las solicitudes que los clientes de CSW han enviado a los extremos del catálogo de CSW. Para obtener más información sobre las solicitudes y respuestas que se gestionan mediante el cliente de CSW, consulte Cómo funcionan los clientes de CSW. Investigar la comunicación en el archivo CswClient.log puede revelar a menudo si existe algún problema en el extremo, el perfil que se está usando para comunicarse u otro problema de comunicación.
El archivo publishMetadata.log para Publicar cliente
Una vez que haya habilitado el registro para el cliente de publicación, puede investigar el archivo de registro publishMetadata.log para obtener información detallada sobre las sesiones de publicación y los resultados de estas. A continuación se muestra un archivo de registro de muestra. Puede ver otros mensajes además de los que encontrará en la muestra, dependiendo del recurso que se publica y si la sesión se completó correctamente.
************ Metadata Publishing started at 7/28/2010 11:20:38 AM ************
Publication Parameters
============================================================
Metadata Server Url : http://myserver:8080/geoportal
Publish Metadata Service Name : GPT_Publish_Metadata
Selected Workspace Name : \\networkServer\C$\Data\districts.shp.xml
Selected container category : XML Document
============================================================
EndPoint Type : DEFAULT
Publish url : http://myserver:8080/geoportal/rest/manage/document
Publish request : <metadata xml here>
Publish response :
Publication successful for \\networkServer\C$\Data\districts.shp.xml
************ Metadata Publishing completed at 7/28/2010 11:20:46 AM ************
En este archivo de registro se muestra la hora de inicio y de finalización de la sesión de publicación, los parámetros de entrada para la sesión y la respuesta acerca de si la sesión de publicación se realizó correctamente o no. La Publish request incluye los metadatos de los documentos que el cliente de publicación encuentra y publica. El EndPoint Type indica si se está utilizando el extremo de Geoportal Server predeterminado, que es el extremo de REST, o si se utiliza el extremo de CSW o de servlet. La Publish url corresponde a la dirección URL a ese extremo. En este ejemplo, usted puede ver que se menciona la url del extremo REST.
El WMCOpener.log para el cliente de WMC
Una vez que haya habilitado el registro para el cliente de WMC, puede investigar el archivo de registro WMCOpener.log para obtener información sobre los servicios a los que se hace referencia cuando se utiliza el cliente WMC. WMCOpener.log proporcionará la información de servicio que leyó del archivo WMC e informará si en realidad se agregó la capa al mapa. Si hay algún problema con el servicio y no se agrega al mapa, la información del servicio se enumerará en el registro, pero no se indicará que se ha agregado.