Instrucciones detalladas para instalar y configurar Sensor para WebSphere 5.x que se ejecuta en AIX 5.1 o posterior.
Los archivos de programa para Sensor están empaquetados en un archivo de instalación que se 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.
El Sensor para servidores WebSphere no admite experimentación controlada. Para obtener información sobre la experimentación controlada, consulte la Guía de experimentos controlados con Data Workbench.
Procedimiento para extraer e instalar los archivos de programa para Sensorto en el equipo servidor.
Inicie sesión como usuario raíz o como usuario con autoridad raíz.
Descomprima y descomprima el archivo de instalación utilizando el siguiente comando:
gunzip installationFilename.tar.gz
tar -xf installationFilename.tar
Copie los archivos de programa no empaquetados en los directorios identificados en la siguiente tabla:
Archivo | Descripción | Directorio de Target |
---|---|---|
libvisual_sciences.so | El módulo de carga del recolector | /usr/local/visual_sciences |
J2EECollector.jar | Bibliotecas del módulo de carga del recolector | Directorio WebSphere /lib |
txlogd | El programa transmisor | /usr/local/bin --OR-- /usr/local/sbin |
txlogd.conf | El archivo de configuración del sensor | /etc |
trust_ca_cert.pem | Certificado utilizado para validar el certificado digital que presenta Insight Server durante el proceso de conexión | /usr/local/visual_sciences |
El paquete de instalación contiene un archivo de hoja de cálculo denominado TestExperiment.xls. Esta hoja de cálculo es una herramienta que los arquitectos utilizan para configurar un experimento controlado. El propio sensor no utiliza este archivo, por lo que no es necesario instalar el archivo en el equipo en el que se está ejecutando Sensor (aunque puede elegir hacerlo). En su lugar, puede que desee copiar el archivo en una ubicación en la que sus arquitectos puedan acceder a él o simplemente extraer el archivo del paquete de instalación según sea necesario. Para obtener más información sobre la experimentación controlada, consulte la Guía de experimentos controlados con perspectiva.
Permisos en los archivos de programa
Los permisos incorrectos en los archivos de programa causan la mayoría de los problemas encontrados al instalar Sensor.
Asegúrese de establecer los permisos exactamente como se indica en esta sección.
De forma predeterminada, los archivos de programa del archivo tar tienen los siguientes permisos. Según la configuración del sistema, esta configuración se puede modificar (desenmascarar) al extraer los archivos.
Para restablecer los permisos a la configuración predeterminada recomendada, utilice los comandos chmod que se indican a continuación.
Compruebe que los directorios en los que ha instalado los archivos permiten al menos este nivel de acceso.
Archivo | Permisos predeterminados | chmod, comando |
---|---|---|
libvisual_sciences.so | rwx —x —x | chmod 711 |
J2EECollector.jar | rw- rw- | chmod 664 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- rw- | chmod 664 |
trust_ca_cert.pem | rw- rw- | chmod 664 |
Si desea utilizar permisos que no sean los predeterminados recomendados, revise la información en Permisos de archivos UNIX de sensor para asegurarse de que comprende cómo se utilizan estos archivos.
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 disco, la dirección de Insight Server y el ID que se adjuntará a los datos producidos por este sensor.
El archivo de configuración contiene los parámetros necesarios y los parámetros opcionales.
Para editar el archivo de configuración
Procedimiento para crear la cola de discos, después de configurar el archivo txlogd.conf.
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.
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
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.
Si la cola no se ha creado correctamente, escriba Ctrl+C para finalizar el transmisor y haga lo siguiente:
Para los servidores WebSphere, el recolector funciona como un filtro en el contenedor servlet.
Para agregar el recolector 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.
Con un editor de texto, abra el archivo web.xml para el servidor web cuyos eventos captura Sensor.
Agregue los siguientes elementos <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 el elemento <param-value>
.
<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>
Estas líneas distinguen entre mayúsculas y minúsculas. Escriba exactamente como aparecen arriba.
Reinicie la aplicación web. El recolector se carga con la aplicación y comienza a recopilar datos de evento y a escribirlos en la cola de disco.
Procedimiento para editar el script de inicio de Websphere para declarar la ubicación de los archivos J2EECollector.jar y libvisual_sciences.so .
Abra el archivo setupCmdLine.sh en el directorio Websphere /bin.
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
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
Guarde el archivo setupCmdLine.sh.
Procedimiento para iniciar el transmisor y comprobar que se puede conectar correctamente al servidor de Insight y transmitir datos de evento al mismo.
Para verificar que el transmisor pueda enviar correctamente datos de evento al servidor de Insight, asegúrese de que el servidor de Insight de destino esté instalado y en ejecución antes de comenzar la siguiente prueba.
Si el transmisor aún no está en ejecución, reiniciarlo utilizando el siguiente comando:
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
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).
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.
Si el sensor no transmite los datos correctamente, compruebe que:
Información para garantizar que el transmisor se cargue automáticamente cuando se reinicie 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 de error que genera el transmisor se escriben en syslog.
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.
Aunque las etiquetas de página y la modificación del encabezado pueden ocultar los datos, siguen estando disponibles para quienes examinan el código fuente de una página o miran los encabezados con las herramientas del complemento del navegador.
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 del conjunto de datos.
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" %>
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.
Repita este procedimiento para cada página .jsp desde la que desee capturar datos adicionales.