WebLogic Server en Windows Server 2000 o posterior

Instrucciones detalladas para instalar y configurar Sensor para WebLogic Server 6.x o posterior que se ejecute en Microsoft Windows Server 2000 o posterior.

Los archivos de programa para Sensor están empaquetados en un archivo de instalación que usted obtiene del sitio de descarga de Adobe. Si todavía no tiene el archivo de instalación Sensor para su servidor web en particular, descárguelo (u obtenga el archivo de su representante de Adobe) antes de iniciar los siguientes procedimientos.

Para instalar y configurar Sensor, debe realizar los siguientes pasos:

Instalación de los archivos de programa

Procedimiento para extraer e instalar los archivos de programa del sensor.

1. En su servidor WebLogic, cree un directorio en el que instalar los archivos de programa del sensor. Tenga en cuenta que la cola de disco reside en este directorio, por lo que asegúrese de que el dispositivo que elija tenga espacio suficiente para guardar una cola del tamaño que necesita.

   C:\VisualSensor
   

2. Extraiga el contenido del archivo de instalación en el directorio que acaba de crear. Durante este paso, Sensor instala los siguientes archivos:

Edición del archivo de configuración del sensor

La variable txlogd.conf contiene los parámetros de configuración para Sensor.

Debe editar este archivo para especificar, entre otras cosas, el tamaño y la ubicación del archivo de cola de disco, la dirección del servidor de Insight y el ID que se adjuntará a los datos de evento producidos por este sensor.

El archivo de configuración contiene los parámetros necesarios y los parámetros opcionales.

• Parámetros necesarios son ajustes que debe especificar al instalar Sensor. Sin estos ajustes, el sensor no se ejecuta correctamente.
• Parámetros opcionales son configuraciones que se establecen de forma predeterminada en valores predefinidos (que puede modificar) o habilitar funciones opcionales.

Para editar el archivo de configuración del sensor

• Abra el /etc/txlogd.conf en un editor de texto y establezca los parámetros necesarios, así como los parámetros opcionales que desee.
• Guarde y cierre el archivo.

Para editar el archivo de configuración del sensor

1. Abra el /etc/txlogd.conf en un editor de texto y establezca los parámetros necesarios, así como los parámetros opcionales que desee.
2. Guarde y cierre el archivo.

Inicie el transmisor y cree la cola de disco

Después de configurar el archivo txlogd.conf, puede iniciar el programa del transmisor, registrarlo como un servicio de Windows y crear la cola de discos.

1. En el menú Inicio de Windows, seleccione Accesorios > Símbolo del sistema.

2. En la ventana del símbolo del sistema, vaya al directorio en el que instaló Sensor y ejecute el siguiente comando:

   txlog /regserver
   

   Este comando inicia el transmisor, crea la cola de discos y registra Sensor como un servicio de Windows.

3. Para confirmar que el transmisor se está ejecutando correctamente, haga clic en Inicio > Panel de control de Campaign > Herramientas administrativas > Servicios.

   NOTA

   Esta secuencia de comandos puede variar en función de la versión de Windows que utilice.

   1. En la lista de servicios, localice la entrada para Sensor y confirme que su estado es Started y que su tipo de inicio es Automatic.
   2. Cierre el panel de control de Servicios.

4. Para comprobar si el transmisor ha experimentado algún error durante el inicio, haga clic en Inicio > Panel de control de Campaign > Herramientas administrativas > Visor de eventos para abrir el Visor de eventos.

   1. En el panel izquierdo de la ventana Visor de eventos, seleccione el registro Aplicaciones .
   2. En el panel derecho, busque eventos con "Adobe" en la columna Origen.
   3. Si encuentra un error de "Adobe", haga doble clic en el error para mostrar la ventana Propiedades del evento. Esta ventana proporciona información detallada sobre el error.

5. Cuando termine de examinar el registro de aplicaciones, cierre el Visor de eventos.

