Analog

Overview
Installation and Configuration
Documentation

Installing and Configuring Analog
To install Analog, Telnet or SSH to your Virtual Server and do the following:

1. Install analog:
   
   
   % vinstall analog
   
   
2. Now that the Analog software is installed, you will need to configure it for your Virtual Server:
   ~/usr/local/analog-4.1/analog.cfg
   
   Edit the following lines in the Analog configuration file so that they contain the correct information:
   
   

   LOGFILE /usr/local/etc/httpd/logs/access_log 
   OUTFILE /usr/local/etc/httpd/htdocs/analog-4.1/index.html 
   HOSTNAME YOUR-DOMAIN.COM 

   The LOGFILE parameter designates the path and filename of the TransferLog file on your Virtual Server. The OUTFILE parameter designates the file that your Virtual Server's web server statistics will be written to. The HOSTNAME parameter indicates the domain name of your Virtual Server.

3. Analog has already been compiled for your use. All that you need to do once the configuration file is ready is run the Analog program to create an HTML page with your Virtual Server's web statistics.
   
   
   % virtual /usr/local/analog-4.1/analog
   
   

   This will create a page with your Virtual Server's web statistics at the location and filename you specified in the analog.cfg configuration file. According to the configuration above the page with your statistics would be located at:

   http://YOUR-DOMAIN.COM/analog-4.1/index.html
   
   

4. To have an Analog report regularly emailed to you, add something like the following to your crontab (the text below should all be placed on a single line in your cron file):
   
   
   59 23 * * 7 /usr/local/bin/virtual /usr/local/analog-4.1/analog +O- +a | /usr/bin/mail -s "Weekly Stats" user@YOUR-DOMAIN.NAME
   
   
   This will cause your Virtual Server to send you an email each Sunday night at 11:59 pm containing your Analog analysis report in ASCII format. For more information concerning Analog command line arguments, see the documentation.

Documentation
Local documentation will be installed on your Virtual Server when you install Analog. This documentation can be accessed in the following file:

http://YOUR-DOMAIN.NAME/analog-4.1/docs/Readme.html