X-Git-Url: http://dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=sgml%2Fadminmanual.sgml;h=9222966b76a6c2e7a168001e9e62b2fc7ef13205;hb=a52a4d8c59a80d66796429ef2787491581f76326;hp=4a9638f9af5a81fb5c19be0312e1978ccdf635be;hpb=551887c98fa231f03aa2a1829e7ef00ca3e097b9;p=spider.git

diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml
index 4a9638f9..9222966b 100644
--- a/sgml/adminmanual.sgml
+++ b/sgml/adminmanual.sgml
@@ -7,7 +7,7 @@
 <title>The DXSpider Administration Manual v1.50</title> 
 <author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net), and
 Charlie Carroll, K1XX, (k1xx@ptcnh.net)</author>
-<date>July 2002 revision 0.1</date>
+<date>February 2003 revision 0.3</date>
 
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
@@ -483,7 +483,7 @@ $def_hopcount = 5;
 
 
 %nodehops = 
-
+(
  GB7ADX => {            11 => 8,
                         12 => 8,
                         16 => 8,
@@ -507,7 +507,7 @@ $def_hopcount = 5;
                         19 => 8,
                         21 => 8,
                    },
-};
+);
 </verb></tscreen>
 
 <P>
@@ -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
 </verb>
 
+<sect>Web based statistics
+
+<P>
+From version 1.50, you can use the freeware software MRTG to produce
+really nice graphical statistics on your web site.  For an example
+try <htmlurl url="http://www.gb7mbc.net/mrtg/stats.html" name="http://www.gb7mbc.net/mrtg/stats.html">.
+
+<P>
+The following should help you get it all working.
+
+<P>
+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/">.
+You will also need the following files..
+
+<tscreen><verb>
+libpng-1.0.14.tar.gz
+zlib-1.1.4.tar.gz
+gd-1.8.3.tar.gz
+</verb></tscreen>
+
+Login to your machine as the root user, put all the downloaded files 
+in /usr/local/src/ (or wherever you prefer) and untar and compile them.  
+All the information to compile and install these sources come with them.
+After compilation and installation,  you will find MRTG in /usr/local/mrtg-2.
+
+<P>
+Now copy all the files in /usr/local/src/mrtg-2.9.22/images/ to 
+/spider/html/mrtg/
+
+<P>
+You now need to make 2 symbolic links like below...
+
+<tscreen><verb>
+ln -s /usr/local/mrtg-2/bin/mrtg /usr/bin/mrtg
+ln -s /usr/local/mrtg-2/lib/mrtg2 /usr/lib/mrtg2
+</verb></tscreen>
+
+<P>
+Now login to the cluster with your sysop callsign and run the command 
+"mrtg all".
+
+<P>Now you are nearly there!  Login as the sysop user and change to the
+/spider/html/mrtg/ directory.  Now run the command <em>indexmaker</em> as
+shown below...
+
+<tscreen><verb>
+indexmaker --output stats.html --columns=1 --title "MRTG statistics for GB7DJK" ../../mrtg/mrtg.cfg
+</verb></tscreen>
+
+Changing the callsign for your own cluster callsign of course!
+
+<P>
+And finally you need to login as the root user and create one last
+symbolic link.  Where this points will depend on where your html
+documents are kept.  For RedHat systems you use...
+
+<tscreen><verb>
+ln -s /home/sysop/spider/html/mrtg /home/httpd/html/mrtg
+</verb></tscreen>
+
+and for SuSE systems...
+
+<tscreen><verb>
+ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg
+</verb></tscreen>
+
+If you now point your browser to your website as below it should all
+be happening!
+
+<tscreen><verb>
+http://www.xxx.xxx/mrtg/stats.html
+</verb></tscreen>
+
+Of course, to get the stats to update, you need to add some information
+in the spider crontab file as below...
+
+<tscreen><verb>
+# Update stats for mrtg on website
+00,05,10,15,20,25,30,35,40,45,50,55 * * * * run_cmd('mrtg all')
+</verb></tscreen>
+
+This will update the site every 5 minutes.
+
 <sect>Security
 
 <P>
@@ -2160,7 +2243,7 @@ Order is not important.
 
 <P>
 <tt>
-<bf>clear/announce &lsqb;input&rsqb; &lt;callsign&gt; &lsqb;0-9&verbar;all&rsqb;</bf> Clear an announce filter line
+<bf>clear/announce &lt;callsign&gt; &lsqb;input&rsqb; &lsqb;0-9&verbar;all&rsqb;</bf> Clear an announce filter line
 </tt>
 
 <P>
@@ -2171,7 +2254,7 @@ node_default or user_default.
 
 <P>
 <tt>
-<bf>clear/route &lsqb;input&rsqb; ^lt;callsign&gt; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a route filter line
+<bf>clear/route &lt;callsign&gt; &lsqb;input&rsqb; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a route filter line
 </tt>
 
 <P>
@@ -2225,7 +2308,7 @@ the filter will be completely removed.
 
 <P>
 <tt>
-<bf>clear/spots &lsqb;input&rsqb; &lt;callsign&gt; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a spot filter line
+<bf>clear/spots &lt;callsign&gt; &lsqb;input&rsqb; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a spot filter line
 </tt>
 
 <P>
@@ -2249,7 +2332,7 @@ see CLEAR/SPOTS for a more detailed explanation.
 
 <P>
 <tt>
-<bf>clear/wcy &lsqb;input&rsqb; &lt;callsign&gt; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a WCY filter line
+<bf>clear/wcy &lt;callsign&gt; &lsqb;input&rsqb; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a WCY filter line
 </tt>
 
 <P>
@@ -2273,7 +2356,7 @@ see CLEAR/SPOTS for a more detailed explanation.
 
 <P>
 <tt>
-<bf>clear/wwv &lsqb;input&rsqb; &lt;callsign&gt; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a WWV filter line
+<bf>clear/wwv &lt;callsign&gt; &lsqb;input&rsqb; &lsqb;0-9&verbar;all&rsqb;</bf> Clear a WWV filter line
 </tt>
 
 <P>