X-Git-Url: http://dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Fadminmanual-8.html;h=2968375a06b40b111ac5f0810e193edcc2538dca;hb=b34f092aea53555f7dcea38612def9692f8dba1d;hp=be22c7f6db55bb5060c9e524ed30154bbf7b3d6c;hpb=f0b59af5985f155c108932be14840726be7cd1f5;p=spider.git diff --git a/html/adminmanual-8.html b/html/adminmanual-8.html index be22c7f6..2968375a 100644 --- a/html/adminmanual-8.html +++ b/html/adminmanual-8.html @@ -1,8 +1,8 @@ - - The DXSpider Administration Manual v1.49: CVS + + The DXSpider Administration Manual v1.50: Web based statistics @@ -13,95 +13,99 @@ Previous Contents
-

8. CVS

+

8. Web based statistics

-

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 as your sysop user 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.

+
Next Previous