INSTALLING TEXTCNX SOFTWARE
===========================

Installation of this software requires the following activities:
 * setting up the measurements database
 * editing the scripts and installing them on your system
 * setting up a crontab entry for running the tests

The software is available on the following URL:
	http://download.vanrein.org/TAR/testcnx-1.0.tar.gz
and is documented on
	http://rick.vanrein.org/linux/testcnx/


Setting up the measurements database
------------------------------------

These are usually located in /var/cnx, and you should create that directory.
Before you can test the web interface, there should be files packetcount
and timing in there; the testing script creates these, but you might as well
create them empty to start with:

	mkdir /var/cnx
	touch /var/cnx/packetcount
	touch /var/cnx/timing

I prefer to do this as root, so nobody else can access the data.


Editing the scripts and installing them on your system
------------------------------------------------------

The configuration of the scripts is done in /etc/testcnx.conf.
This is a plain bash styled shell script that sets a number of parameter.
If you store the config file elsewhere, edit the location in the scripts.

Install the files as follows:
	testcnx			-> /usr/local/sbin/
	testcnx.conf		-> /etc/
	testcnx.packets		-> /var/www/cgi-bin/   (for example)
	testcnx.timing		-> /var/www/cgi-bin/   (for example)
	*.png			-> /var/www/html/img/  (for example)


Setting up a crontab entry for running the tests
------------------------------------------------

As root (to avoid that others can read your files), you should add a line to
your crontab (with the command crontab -e) that reads

00 00 * * * /usr/local/sbin/testcnx &

This will start the test next midnight. The script will be running for a whole
day, with one ping every minute.


When all works, please notify me of your test, so I can publish it on the web
site for this package; make sure to tell me on rick@vanrein.org if you altered
the software, so I can judge if your test is comparable to the one I made.
I would also like your MYISP setting, so people can look for that.
Don't want to compare lemons and oranges!


Cheers,

Rick.