Add install procedure for MRTG to Admin manual (g0vgs)
[spider.git] / html / adminmanual-8.html
index 89d93378b393bcd510251457f15f6ffde35e65d2..2968375a06b40b111ac5f0810e193edcc2538dca 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.50: Security</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. Security</A></H2>
+<H2><A NAME="s8">8.</A> <A HREF="adminmanual.html#toc8">Web based statistics</A></H2>
 
-<P>From version 1.49 DXSpider has some additional security features.  These
-are not by any means meant to be exhaustive, however they do afford some
-security against piracy.  These two new features can be used independently 
-of each other or in concert to tighten the security.
-<P>
-<H2><A NAME="ss8.1">8.1 Registration</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>The following should help you get it all working.</P>
 
-<P>The basic principle of registration is simple.  If a user is not registered
-by the sysop, then they have read-only access to the cluster.  The only
-thing they can actually send is a talk or a message to the sysop.  In
-order for them to be able to spot, send announces or talks etc the sysop
-must register them with the <EM>set/register</EM> command, like this ...
+<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>
-set/register g0vgs
+libpng-1.0.14.tar.gz
+zlib-1.1.4.tar.gz
+gd-1.8.3.tar.gz
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>The user g0vgs can now fully use the cluster.  In order to enable 
-registration, you can issue the command ...
+</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>
-set/var $main::reqreg = 1
+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>Any users that are not registered will now see the motd_nor file rather
-than the motd file as discussed in the Information, files and useful 
-programs section.
-<P>
-<P>Entering this line at the prompt will only last for the time the cluster
-is running of course and would not be present on a restart.  To make the
-change permanent, add the above line to /spider/scripts/startup.  To
-read more on the startup file, see the section on Information, files 
-and useful programs.
-<P>
-<P>To unregister a user use <EM>unset/register</EM> and to show the list
-of registered users, use the command <EM>show/register</EM>.
-<P>
-<H2><A NAME="ss8.2">8.2 Passwords</A>
-</H2>
+</P>
+
+<P>Now login to the cluster as your sysop user and run the command 
+"mrtg all".</P>
 
-<P>At the moment, passwords only affect users who login to a DXSpider
-cluster node via telnet.  If a user requires a password, they can
-either set it themselves or have the sysop enter it for them by using
-the <EM>set/password</EM> command.  Any users who already have passwords, 
-such as remote sysops, will be asked for their passwords automatically 
-by the cluster.  Using passwords in this way means that the user has a
-choice on whether to have a password or not.  To force the use of
-passwords at login, issue the command ...
+<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>
-set/var $main::passwdreq = 1
+indexmaker --output stats.html --columns=1 --title "MRTG statistics for GB7DJK" ../../mrtg/mrtg.cfg
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>at the cluster prompt.  This can also be added to the /spider/scripts/startup
-file as above to make the change permanent.
+</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>Of course, if you do this you will have to assign a password for each of 
-your users.  If you were asking them to register, it is anticipated that
-you would ask them to send you a message both to ask to be registered and
-to give you the password they wish to use.
+<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>
-<P>Should a user forget their password, it can be reset by the sysop by
-first removing the existing password and then setting a new one like so ...
+<BLOCKQUOTE><CODE>
+<PRE>
+ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg
+</PRE>
+</CODE></BLOCKQUOTE>
+</P>
+<P>If you now point your browser to your website as below it should all
+be happening!</P>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-unset/password g0vgs
-set/password g0vgs new_password
+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>