X-Git-Url: http://scm.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;ds=inline;f=html%2Fadminmanual-8.html;h=e3c38cd701e342a453d46117a4a63b4348399dd8;hb=1980462a73fe3a14acc44c9a75982d8b15e9390c;hp=be22c7f6db55bb5060c9e524ed30154bbf7b3d6c;hpb=f0b59af5985f155c108932be14840726be7cd1f5;p=spider.git diff --git a/html/adminmanual-8.html b/html/adminmanual-8.html index be22c7f6..e3c38cd7 100644 --- a/html/adminmanual-8.html +++ b/html/adminmanual-8.html @@ -1,8 +1,8 @@
- -CVS stands for "Concurrent Versions System" and the CVS for DXSpider is held -at -Sourceforge. This means -that it is possible to update your DXSpider installation to the latest -sources by using a few simple commands. -
-
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. -
-
I am of course assuming that you have a machine with both DXSpider and -Internet access running. -
-
BEFORE YOU EVEN CONSIDER STARTING WITH THIS MAKE A BACKUP OF YOUR -ENTIRE SPIDER TREE!! -
-
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 ... -
-
First login as the user sysop. Next you need to connect to the CVS -repository. You do this with the command below ... +
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 +http://www.gb7mbc.net/mrtg/stats.html.
+ +The following should help you get it all working.
+ +First you need to download the latest version of MRTG from +http://people.ee.ethz.ch/~oetiker/webtools/mrtg/. +You will also need the following files..
+
-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
-You will get a password prompt. Simply hit return here and your machine should
-return to a normal linux prompt.
-
-
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.
-
If you are installing Spider from CVS then change directory to /home/sysop
-
If you are wanting to update Spider then cd to /tmp
-
-
The next step will create a brand new 'spider' directory in your current
-directory.
+
+
+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.
+ +Now copy all the files in /usr/local/src/mrtg-2.9.22/images/ to +/spider/html/mrtg/
+ +You now need to make 2 symbolic links like below...
+
-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
-This command is all on one line.
-
-
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.
-
-
Now if you are doing a new installation, that's it. Carry on as if you have
-just downloaded and untarred the lastest tarball.
-
-
If you want to upgrade your current installation then do this ...
+
+
+
+Now login to the cluster with your sysop callsign and run the command +"mrtg all".
+ +Now you are nearly there! Login as the sysop user and change to the +/spider/html/mrtg/ directory. Now run the command indexmaker as +shown below...
-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
-This is assuming you downloaded to the /tmp directory of course. -
-
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????? -
Remember to recompile the C client (cd /spider/src; make) -
-
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! +
+Changing the callsign for your own cluster callsign of course!
+ +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...
-
Now the magic part! From now on when you want to update, simply connect to the -Internet and then, as the user sysop ... +
+
+ln -s /home/sysop/spider/html/mrtg /home/httpd/html/mrtg
+
+
+
+and for SuSE systems...
-cd /spider
-cvs -z3 update -d
+ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg
-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. +
+If you now point your browser to your website as below it should all +be happening!
-
You will find any changes documented in the /spider/Changes file. +
+
+http://www.xxx.xxx/mrtg/stats.html
+
+
+
+Of course, to get the stats to update, you need to add some information +in the spider crontab file as below...
+
+
+# Update stats for mrtg on website
+00,05,10,15,20,25,30,35,40,45,50,55 * * * * run_cmd('mrtg all')
+
+
+
+This will update the site every 5 minutes.
+