mirror of
git://scm.dxcluster.org/scm/spider
synced 2024-09-21 07:47:10 +00:00
209 lines
8.7 KiB
HTML
209 lines
8.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
|
|
<TITLE>The DXSpider Administration Manual v1.50: CVS</TITLE>
|
|
<LINK HREF="adminmanual_en-11.html" REL=next>
|
|
<LINK HREF="adminmanual_en-9.html" REL=previous>
|
|
<LINK HREF="adminmanual_en.html#toc10" REL=contents>
|
|
<link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
|
|
</HEAD>
|
|
<BODY>
|
|
<A HREF="adminmanual_en-11.html">Next</A>
|
|
<A HREF="adminmanual_en-9.html">Previous</A>
|
|
<A HREF="adminmanual_en.html#toc10">Contents</A>
|
|
<HR>
|
|
<H2><A NAME="s10">10.</A> <A HREF="adminmanual_en.html#toc10">CVS</A></H2>
|
|
|
|
<H2><A NAME="ss10.1">10.1</A> <A HREF="adminmanual_en.html#toc10.1">CVS from a Linux platform</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. A graphical interface to CVS for
|
|
Windows is explained in the next section.</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>
|
|
<P>
|
|
<PRE>
|
|
cvs -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
|
|
</PRE>
|
|
</P>
|
|
<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>
|
|
<P>If you are installing Spider from CVS then change directory to /home/sysop</P>
|
|
<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.</P>
|
|
<P>
|
|
<PRE>
|
|
cvs -z3 -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider co spider
|
|
</PRE>
|
|
</P>
|
|
<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 ...</P>
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
tar cvfz /tmp/s.tgz spider
|
|
cd /
|
|
tar xvfzp /tmp/s.tgz
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
</P>
|
|
<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>
|
|
<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>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> ...</P>
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
cd /spider
|
|
cvs -z3 update -d
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
</P>
|
|
<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>You will find any changes documented in the /spider/Changes file.</P>
|
|
|
|
<H2><A NAME="ss10.2">10.2</A> <A HREF="adminmanual_en.html#toc10.2">CVS from a Windows platform</A>
|
|
</H2>
|
|
|
|
<P>After the initial setup, an update to your DXSpider software is no more than a couple
|
|
of clicks away. This section is intended to explain and illustrate the use of the
|
|
WinCVS application to update your DXSpider software. The current stable version of
|
|
WinCVS is Ver. 1.2. You can get this software at:</P>
|
|
<P>
|
|
<A HREF="http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip">http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip</A></P>
|
|
<P>Pick your download mirror and then install WinCVS after the download is complete.</P>
|
|
<P>In this next section I have included a series of links to .jpg files to take advantage of the
|
|
picture and 1000 words equivalency. The .jpg files are in the C:\spider\html directory. If
|
|
someone using a Linux system is reading this section from boredom, the files are in
|
|
/home/sysop/spider/html. One aside, a Linux user can also get a copy of gcvs and do your updates
|
|
graphically as opposed to from the command line. The following descriptions are almost identical
|
|
between WinCvs and gcvs. The following screen shots have duplicate links, depending upon whether
|
|
you are viewing this information under the Windows or Linux operating system.</P>
|
|
<P>When WinCVS is installed, running, and you are connected to the internet, the initial screen looks like:</P>
|
|
<P>
|
|
<A HREF="initial.jpg">initial.jpg</A></P>
|
|
<P>If you want, you can also look at these .jpg files with another viewer that might provide some
|
|
better clarity to the image. On the left is the directory tree for your hard disk. Notice that
|
|
the spider directory has a gray highlight.</P>
|
|
<P>To start configuring WinCVS, click on Admin at the top of the screen and then Preferences. This
|
|
should get you:</P>
|
|
<P>
|
|
<A HREF="pref-gen.jpg">pref-gen.jpg</A></P>
|
|
<P>In the top line for CVSROOT, enter:
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
</P>
|
|
<P>and select
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
"passwd" file on the cvs server
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
</P>
|
|
<P>for Authentication on the General tab.</P>
|
|
<P>Next, move to the right to the Ports tab.</P>
|
|
<P>
|
|
<A HREF="pref-ports.jpg">pref-ports.jpg</A></P>
|
|
<P>In here, check the box on the second line down for the "pserver" port. Enter a port number of 2401.</P>
|
|
<P>Finally, go to the WinCvs tab all the way to the right.</P>
|
|
<P>
|
|
<A HREF="pref-wincvs.jpg">pref-wincvs.jpg</A></P>
|
|
<P>Enter Notepad as the viewer to open files. For the HOME folder, put "C:\spider" and click OK
|
|
because the configuration is now complete.</P>
|
|
<P>You are now ready to upgrade your copy of DXSpider. Click on the greyed Spider folder
|
|
shown in the directory tree on the left of the WinCVS display. Two things should happen. The Spider
|
|
folder will be selected and the greyed-out arrow located just below the word Query in the top line will
|
|
turn to solid green.</P>
|
|
<P>For anyone using gcvs under Linux, the green arrow is located on the extreme left of the display,
|
|
under the word File. A gcvs screen looks like:</P>
|
|
<P>
|
|
<A HREF="gcvs.jpg">gcvs.jpg</A></P>
|
|
<P>Click on the now green arrow to start the download process. An Update Settings box will be displayed
|
|
to which you can simply say OK.</P>
|
|
<P>
|
|
<A HREF="update-OK.jpg">update-OK.jpg</A></P>
|
|
<P>For future reference, the Update Settings box is the place where you can enter information to revert
|
|
to a prior version of DXSpider. Information on reverting to a Before Date is contained in the WinCVS
|
|
manual.</P>
|
|
<P>After a short period of time, a series of file names will scroll by in the lower pane of the WinCVS
|
|
window. Eventually you should see
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
*****CVS exited normally with code 0*****
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
|
|
appear in the lower pane. You're done. The updated files are in place ready for you to stop and then
|
|
restart your DXSpider. After the restart, you're running with the latest version of DXSpider.</P>
|
|
<P>
|
|
<A HREF="completed.jpg">completed.jpg</A></P>
|
|
<P>To paraphrase from the CVS section... Now the magic part! From now on when you want to update, simply
|
|
connect to the Internet and start WinCVS.
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
Click on the greyed-out Spider directory in the left screen
|
|
Click on the green down arrow
|
|
Click OK on the Update Settings dialog box
|
|
Restart your Spider software
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
</P>
|
|
|
|
<HR>
|
|
<A HREF="adminmanual_en-11.html">Next</A>
|
|
<A HREF="adminmanual_en-9.html">Previous</A>
|
|
<A HREF="adminmanual_en.html#toc10">Contents</A>
|
|
</BODY>
|
|
</HTML>
|