Servidores JBoss, Tomcat y WebLogic en RedHat Linux o Sun Solaris

Instrucciones detalladas para instalar y configurar Sensor para implementaciones J2EE que se ejecuten en RedHat Linux 7.x o posterior, Sun Solaris SPARC 2.6 o posterior, o Sun Solaris x86 9 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.

Las implementaciones J2EE compatibles incluyen:

• JBoss Server 3.2.x o posterior
• Apache Jakarta Tomcat Server 4.1 o posterior
• WebLogic Server 6.x o posterior

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. Inicie sesión como usuario raíz o como usuario con autoridad raíz.

2. Descomprima y descomprima el archivo de instalación utilizando el siguiente comando:

   • En Linux:

     tar -zxf installationFilename.tar.gz
     

   • En Solaris:

     unzip -d installationFilename.tar.gz
      tar -xf installationFilename.tar
     

3. Copie los archivos de programa no empaquetados en los directorios identificados en la siguiente tabla:

Permisos en los archivos de programa

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. Si el directorio en el que reside la cola de discos no existe, créelo. Asegúrese de que el directorio proporciona acceso de lectura/escritura al archivo tanto al módulo del recolector como al programa del transmisor.

   Para obtener más información sobre los permisos requeridos por los archivos de cola de disco, consulte Permisos de archivo UNIX de sensor.

2. En el equipo en el que está instalado Sensor, ejecute el siguiente comando para iniciar el transmisor:

   /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
   

   • La opción "i" de este comando inicia el transmisor en "modo interactivo". Este modo muestra los mensajes del transmisor en la pantalla y también le permite interactuar con el transmisor mediante comandos de teclado.
   • La opción "c" indica al transmisor que cree la cola de discos.
   • La opción "f" especifica la ubicación del archivo de configuración.

   Para obtener más información sobre las opciones que puede utilizar al iniciar el transmisor, consulte Opciones de la línea de comandos del transmisor de sensores.

3. Compruebe que el transmisor ha creado la cola de discos en la ubicación especificada en el parámetro QueueFile y del tamaño especificado en el parámetro QueueSize.

4. Si la cola no se ha creado correctamente, escriba Ctrl+C para finalizar el transmisor y haga lo siguiente:

   1. Examine el archivo txtlogd.conf y verifique que los parámetros QueueFile y QueueSize estén correctamente configurados.
   2. Compruebe que el dispositivo al que está asignada la cola de disco funciona y que tiene suficiente espacio disponible para guardar un archivo del tamaño especificado en el parámetro QueueSize.
   3. Realice las correcciones necesarias y repita este procedimiento.

Agregar el recopilador al servidor web

Para los servidores Apache, el recolector es un objeto compartido dinámico que se carga en el proceso del servidor web.

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

1. Con un editor de texto, abra el httpd.confpara 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>/etc/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.

Comprobación del sensor

Compruebe que el recolector recopila datos de evento y que el transmisor los está transmitiendo al servidor de Insight de destino.

1. Si el transmisor aún no está en ejecución, reiniciarlo utilizando el siguiente comando:

   /usr/local/bin/txlogd -i -f /etc/txlogd.conf
   

2. Abra un explorador (en cualquier equipo) y solicite una página del servidor web en el que se está ejecutando Sensor (asegúrese de seleccionar una página que el Sensor esté monitorizando).

3. Después de emitir la solicitud, compruebe si hay mensajes en la consola del transmisor que indiquen que está enviando datos de evento al servidor de Insight de destino.

4. Si el sensor no transmite los datos correctamente, compruebe que:

   • Se está ejecutando el destino Insight Server.
   • Los parámetros ServerAddress y ServerPort se establecen correctamente en txtlogd.conf. Si especificó ServerAddress con un nombre de servidor, intente usar su dirección IP numérica en su lugar.
   • El valor del parámetro CertName coincide exactamente con el nombre común que aparece en el certificado digital del servidor de Insight de destino.

Agregar el transmisor al script de inicio del sistema

Información sobre la carga automática del transmisor en el script de inicio del sistema.

Para asegurarse de que el transmisor se carga automáticamente cuando se reinicia el equipo del servidor web, agregue el siguiente comando (que inicia el transmisor) al script de inicio del sistema:

/usr/local/bin/txlogd -f /etc/txlogd.conf

Este comando inicia el transmisor como un demonio. Los mensajes de funcionamiento y error que genera el transmisor se escriben en syslog.

La configuración predeterminada de Solaris es 60. En función de las pruebas realizadas con Sensor, que utiliza tres semáforos para cada caso, Adobe recomienda usar 1024 como configuración. Este número es lo suficientemente alto como para que Sensor funcione junto con cualquier otra aplicación del servidor que pueda requerir semáforos, pero que no afecte al rendimiento. Para apoyar esta recomendación, tenga en cuenta que Adrian Cockcroft declaró lo siguiente en su libro Sun Performance and Tuning (Prentice Hall, octubre de 1994): "Las bases de datos tienden a utilizar muchos ajustes de memoria compartida y de semáforo. No afectan al rendimiento; mientras sean lo suficientemente grandes, los programas se ejecutarán".

Captura de datos adicionales

Los sensores de todas las plataformas pueden recopilar cualquiera de los datos disponibles en los encabezados de solicitud y respuesta HTTP.

Los sensores de la plataforma J2EE proporcionan un mecanismo para recopilar datos que no están disponibles en otras plataformas. El recolector para la plataforma J2EE (recolector J2EE) se encuentra en la capa de la aplicación, lo que le permite recopilar datos confidenciales que solo están disponibles para la aplicación y que no deben exponerse mediante el etiquetado de páginas o en los encabezados.

Por ejemplo, el recolector J2EE se puede utilizar para capturar datos de costo por clic (CPC) para vínculos mostrados en una página, información confidencial de socios en una página y muchos otros puntos de datos. El entorno J2EE le facilita la modificación de su WEBAPP para capturar estos datos personalizados con nuestra clase recopiladora.

Cuando un sensor para la plataforma J2EE recibe una solicitud, invoca una clase de recolector que importa la función appendToLog . La función appendToLog adjunta a la solicitud inicial los parámetros de cadena de consulta especificados en la función appendToLog. Esto da como resultado el URI de la solicitud inicial que contiene pares de nombre-valor de cadena de consulta adicionales que corresponden a los nombres y valores de los datos que se están capturando. Por ejemplo, CPC=20 se anexaría a la solicitud inicial cuando el valor de una ubicación de publicidad o vínculo de pulsación en particular sea de 20 centavos. Insight Server procesa estos valores en el conjunto de datos para su análisis. Una ventaja adicional de esta metodología de recopilación es que permite la recopilación de datos adicionales sin crear entradas de registro adicionales, ya que se pueden crear mediante metodologías de etiquetado de páginas.

Para obtener más información sobre el procesamiento, consulte la Guía de configuración de conjuntos de datos.

Para capturar datos adicionales de una página

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.

Recursos de Business.Adobe.com

Voice Analytics Lookalike Modeling Data Explorer Data Ingestion Mobile Marketing Ad Hoc Analysis