html/adminmanual-12.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <HTML>
   3 <HEAD>
   4  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
   5  <TITLE>The DXSpider Installation and Administration Manual : CVS</TITLE>
   6  <LINK HREF="adminmanual-13.html" REL=next>
   7  <LINK HREF="adminmanual-11.html" REL=previous>
   8  <LINK HREF="adminmanual.html#toc12" REL=contents>
   9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
  10 </HEAD>
  11 <BODY>
  12 <A HREF="adminmanual-13.html">Next</A>
  13 <A HREF="adminmanual-11.html">Previous</A>
  14 <A HREF="adminmanual.html#toc12">Contents</A>
  15 <HR>
  16 <H2><A NAME="s12">12. CVS</A></H2>
  17
  18 <P>CVS stands for "Concurrent Versions System" and the CVS for DXSpider is held
  19 at
  20 <A HREF="http://www.sourceforge.net">Sourceforge</A>.  This means
  21 that it is possible to update your DXSpider installation to the latest
  22 sources by using a few simple commands.
  23 <P>
  24 <P>THIS IS NOT FOR THE FAINT HEARTED!!!  ONLY DO THIS IF YOU HAVE A TEST
  25 INSTALLATION OR ARE WILLING TO HAVE YOUR CLUSTER CRASH ON YOU!!!
  26 THIS MUST BE CONSIDERED AT LEAST BETA TESTING AND MAYBE EVEN ALPHA!!
  27 YOU HAVE BEEN WARNED!!!
  28 <P>
  29 <P>DID I MENTION..... ONLY DO THIS IF YOU ARE WILLING TO ACCEPT THE
  30 CONSEQUENCES!!!
  31 <P>
  32 <P>I am of course assuming that you have a machine with both DXSpider and
  33 Internet access running.
  34 <P>
  35 <P>BEFORE YOU EVEN CONSIDER STARTING WITH THIS MAKE A BACKUP OF YOUR
  36 ENTIRE SPIDER TREE!!
  37 <P>
  38 <P>Assuming you are connected to the Internet, you need to login to the
  39 CVS repository and then update your Spider source.  There are several
  40 steps which are listed below ...
  41 <P>
  42 <P>First login as the user <EM>sysop</EM>.  Next you need to connect to the CVS
  43 repository.  You do this with the command below ...
  44 <P>
  45 <PRE>
  46 cvs -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
  47 </PRE>
  48 <P>You will get a password prompt.  Simply hit return here and your machine should
  49 return to a normal linux prompt.
  50 <P>
  51 <P>What happens next depends on whether you have an existing installation that
  52 you want to update with the latest and greatest or whether you just want
  53 to see what is there and/or run it on a new machine for testing.
  54 Either way you will want to change directory to a new place, if you want to
  55 update an existing installation then I suggest /tmp, otherwise choose a
  56 suitable place according to the normal installation instructions.
  57 <P>
  58 <P>The next step will create a brand new 'spider' directory in your current
  59 directory.
  60 <P>
  61 <PRE>
  62 cvs -z3 -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider co spider
  63 </PRE>
  64 <P>This command is all on one line.
  65 <P>
  66 <P>Hopefully your screen should show you downloading files.  The -z3 simply compresses
  67 the download to improve speed.
  68 When this has finished, you will have exactly the same as if you had untarred a full
  69 tarball PLUS some extra directories and files that CVS needs to do the magic that
  70 it does.
  71 <P>
  72 <P>Now if you are doing a new installation, that's it.  Carry on as if you have
  73 just downloaded and untarred the lastest tarball.
  74 <P>
  75 <P>If you want to upgrade your current installation then do this ...
  76 <P>
  77 <BLOCKQUOTE><CODE>
  78 <PRE>
  79 tar cvfz /tmp/s.tgz spider
  80 cd /
  81 tar xvfzp /tmp/s.tgz
  82 </PRE>
  83 </CODE></BLOCKQUOTE>
  84 <P>This is assuming you downloaded to the /tmp directory of course.
  85 <P>
  86 <P>NOTE:  the 'p' on the end of the 'xvfz' is IMPORTANT!   It keeps the permissions
  87 correct.  YOU WERE LOGGED IN AS THE USER SYSOP WEREN'T YOU?????
  88 <P>Remember to recompile the C client (cd /spider/src; make)
  89 <P>
  90 <P>At this point the files have been upgraded.  You can (usually) restrt the cluster
  91 in your own time.  However, if you attempt to use any new commands or features
  92 expect it to be fatal!  At least your cluster will have been restarted then so it
  93 will be too late to worry about it!
  94 <P>
  95 <P>Now the magic part!  From now on when you want to update, simply connect to the
  96 Internet and then, as the user <EM>sysop</EM> ...
  97 <P>
  98 <BLOCKQUOTE><CODE>
  99 <PRE>
 100 cd /spider
 101 cvs -z3 update -d
 102 </PRE>
 103 </CODE></BLOCKQUOTE>
 104 <P>and your files will be updated.  As above, remember to recompile the "C" client
 105 if it has been updated (CVS will tell you) and restart if any of the perl scripts
 106 have been altered or added, again, CVS will tell you.
 107 <P>
 108 <P>You will find any changes documented in the /spider/Changes file.
 109 <P>
 110 <HR>
 111 <A HREF="adminmanual-13.html">Next</A>
 112 <A HREF="adminmanual-11.html">Previous</A>
 113 <A HREF="adminmanual.html#toc12">Contents</A>
 114 </BODY>
 115 </HTML>