move usdb init as per k1xx's bug
[spider.git] / html / adminmanual-8.html
index 684c8176a56722615f5b656f1f0810e240e551b4..e3c38cd701e342a453d46117a4a63b4348399dd8 100644 (file)
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
 <HTML>
 <HEAD>
- <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation and Administration Manual : Other filters</TITLE>
+ <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.16">
+ <TITLE>The DXSpider Administration Manual v1.50: Web based statistics</TITLE>
  <LINK HREF="adminmanual-9.html" REL=next>
  <LINK HREF="adminmanual-7.html" REL=previous>
  <LINK HREF="adminmanual.html#toc8" REL=contents>
+<link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
 </HEAD>
 <BODY>
 <A HREF="adminmanual-9.html">Next</A>
 <A HREF="adminmanual-7.html">Previous</A>
 <A HREF="adminmanual.html#toc8">Contents</A>
 <HR>
-<H2><A NAME="s8">8. Other filters</A></H2>
+<H2><A NAME="s8">8.</A> <A HREF="adminmanual.html#toc8">Web based statistics</A></H2>
 
-<H2><A NAME="ss8.1">8.1 Filtering Mail</A>
-</H2>
+<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 
+<A HREF="http://www.gb7mbc.net/mrtg/stats.html">http://www.gb7mbc.net/mrtg/stats.html</A>.</P>
 
-<P>In the /spider/msg directory you will find a file called badmsg.pl.issue.  Rename
-this to badmsg.pl and edit the file.  The original looks something like this ....
+<P>The following should help you get it all working.</P>
+
+<P>First you need to download the latest version of MRTG from 
+<A HREF="http://people.ee.ethz.ch/~oetiker/webtools/mrtg/">http://people.ee.ethz.ch/~oetiker/webtools/mrtg/</A>.
+You will also need the following files..</P>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
+libpng-1.0.14.tar.gz
+zlib-1.1.4.tar.gz
+gd-1.8.3.tar.gz
+</PRE>
+</CODE></BLOCKQUOTE>
+</P>
+<P>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>
 
-# the list of regexes for messages that we won't store having
-# received them (bear in mind that we must receive them fully before
-# we can bin them)
-
-
-# The format of each line is as follows
-
-#     type      source             pattern 
-#     P/B/F     T/F/O/S            regex  
-
-# type: P - private, B - bulletin (msg), F - file (ak1a bull)
-# source: T - to field, F - from field,  O - origin, S - subject 
-# pattern: a perl regex on the field requested
-
-# Currently only type B and P msgs are affected by this code.
-# 
-# The list is read from the top down, the first pattern that matches
-# causes the action to be taken.
-
-# The pattern can be undef or 0 in which case it will always be selected
-# for the action specified
-
+<P>Now copy all the files in /usr/local/src/mrtg-2.9.22/images/ to 
+/spider/html/mrtg/</P>
 
+<P>You now need to make 2 symbolic links like below...</P>
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+ln -s /usr/local/mrtg-2/bin/mrtg /usr/bin/mrtg
+ln -s /usr/local/mrtg-2/lib/mrtg2 /usr/lib/mrtg2
+</PRE>
+</CODE></BLOCKQUOTE>
+</P>
 
-package DXMsg;
+<P>Now login to the cluster with your sysop callsign and run the command 
+"mrtg all".</P>
 
-@badmsg = (
-'B',    'T',    'SALE', 
-'B',    'T',    'WANTED',
-'B',    'S',    'WANTED',
-'B',    'S',    'SALE', 
-'B',    'S',    'WTB',
-'B',    'S',    'WTS',
-'B',    'T',    'FS',
-);
+<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...</P>
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+indexmaker --output stats.html --columns=1 --title "MRTG statistics for GB7DJK" ../../mrtg/mrtg.cfg
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>
-<P>I think this is fairly self explanatory.  It is simply a list of subject 
-headers that we do not want to pass on to either the users of the cluster or 
-the other cluster nodes that we are linked to.  This is usually because of 
-rules and regulations pertaining to items for sale etc in a particular country.
-<P>
-<H2><A NAME="ss8.2">8.2 Filtering DX callouts</A>
-</H2>
+</P>
+<P>Changing the callsign for your own cluster callsign of course!</P>
 
-<P>In the same way as mail, there are some types of spot we do not wish to pass on 
-to users or linked cluster nodes.  In the /spider/data directory you will find 
-a file called baddx.pl.issue.  Rename this to baddx.pl and edit the file.  The
-original looks like this ....
+<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...</P>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-
-# the list of dx spot addresses that we don't store and don't pass on
-
-
-package DXProt;
-
-@baddx = qw 
-
- FROG 
- SALE
- FORSALE
- WANTED
- P1RATE
- PIRATE
- TEST
- DXTEST
- NIL
- NOCALL 
-);
+ln -s /home/sysop/spider/html/mrtg /home/httpd/html/mrtg
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>
-<P>Again, this is simply a list of names we do not want to see in the spotted 
-field of a DX callout.
-<P>
-<P>
-<H2><A NAME="ss8.3">8.3 Filtering words from text fields in Announce, Talk and DX spots</A>
-</H2>
-
-<P>Create a file in /spider/data called <EM>badwords</EM>.  The format is quite
-simple.  Lines beginning with # are ignored so comments can be added.  An
-example file is below ...
+</P>
+<P>and for SuSE systems...</P>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-# Below is a list of words we do not wish to see on the cluster
-grunge grunged grunging
-splodge splodger splodging
-grince
-fluffle
+ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>Multiple words can be used on the same line as shown.  Obviously these
-are just examples :-)
+</P>
+<P>If you now point your browser to your website as below it should all
+be happening!</P>
 <P>
-<P>You can reload the file from the cluster prompt as sysop with load/badwords.
+<BLOCKQUOTE><CODE>
+<PRE>
+http://www.xxx.xxx/mrtg/stats.html
+</PRE>
+</CODE></BLOCKQUOTE>
+</P>
+<P>Of course, to get the stats to update, you need to add some information
+in the spider crontab file as below...</P>
 <P>
+<BLOCKQUOTE><CODE>
+<PRE>
+# Update stats for mrtg on website
+00,05,10,15,20,25,30,35,40,45,50,55 * * * * run_cmd('mrtg all')
+</PRE>
+</CODE></BLOCKQUOTE>
+</P>
+<P>This will update the site every 5 minutes.</P>
+
 <HR>
 <A HREF="adminmanual-9.html">Next</A>
 <A HREF="adminmanual-7.html">Previous</A>