Show Menu
TEMAS×

JBoss Server en Windows Server 2000 o posterior

Instrucciones detalladas para instalar y configurar Sensor para JBoss Server 4.0.5 o posterior que se ejecuta en Microsoft Windows Server 2000 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 instalación de Sensor para su servidor web en particular, descárguelo (o consiga el archivo a su representante de Adobe) antes de comenzar los siguientes procedimientos.
Las implementaciones J2EE admitidas incluyen:
  • JBoss Server 4.0.5 o posterior que se ejecuta en Microsoft Windows Server 2000 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 para Sensor.
  1. En el servidor JBoss, cree un directorio en el que instalar los archivos de programa de Sensor. Tenga en cuenta que la cola de discos reside en este directorio, por lo que asegúrese de que el dispositivo que elija tenga espacio suficiente para mantener 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:
Archivo Descripción Directorio de objetivos
mod_visual_sciences.so Módulo de carga del selector. IBMHttpServer/módulos
txlogd
El programa de transmisores.
/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 Insight Server presenta durante el proceso de conexión /usr/local/visual_sciences
El paquete de instalación contiene un archivo de hoja de cálculo llamado TestExperiment.xls. Esta hoja de cálculo es una herramienta que los arquitectos utilizan para configurar un experimento controlado. El sensor mismo 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 los 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.

Editar el archivo de configuración del sensor

El txlogd.conf archivo 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 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 puede modificar) o para activar funciones opcionales.
Para editar el archivo de configuración del sensor
  • Abra el /etc/txlogd.conf archivo en un editor de texto y defina los parámetros requeridos, 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 archivo 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.

Iniciar el transmisor y crear 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, navegue 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 > Herramientas administrativas > Servicios.
    Esta secuencia de comandos puede variar en función de la versión de Windows que utilice.
    1. En la lista de servicios, busque la entrada para Sensor y confirme que su estado es Iniciado y que su tipo de inicio es Automático.
    2. Cierre el panel de control Servicios.
  4. Para comprobar si el transmisor ha experimentado algún error durante el inicio, haga clic en Inicio > Panel de control > 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 de 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 en el que instaló los archivos del programa Sensor y que es el tamaño especificado en el parámetro QueueSize en el 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ó Sensor tiene suficiente espacio disponible para guardar un archivo del tamaño especificado en el parámetro QueueSize.
    3. Con el panel de control Servicios en Windows, detenga el transmisor.
    4. Elimine el archivo de cola.
    5. Volver 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, navegue 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 mediante el panel de control Servicios de Windows.

Agregar el recopilador al servidor Web

Para los servidores JBoss, el selector funciona como un filtro en el contenedor servlet.
Para agregar el selector al servidor web, debe editar el web.xml archivo como se describe a continuación y reiniciar la aplicación web.
  1. Con un editor de texto, abra el web.xml archivo del servidor web cuyos eventos captura Sensor.
  2. Agregue los siguientes <filter> y <filter-mapping> elementos al 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> 
    
    
    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 todo el equipo del servidor, simplemente reinicie el proceso del servidor web). El recopilador se carga con el servidor web y comienza a recopilar datos de eventos y a escribirlos en la cola de discos.

Modificación de la secuencia de comandos de inicio

Antes de modificar la secuencia de comandos de inicio, asegúrese de que la variable JAVA_HOME está definida en el entorno de Windows.
En el run.bat archivo (por ejemplo, C:\jboss-4.0.5.GA\bin\run.bat), agregue las siguientes líneas cerca del final del archivo justo antes de las líneas de "eco" que preceden al comando de inicio del servidor JBoss:
set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;C:\jboss-4.0.5.GA\server\default\lib\javax.servlet.jar;C:\VisualSciences\J2EECollector.jar 
set JAVA_OPTS=%JAVA_OPTS% -Djava.library.path=C:\VisualSciences

Captura de datos adicionales

Puede capturar datos de medición adicionales desde aplicaciones web basadas en J2EE mediante la funcionalidad appendToLog().
  1. Agregue 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.