Add install procedure for MRTG to Admin manual (g0vgs)

[spider.git] / sgml / adminmanual.sgml

diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml
index 4a9638f9af5a81fb5c19be0312e1978ccdf635be..3a46f544d819eb94d76008702d4c15d71c07cb0a 100644 (file)
--- a/sgml/adminmanual.sgml
+++ b/sgml/adminmanual.sgml
@@ -7,7 +7,7 @@
 <title>The DXSpider Administration Manual v1.50</title> \r
 <author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net), and\r
 Charlie Carroll, K1XX, (k1xx@ptcnh.net)</author>\r
-<date>July 2002 revision 0.1</date>\r
+<date>January 2003 revision 0.2</date>\r
 \r
 <abstract>\r
 A reference for SysOps of the DXSpider DXCluster program.\r
@@ -1445,6 +1445,89 @@ choosing (probably your cluster callsign) on the html page.
 You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi\r
 </verb>\r
 \r
+<sect>Web based statistics\r
+\r
+<P>\r
+From version 1.50, you can use the freeware software MRTG to produce\r
+really nice graphical statistics on your web site.  For an example\r
+try <htmlurl url="http://www.gb7mbc.net/mrtg/stats.html" name="http://www.gb7mbc.net/mrtg/stats.html">.\r
+\r
+<P>\r
+The following should help you get it all working.\r
+\r
+<P>\r
+First you need to download the latest version of MRTG from <htmlurl url="http://people.ee.ethz.ch/~oetiker/webtools/mrtg/" name="http://people.ee.ethz.ch/~oetiker/webtools/mrtg/">.\r
+You will also need the following files..\r
+\r
+<tscreen><verb>\r
+libpng-1.0.14.tar.gz\r
+zlib-1.1.4.tar.gz\r
+gd-1.8.3.tar.gz\r
+</verb></tscreen>\r
+\r
+Login to your machine as the root user, put all the downloaded files \r
+in /usr/local/src/ (or wherever you prefer) and untar and compile them.  \r
+All the information to compile and install these sources come with them.\r
+After compilation and installation,  you will find MRTG in /usr/local/mrtg-2.\r
+\r
+<P>\r
+Now copy all the files in /usr/local/src/mrtg-2.9.22/images/ to \r
+/spider/html/mrtg/\r
+\r
+<P>\r
+You now need to make 2 symbolic links like below...\r
+\r
+<tscreen><verb>\r
+ln -s /usr/local/mrtg-2/bin/mrtg /usr/bin/mrtg\r
+ln -s /usr/local/mrtg-2/lib/mrtg2 /usr/lib/mrtg2\r
+</verb></tscreen>\r
+\r
+<P>\r
+Now login to the cluster as your sysop user and run the command \r
+"mrtg all".\r
+\r
+<P>Now you are nearly there!  Login as the sysop user and change to the\r
+/spider/html/mrtg/ directory.  Now run the command <em>indexmaker</em> as\r
+shown below...\r
+\r
+<tscreen><verb>\r
+indexmaker --output stats.html --columns=1 --title "MRTG statistics for GB7DJK" ../../mrtg/mrtg.cfg\r
+</verb></tscreen>\r
+\r
+Changing the callsign for your own cluster callsign of course!\r
+\r
+<P>\r
+And finally you need to login as the root user and create one last\r
+symbolic link.  Where this points will depend on where your html\r
+documents are kept.  For RedHat systems you use...\r
+\r
+<tscreen><verb>\r
+ln -s /home/sysop/spider/html/mrtg /home/httpd/html/mrtg\r
+</verb></tscreen>\r
+\r
+and for SuSE systems...\r
+\r
+<tscreen><verb>\r
+ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg\r
+</verb></tscreen>\r
+\r
+If you now point your browser to your website as below it should all\r
+be happening!\r
+\r
+<tscreen><verb>\r
+http://www.xxx.xxx/mrtg/stats.html\r
+</verb></tscreen>\r
+\r
+Of course, to get the stats to update, you need to add some information\r
+in the spider crontab file as below...\r
+\r
+<tscreen><verb>\r
+# Update stats for mrtg on website\r
+00,05,10,15,20,25,30,35,40,45,50,55 * * * * run_cmd('mrtg all')\r
+</verb></tscreen>\r
+\r
+This will update the site every 5 minutes.\r
+\r
 <sect>Security\r
 \r
 <P>\r