WebSphere en AIX

Instrucciones detalladas para instalar y configurar Sensor para WebSphere 5.x con AIX 5.1 o posterior.

Los archivos de programa para Sensor se empaquetan en un archivo de instalación que se obtiene del sitio de descarga de Adobe. Si aún no dispone del archivo de Sensor instalación de su servidor web en particular, descárguelo (u obtenerlo de su representante de Adobe) antes de comenzar los siguientes procedimientos.

Instalación de los archivos Programa

Procedimiento para extraer e instalar los archivos programa para Sensorto en el equipo servidor.

1. Inicie sesión como usuario raíz o como usuario con autoridad raíz.

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

   gunzip installationFilename.tar.gz 
   tar -xf installationFilename.tar
   

3. Copie los archivos de programa sin empaquetar en los directorios identificados en la siguiente tabla:

Permisos en los archivos Programa

Los permisos incorrectos en los archivos programa causan la mayoría de los problemas que se producen al instalar Sensor.

Asegúrese de establecer los permisos exactamente como se indica en esta sección.

De forma predeterminada, los archivos programa del archivo tar tienen los siguientes permisos. Según la configuración del sistema, esta configuración se puede modificar (sin máscara) al extraer los archivos.

Para restablecer los permisos a la configuración predeterminada recomendada, utilice los comandos chmod siguientes.

Si desea utilizar permisos distintos de los predeterminados recomendados, consulte la información de Permisos de archivos de Sensor UNIX para asegurarse de comprender cómo se utilizan estos archivos.

Edit the Sensor Configuration file

El archivo txlogd.conf contiene los parámetros de configuración para Sensor.

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

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

• Los parámetros requeridos son configuraciones que debe especificar al instalar Sensor. Sin esta configuración, Sensor no se ejecuta correctamente.
• Los parámetros opcionales son valores predeterminados para valores predefinidos (que se pueden modificar) o para activar funciones opcionales.

Para editar el archivo de configuración

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

Inicio del transmisor y creación de la cola de discos

Procedimiento para crear la cola de discos, después de configurar el archivo txlogd.conf.

1. Si el directorio en el que reside la cola de discos no existe, créelo. Asegúrese de que el directorio proporciona al módulo del selector y al programa del transmisor acceso de lectura y escritura al archivo.

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

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

   • La opción "i" de este comando inicio 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.

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, a continuación, haga lo siguiente:

   1. Examine el archivo txtlogd.conf y verifique que los parámetros QueueFile y QueueSize estén configurados correctamente.
   2. Compruebe que el dispositivo al que está asignada la cola de discos está operativo 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.

Añadir el recopilador en la Aplicación web

Para los servidores WebSphere, el selector funciona como un filtro en el contenedor servlet.

Para agregar el selector a la aplicación web, agregue el filtro al descriptor de implementación web.xml de la aplicación web y reinicie la aplicación web.

1. Con un editor de texto, abra el archivo web.xml para el servidor web cuyas capturas de eventos Sensor.

2. Añada los siguientes <filter> y <filter-mapping> elementos en el archivo descriptor. Si no instaló txlogd.conf en el directorio /etc, debe introducir la ruta correcta a este archivo en el <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 la aplicación web. El recopilador se carga con la aplicación y empezará a recopilar datos de evento y a escribirlos en la cola de discos.

Declaración de la ubicación del recopilador y los archivos de objeto compartidos

Procedimiento para editar el script de inicio de Websphere para declarar la ubicación de los archivos J2EECollector.jar y libvisual_sciences.so.

1. Abra el archivo setupCmdLine.sh en el directorio Websphere /bin.

2. Después de la línea que define la variable $WAS_CLASSPATH, agregue la línea siguiente:

   WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
   

3. Después del bloque de mayúsculas y minúsculas que define la variable $WAS_LIBPATH, agregue la línea siguiente:

   WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
   

4. Save the setupCmdLine.sh file.

Comprobación del sensor

Procedimiento para realizar el inicio del transmisor y comprobar que puede conectarse correctamente al servidor de Insight y transmitir datos de evento al mismo.

1. Si el transmisor no se está ejecutando, reinícielo con el siguiente comando:

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

2. Abra un navegador (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 esté monitorizando Sensor).

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

4. Si Sensor no transmite datos correctamente, compruebe que:

   • Se está ejecutando destinatario Insight Server.
   • Los parámetros ServerAddress y ServerPort se establecen correctamente en txtlogd.conf. Si especificó ServerAddress con un nombre de servidor, intente utilizar 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 de destinatario Insight Server.

Añadir el transmisor a la secuencia de comandos de inicio del sistema

Información para garantizar que el transmisor se carga automáticamente cuando se reinicia el equipo del servidor web.

Añada el siguiente comando (que inicia el transmisor) en la secuencia de comandos de inicio del sistema.

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

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

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 selector de la plataforma J2EE (recopilador 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 a través del etiquetado de páginas o en los encabezados.

Por ejemplo, el recopilador J2EE puede utilizarse para capturar datos de costo por clic (CPC) para los vínculos mostrados en una página, información confidencial de un socio 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 de recopilador.

Cuando un sensor para la plataforma J2EE recibe una solicitud, invoca una clase de selector que importa la función appendToLog. La función appendToLog anexa a la solicitud inicial los parámetros de cadena de consulta especificados en la función appendToLog. Esto resulta en 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 colocación de publicidad o un 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 Dataset.

1. Añada el siguiente código a la parte superior de la página .jsp desde la que desea capturar los datos:

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

2. Utilice el método appendToLog() del objeto de recopilación para anexar los pares nombre-valor deseados a la cadena de consulta de la página .jsp solicitada. El siguiente ejemplo anexa "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.