Configuración de informes XML

El Lanzador de aplicaciones puede utilizar el protocolo HTTP o HTTPS para enviar información de eventos como datos XML al servlet de informes de Gestión de aplicaciones de ZfD (zfdamrServlet). El servlet procesa los mensajes y los añade a una base de datos compatible con JCBC*, como la base de datos Sybase incluida con ZfD.

Para configurar informes XML, deberá realizar las tareas siguientes:

• Cumplimiento de los requisitos del servlet de informes
• Instalación del servlet de informes
• Configuración del servlet de informes
• Habilitar la directiva Destinos XML
• Configuración de objetos Aplicación para utilizar los informes XML

Cumplimiento de los requisitos del servlet de informes

El servlet de informes requiere uno de los entornos de servidor siguientes. Los números de versión enumerados son los requisitos de versión mínimos.

¹ Se necesita Support Pack 2 o versiones posteriores. Sin Support Pack 2 o versiones posteriores, el servlet de informes hace que la utilización del servidor aumente al 100% y permanezca en este porcentaje.

Para obtener información acerca de la instalación de Tomcat en NetWare 6, consulte la documentación de NetWare 6.

Para obtener información acerca de la instalación de Tomcat en Windows 2000, consulte el sitio Web de Apache Tomcat.

Instalación del servlet de informes

1. Asegúrese de que el entorno de red en el que está instalando el servlet de informes cumple los requisitos de software que aparecen en la sección anterior, Cumplimiento de los requisitos del servlet de informes .

2. Copie el archivo zfdamrServlet.war del directorio PUBLIC\REPORTING\CANNED\NAL REPORTS en el volumen SYS del servidor de ZfD en el directorio WEBAPPS de Tomcat.

   El archivo también está disponible en el CD Programa de ZfD 4 del directorio ZENWORKS\PRODUCTS\APPMGMT\NAL REPORTS.

3. Reinicie Tomcat para expandir el archivo zfdamrServlet.war.

   o bien,

   si no desea reiniciar Tomcat, utilice las herramientas que se proporcionan con Tomcat para expandir el archivo.

Configuración del servlet de informes

El servlet de informes tiene que conocer la información acerca de la base de datos en la que se escribirán los eventos de informes. Para proporcionar esta información:

1. Abra el archivo WEB.XML. El archivo se encuentra en el directorio WEBAPPS\ZFDAMRSERVLET\WEB-INF de Tomcat

2. Si está utilizando una base de datos Sybase, localice el parámetro dbip > cambie el valor del parámetro a la dirección IP del servidor de la base de datos. La dirección IP es el único parámetro que tiene que modificar para una base de datos Sybase.

   o bien,

   si está utilizando una base de datos distinta a la de Sybase, modifique los parámetros, descritos a continuación, como lo requiere la base de datos.

   dbuser: introduzca un nombre de usuario que tenga acceso de escritura a la base de datos. No es necesario el acceso de lectura. El nombre de usuario preconfigurado (MW_DBA) es el nombre de usuario de lectura-escritura por defecto para una base de datos creada con el programa de instalación de ZfD. Si está utilizando una base de datos Sybase de ZfD y no ha cambiado el nombre de usuario de lectura-escritura por defecto, no tiene que modificar este parámetro.

   dbpasswd: introduzca la contraseña para el nombre de usuario especificado en el parámetro dbuser. La contraseña preconfigurada (novell) es la contraseña de usuario de lectura-escritura por defecto para una base de datos Sybase creada con el programa de instalación de ZfD. Si está utilizando una base de datos Sybase de ZfD y no ha cambiado la contraseña de usuario de lectura-escritura por defecto, no tiene que modificar este parámetro.

   dbip: introduzca la dirección IP del servidor que ejecuta la base de datos.

   dbport: introduzca el puerto en el que está escuchando la base de datos. El puerto preconfigurado (2638) es el puerto del servidor NetWare por defecto para una base de datos Sybase creada con el programa de instalación de ZfD. Si está utilizando una base de datos Sybase de ZfD instalada en NetWare y no ha cambiado el puerto por defecto, no tiene que modificar este parámetro.

   dbprotocol: introduzca el protocolo que se va a utilizar al acceder a la base de datos. Para Sybase, es jdbc: (el valor preconfigurado).

   dbsubprotocol: introduzca el subprotocolo que se va a utilizar al acceder a la base de datos. Para Sybase, es sybase: (el valor preconfigurado).

   dbsubname: introduzca el nombre secundario que se va a utilizar al acceder a la base de datos. Para Sybase, es Tds: (el valor preconfigurado).

   dbdriver: introduzca la clase completa del controlador que va a utilizar al acceder a la base de datos. La unidad debe asistir el protocolo que aparece en el parámetro dbprotocol. Para Sybase, es com.sybase.jdbc2.jdbc.SybDriver (el valor preconfigurado).

