Instructions for installing and configuring Sensor for Apache Server 1.3, Apache Server 2.0.42 or later, or Apache Server 2.2 running under Microsoft Windows Server 2000 or later.
The program files for Sensor are packaged in an installation file that you obtain from the Adobe download site. If you do not already have the Sensor installation file for your particular web server, download it (or obtain it from your Adobe representative) before you begin the following procedures.
Before installing the program files, you must determine where you want to maintain the disk queue because that is also where you must install the program files.Procedure to extract and install the program files for Sensor.
To install and configure Sensor, you must perform the following steps:
On your Windows machine, create a directory in which to install the Sensor program files. Keep in mind that your disk queue also resides in this directory, so be sure the device you choose has sufficient space to hold a queue of the size you need.
Extract the contents of the installation file into the directory you just created. During this step, Sensor installs the following files:
|EventMessages.dll||Event Viewer messages.|
|mod_visual_sciences.dll||The collector module.|
An Excel spreadsheet file that architects can use to configure a controlled experiment. Sensor does not use this file.
|trust_ca_cert.pem||The certificate used to validate the digital certificate that Insight Server presents during the connection process.|
|TXLog.exe||The transmitter program|
|txlogd.conf||The Sensor configuration file|
The installation package contains a spreadsheet file called TestExperiment.xls. This spreadsheet is a tool that architects use to configure a controlled experiment. Sensor itself does not use this file, so it is not necessary to install the file on the machine where Sensor is running (although you can choose to do so). You might want to, instead, copy the file to a location where your architects can access it or simply extract the file from the installation package as needed. For more information about controlled experimentation, see the Insight Controlled Experiments Guide.
The txlogd.conf file contains the configuration parameters for Sensor.
You must edit this file to specify, among other things, the size and location of the disk queue file, the address of the Insight Server, and the ID that will be attached to the event data produced by this sensor.
The configuration file contains required parameters and optional parameters.
To edit the Sensor configuration file
To edit the Sensor configuration file
After you configure the txlogd.conf file, you can start the transmitter program, register it as a Windows service, and create the disk queue.
If the directory in which the disk queue resides does not already exist, create it. Make sure that the directory provides both the collector module and the transmitter program with read/write access to the file.
For more information about the permissions required by the disk queue files, see Sensor UNIX File Permissions.
On the computer where Sensor is installed, execute the following command to start the transmitter:
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
For additional information about the options you can use when starting the transmitter, see Sensor Transmitter Command-Line Options.
Verify that the transmitter has created the disk queue in the location specified in the QueueFile parameter and of the size specified in the QueueSize parameter.
f the queue has not been created correctly, type Ctrl+C to terminate the transmitter, then do the following:
For Apache servers, the collector is a dynamic shared object that you load into your web server process.
To add the collector to your web server, you must edit the httpd.conf file as described below and restart your web server.
If Sensor is capturing data for multiple web servers on the server computer, you must perform the following procedure for each web server.
Using a text editor, open the httpd.conffile for the web server whose events Sensor captures.
Add the following two lines to the end of the file:
LoadModule visual_sciences_module modules/mod_visual_sciences.so VisualSciencesConfig /etc/txlogd.conf
These lines are case sensitive. Type them exactly as they appear above.
Restart the web server process (you do not have to reboot the entire server computer, simply restart the web server process). The collector is loaded with the web server and begins collecting event data and writing it to the disk queue.