6. Compruebe que el transmisor ha creado la cola de discos (Diskq2000.log) en el directorio donde instaló los archivos de programa Sensor y que es el tamaño especificado en el parámetro QueueSize del archivo txlogd.conf.

   Si la cola no se ha creado correctamente:

   1. Examine el archivo txtlogd.conf y verifique que el parámetro QueueSize esté configurado correctamente.

   2. Compruebe que el dispositivo en el que instaló el sensor tiene suficiente espacio disponible para guardar un archivo del tamaño especificado en el parámetro QueueSize.

   3. Con el panel de control de Servicios en Windows, detenga el transmisor.

   4. Elimine el archivo de cola.

   5. Vuelva a registrar Sensor como un servicio de Windows: en el menú Inicio de Windows, seleccione Accesorios > Símbolo del sistema. En la ventana del símbolo del sistema, vaya al directorio en el que instaló Sensor y ejecute el siguiente comando:

      txlog /regserver
      

El transmisor está diseñado para funcionar continuamente. Si reinicia la máquina, el transmisor se reinicia automáticamente. Si necesita iniciar y detener el transmisor manualmente, puede hacerlo usando el panel de control de Servicios en Windows.

Agregar el recopilador al servidor web

Para los servidores JBoss, el recolector funciona como un filtro en el contenedor de servlets.

Para añadir el selector al servidor web, debe editar la variable web.xml como se describe a continuación y reinicie la aplicación web.

1. Con un editor de texto, abra el web.xml para el servidor web cuyos eventos captura Sensor.

2. Agregue lo siguiente <filter> y <filter-mapping> al archivo descriptor. Si no instaló txlogd.conf en el directorio /etc, debe introducir la ruta correcta a este archivo en la <param-value> elemento:

   <filter>
     <filter-name>VSCollectorFilter</filter-name>
     <description></description>
     <filter-class>
         com.visualsciences.collector.VSCollectorFilter
       </filter-class>
     <init-param>
       <param-name>configPath</param-name>
       <param-value>C:/VisualSensor/txlogd.conf</param-value>
     <description></description>
     </init-param>
   </filter>
   
   <filter-mapping>
     <filter-name>VSCollectorFilter</filter-name>
     <url-pattern>/*</url-pattern>
   </filter-mapping>
   

   NOTA

   Estas líneas distinguen entre mayúsculas y minúsculas. Escriba exactamente como aparecen arriba.

3. Reinicie el proceso del servidor web (no tiene que reiniciar el equipo servidor completo, simplemente reinicie el proceso del servidor web). El recolector se carga con el servidor web y comienza a recopilar datos de evento y a escribirlos en la cola de disco.

Modificación del script de inicio

Instrucciones para iniciar la modificación del script.

En el script que se utiliza para iniciar WebLogic (por ejemplo, C:\bea\user_projects\mydomain\startServer.cmd), edite la línea "set JAVA_OPTIONS=" para establecer la definición java.library.path en el directorio que contiene el archivo visual_sciences.dll.

set JAVA_OPTIONS=-Djava.library.path=C:\Sensor
    directory

Captura de datos adicionales

Puede capturar datos de medición adicionales de aplicaciones web basadas en J2EE utilizando la funcionalidad appendToLog() .

1. Agregue el siguiente código a la parte superior de la página .jsp desde la que desee capturar datos:

   <%@ page import="com.visualsciences.collector.VSCollector" %>
   

2. Utilice el método appendToLog() del objeto recolector para anexar los pares nombre-valor deseados a la cadena de consulta de la página .jsp solicitada. El siguiente ejemplo añade "A=1" y "B=2" a la cadena de consulta de la página .jsp solicitada para la página /index.jsp:

   <html>
   <body>
     <h1>Hello World</h1>
     <%
       VSCollector collector = new VSCollector(request, response);
       collector.appendToLog("A", "1");
       collector.appendToLog("B", "2");
     %>
   </body>
   </html>
   

   El URI de solicitud resultante es /index.jsp?A=1&B=2.

3. Repita este procedimiento para cada página .jsp desde la que desee capturar datos adicionales.