3. Guarde el archivo.

4. Reinicie Tomcat.

Habilitar la directiva Destinos XML

Para que el Lanzador de aplicaciones pueda informar de eventos de aplicación mediante XML, tiene que:

• Habilitar una directiva Destinos XML en un Paquete de ubicaciones del servicio de eDirectory. La directiva Destinos XML identifica las ubicaciones Web (URL) donde desea que se envíen los datos XML. Si está empleando el servlet de informes Gestión de aplicaciones, ésta será la URL de dicho servlet. Un paquete de ubicaciones del servicio sólo puede tener una directiva Destinos XML. Si no ha creado ningún paquete de ubicaciones del servicio, o bien, si se están utilizando sus directivas Destinos XML de los paquetes actuales para especificar otras ubicaciones, tendrá que crear un nuevo Paquete de ubicaciones del servicio. En los pasos siguientes se detallan las instrucciones.
• Asocie el Paquete de ubicaciones del servicio a los contenedores en los que se encuentran los usuarios o las estaciones de trabajo cuyos informes desea enviar a la URL Web.

Para activar una directiva Destinos XML y asociarla a contenedores:

1. En ConsoleOne, haga clic con el botón derecho del ratón en el Paquete de ubicaciones del servicio que desea utilizar > haga clic en Propiedades.

   o bien,

   Si no tiene un Paquete de ubicaciones del servicio, haga clic con el botón derecho del ratón en el contenedor en el que desea crear uno > haga clic en Nuevo > haga clic en Paquete de directivas. Para crear un Paquete de ubicaciones del servicio, siga las instrucciones del Asistente del paquete de directivas.

   
   

2. En la página General, active la casilla de verificación en la columna Habilitado para habilitar la directiva Destinos XML.

3. Seleccione la directiva Destinos XML en la lista > haga clic en Propiedades para mostrar la página de propiedades Destinos XML.

   
   

4. Haga clic en Añadir para que aparezca el recuadro de diálogo URL XML > introduzca la URL a la que desea que se envíen los datos XML > haga clic en Aceptar para añadir la URL a la lista.

   La URL del servlet de informes es:

   http://ip_address/zfdamrServlet/run

   donde dirección_ip es la dirección IP o el nombre host DNS del servidor en el que se ejecuta el servlet de informes.

5. Repita el Paso 4para añadir más URL.

6. Cuando termine, haga clic en Aceptar para regresar a la página General.

7. Haga clic en Asociaciones para mostrar la página Asociaciones.

   
   

   Utilice esta página para asociar el Paquete de ubicaciones del servicio a los contenedores en los que se encuentran los usuarios o las estaciones de trabajo cuyos informes XML desea enviar a la URL Web. Si un determinado contenedor padre incluye varios contenedores en los que residen los objetos Usuario y Estación de trabajo, puede seleccionar el contenedor padre en lugar de todos los contenedores.

8. Haga clic en Añadir > busque y seleccione el contenedor que desea añadir > haga clic en Aceptar para añadirlo a la lista.

9. Repita el Paso 9 para añadir más contenedores.

10. Cuando termine, haga clic en Aceptar para guardar la información.

Configuración de objetos Aplicación para utilizar los informes XML

Cuando haya habilitado la directiva Destinos XML, puede iniciar la configuración de objetos Aplicación para utilizar informes XML. Ya que la información de eventos se configura por aplicación, puede elegir las aplicaciones para las que desea que se reúnan informes y para las que no.

Para obtener instrucciones detalladas acerca de la configuración de una aplicación para utilizar informes XML, consulte Configuración de aplicaciones para utilizar informes .