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 router config file. An example can be found in site/ifs.cf, install it in TOPDIR/conf. (Warning: the format 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   1 * * 1     /archive/traffic/bin/report-week
	0   5 1 * *     /archive/traffic/bin/report-month

This completes the basic installation of the NORDstat system.


he@nordu.net
Last modified: Thu Jun 26 00:59:12 MET DST 1997