Instrucciones detalladas para instalar y configurar Sensor para un servidor Apache 1.3.x en RedHat Linux 7.x o posterior, SUSE Linux 9.x o posterior, Sun Solaris SPARC 2.6 o posterior, Sun Solaris x86 9 o posterior, FreeBSD 4 o posterior, o Mac OS X PowerPC.
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 (u obtenerlo de su representante de Adobe) antes de comenzar los siguientes procedimientos.
Para instalar y configurar Sensor, debe realizar los siguientes pasos de alto nivel:
Instrucciones para extraer e instalar los archivos programa para Sensor 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 con el siguiente comando:
En Linux:
tar -zxf installationFilename.tar.gz
En Solaris:
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
Copie los archivos de programa sin empaquetar en los directorios identificados en la siguiente tabla:
Archivo | Descripción | Directorio de destinatarios |
---|---|---|
mod_visual_sciences.so | El módulo de carga del selector | apachePath/libexec |
txlogd |
El programa del 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 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.
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. Compruebe que los directorios en los que ha instalado los archivos permiten al menos este nivel de acceso.
Archivo | Permisos predeterminados | chmod, comando |
---|---|---|
mod_visual_sciences.so | rwx r-x r-x | chmod 755 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- rw- r— | chmod 664 |
trust_ca_cert.pem | rw- rw- r— | chmod 664 |
El txlogd.conf archivo 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.
Para editar el archivo de configuración del sensor
Instrucciones 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 al módulo del selector y al programa del transmisor acceso de lectura y escritura al archivo.
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
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, a continuación, haga lo siguiente:
Para los servidores Apache, el selector es un objeto compartido dinámico que se carga en el proceso del servidor web.
Para agregar el selector al servidor web, debe editar el archivo httpd.conf como se describe a continuación y reiniciar el servidor web.
Si Sensor está capturando datos para varios servidores Web en el equipo servidor, debe realizar el siguiente procedimiento para cada servidor Web.
Con un editor de texto, abra el httpd.conf archivo para el servidor web cuyas capturas de eventos Sensor.
Añada las líneas siguientes al final del archivo:
LoadModule visual_sciences_module libexec/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
AddModule mod_visual_sciences.c
Estas líneas distinguen entre mayúsculas y minúsculas. Escriba exactamente como aparecen arriba.
Reinicie el servidor web. El recopilador se carga con el servidor web y empezará a recopilar datos de evento y a escribirlos en la cola de discos.
Inicio el transmisor y verifique que se pueda conectar correctamente al servidor de Insight y transmitir datos de evento al mismo.
Para comprobar que el transmisor puede enviar correctamente datos de evento al servidor de Insight, asegúrese de que el servidor de destinatario Insight está instalado y en ejecución antes de comenzar la siguiente prueba.
Si el transmisor no se está ejecutando, reinícielo con el siguiente comando:
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
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).
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.
Si Sensor no transmite datos correctamente, compruebe que:
Se está ejecutando destinatario Insight Server.
Los parámetros ServerAddress y ServerPort se configuran 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 CertName parámetro coincide exactamente con el nombre común que aparece en el certificado digital de destinatario Insight Server.
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.
Algunos usuarios de Solaris pueden encontrar un error "no se puede adquirir mutex". Para que Sensor funcione correctamente en estos sistemas, es necesario agregar o editar la siguiente línea en el archivo /etc/system:
semsys:seminfo_semmnu=1024
La configuración predeterminada de Solaris es 60. En base a 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 requiera 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 semáforo. No afectan al rendimiento; mientras sean lo suficientemente grandes, los programas correrán".