# Basic installation instructions

In order to make the output of the CGI scripts cacheable, you need to "hide" the fact that they are indeed CGI scripts to cache servers. This means that you shouldn't use "cgi-bin" for the directory where the scripts are installed. Personally, I use the following customization in Apache's srm.conf file to redirect two URLs to the directories where I install the NORDstat software:

    	ScriptAlias /stat-q/ /archive/traffic/cgi/
    	Alias /stats/ /archive/traffic/html/

The customization is done in `Makefile.inc` in the top-level source directory. The distributed copy is available as `Makefile.inc.dist`. If you are upgrading from an earlier version, you need to check if you need to update your Makefile.inc with more configurable variables.

If you decide you don't want (or can't) use Berkeley make, you will need to edit some (most?) of the makefiles.

After customizing `Makefile.inc`, do "make install" as the user which will own the files. This should install the software where you pointed `TOPDIR` in `Makefile.inc`.

Make your own list of routers to poll. An example can be found in `site/ifs.cf`, install it in `TOPDIR/conf`. (Warning: the format and name of this file will change, hopefully for the better.)

Install something similar to the following in your machine's startup job (in my case, in `/etc/rc.local`):

    	# Traffic poller
    	if [ -x /archive/traffic/bin/startup ]; then
    	        su he -c /archive/traffic/bin/startup
    	        su he -c /archive/traffic/bin/start-nanny
    	        echo -n ' traffic-poller'
    	fi

Substitute "he" with the user owning the NORDstat files.

Manually start up the traffic poller by performing the two main commands above manually. Data should now start being collected in `TOPDIR/data/today`.

Install crontab job lines for the user which owns the NORDstat similar to the following:

    	57 23 * * *     /archive/traffic/bin/daily
    	0   7 * * *     /archive/traffic/bin/compress-data.pl
    	0   1 * * 1     /archive/traffic/bin/report-week
    	0   5 1 * *     /archive/traffic/bin/report-month

This completes the basic installation of the NORDstat system.

Last modified: Thu Jun 26 12:37:12 MET DST 1997