A Little Technology Shoppe LLC Contrib: Analog 4.1

Contributed Programs

Analog 4.1

Last Updated: August 10, 2000

Version 4.1+ of the Analog web server logfile analysis program is a completely rewritten version of the most popular logfile analyzer in the world. The most important new features are:

Eleven new report types
Ability to read logfiles in user-customized format
Faster and more flexible sorting of reports
More flexible language support
Improved documentation

Installation
Documentation

Installation

Installing Analog
To install Analog 4.01, connect to your Virtual Server via telnet or SSH, and issue the commands below that match your Virtual Server O/S.

FreeBSD Analog 4.1
% vinstall analog

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

NOTE: If your Virtual Server was ordered after December 1, 1999, you are likely running FreeBSD. To find out which O/S your Virtual Server is running, use the uname command:

% uname

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

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

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

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

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 following lines to your Crontab (the text below should all be placed on a single line):

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

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

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

Documentation

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

~/usr/local/etc/httpd/htdocs/analog4.01/docs/Readme.html or
http://www.YOUR-DOMAIN.NAME/analog4.01/docs/Readme.html

The Analog home page can be found at:

http://www.statslab.cam.ac.uk/~sret1/analog/

Copyright © 1996-2000.A Little Technology Shoppe LLC, alts.net®. All rights reserved. All brand names and product names used on these web pages are trademarks, or trade names of their respective holders.