To install Analog, connect to your virtual server via Telnet or SSH and issue the commands below that match your virtual server operating system.

FreeBSD Analog 4.1 % vinstall analog

BSDI BSD/OS Analog 4.01 % cd % tar xvf /usr/local/contrib/analog4.01.tar

NOTE: To find out which operating system your virtual server is running, use the uname command.

Configuring Analog

Now that the Analog software is installed, you will need to configure it for your virtual server. The Analog configuration file is installed with the Analog software.

FreeBSD
~/usr/local/analog-4.1/analog.cfg

BSDI BSD/OS
~/usr/local/etc/httpd/analog4.01/analog.cfg

Edit the following lines in the Analog configuration file so that they contain the correct information.

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

BSDI BSD/OS LOGFILE /usr/local/etc/httpd/logs/access_log
OUTFILE /usr/local/etc/httpd/htdocs/analog4.01/index.html
HOSTNAME YOUR-DOMAIN.NAME

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 paramater indicates the domain name of your virtual server.

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.

FreeBSD
% virtual /usr/local/analog-4.1/analog

BSDI BSD/OS
% virtual /www/analog4.01/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:

FreeBSD
http://YOUR-DOMAIN.NAME/analog-4.1/index.html

BSDI BSD/OS
http://YOUR-DOMAIN.NAME/analog4.01/index.html

To have an Analog report regularly e-mailed to you, add something like one of the lfollowing to your cron configuration (the text below should all be placed on A SINGLE LINE in your cronfile):

FreeBSD
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

BSDI BSD/OS
59 23 * * 7 /usr/local/bin/virtual /www/analog4.01/analog +O- +a | /usr/bin/mail -s "Weekly Stats" user@YOUR-DOMAIN.NAME

This will cause your virtual server to send you an e-mail each Sunday night at 11:59pm containing your Analog analysis report in ASCII format. For more information concerning Analog command line arguments, see the documentation.

Documentation

Documentation will be installed on your virtual server when you install Analog. This documenation can be accessed in the following file:

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

BSDI BSD/OS
http://YOUR-DOMAIN.NAME/analog4.01/docs/Readme.html