move usdb init as per k1xx's bug
[spider.git] / html / adminmanual-8.html
index be22c7f6db55bb5060c9e524ed30154bbf7b3d6c..e3c38cd701e342a453d46117a4a63b4348399dd8 100644 (file)
@@ -1,8 +1,8 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
 <HTML>
 <HEAD>
- <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Administration Manual v1.49: CVS</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>
 <A HREF="adminmanual-7.html">Previous</A>
 <A HREF="adminmanual.html#toc8">Contents</A>
 <HR>
-<H2><A NAME="s8">8. CVS</A></H2>
+<H2><A NAME="s8">8.</A> <A HREF="adminmanual.html#toc8">Web based statistics</A></H2>
 
-<P>CVS stands for "Concurrent Versions System" and the CVS for DXSpider is held
-at 
-<A HREF="http://www.sourceforge.net">Sourceforge</A>.  This means
-that it is possible to update your DXSpider installation to the latest
-sources by using a few simple commands.
-<P>
-<P>Please be aware that if you update your system using CVS, it is possible that
-you could be running code that is very beta and not fully tested.  There is
-a possibility that it could be unstable.
-<P>
-<P>I am of course assuming that you have a machine with both DXSpider and
-Internet access running.
-<P>
-<P>BEFORE YOU EVEN CONSIDER STARTING WITH THIS MAKE A BACKUP OF YOUR
-ENTIRE SPIDER TREE!!
-<P>
-<P>Assuming you are connected to the Internet, you need to login to the
-CVS repository and then update your Spider source.  There are several
-steps which are listed below ...
-<P>
-<P>First login as the user <EM>sysop</EM>.  Next you need to connect to the CVS
-repository.  You do this with the command below ...
+<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>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>
-cvs -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login 
+libpng-1.0.14.tar.gz
+zlib-1.1.4.tar.gz
+gd-1.8.3.tar.gz
 </PRE>
-<P>You will get a password prompt.  Simply hit return here and your machine should
-return to a normal linux prompt.
-<P>
-<P>What happens next depends on whether you have an existing installation that 
-you want to update with the latest and greatest or whether you just want
-to see what is there and/or run it on a new machine for testing.
-<P>If you are installing Spider from CVS then change directory to /home/sysop
-<P>If you are wanting to update Spider then cd to /tmp
-<P>
-<P>The next step will create a brand new 'spider' directory in your current
-directory.
+</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>
+
+<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>
-cvs -z3 -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider co spider
+ln -s /usr/local/mrtg-2/bin/mrtg /usr/bin/mrtg
+ln -s /usr/local/mrtg-2/lib/mrtg2 /usr/lib/mrtg2
 </PRE>
-<P>This command is all on one line.
-<P>
-<P>Hopefully your screen should show you downloading files.  The -z3 simply compresses
-the download to improve speed.
-When this has finished, you will have exactly the same as if you had untarred a full 
-tarball PLUS some extra directories and files that CVS needs to do the magic that 
-it does.
-<P>
-<P>Now if you are doing a new installation, that's it.  Carry on as if you have
-just downloaded and untarred the lastest tarball.
-<P>
-<P>If you want to upgrade your current installation then do this ...
+</CODE></BLOCKQUOTE>
+</P>
+
+<P>Now login to the cluster with your sysop callsign and run the command 
+"mrtg all".</P>
+
+<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>
-tar cvfz /tmp/s.tgz spider
-cd /
-tar xvfzp /tmp/s.tgz
+indexmaker --output stats.html --columns=1 --title "MRTG statistics for GB7DJK" ../../mrtg/mrtg.cfg
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>This is assuming you downloaded to the /tmp directory of course.
-<P>
-<P>NOTE:  the 'p' on the end of the 'xvfz' is IMPORTANT!   It keeps the permissions
-correct.  YOU WERE LOGGED IN AS THE USER SYSOP WEREN'T YOU?????
-<P>Remember to recompile the C client (cd /spider/src; make)
-<P>
-<P>At this point the files have been upgraded.  You can (usually) restart the cluster
-in your own time.  However, if you attempt to use any new commands or features
-expect it to be fatal!  At least your cluster will have been restarted then so it
-will be too late to worry about it!
+</P>
+<P>Changing the callsign for your own cluster callsign of course!</P>
+
+<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>
-<P>Now the magic part!  From now on when you want to update, simply connect to the 
-Internet and then, as the user <EM>sysop</EM> ...
+<BLOCKQUOTE><CODE>
+<PRE>
+ln -s /home/sysop/spider/html/mrtg /home/httpd/html/mrtg
+</PRE>
+</CODE></BLOCKQUOTE>
+</P>
+<P>and for SuSE systems...</P>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-cd /spider
-cvs -z3 update -d
+ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>and your files will be updated.  As above, remember to recompile the "C" client 
-if it has been updated (CVS will tell you) and restart if any of the perl scripts
-have been altered or added, again, CVS will tell you.
+</P>
+<P>If you now point your browser to your website as below it should all
+be happening!</P>
 <P>
-<P>You will find any changes documented in the /spider/Changes file.
+<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>