added mention of CVSlatest tarball
[spider.git] / html / adminmanual-1.html
index a6f976752d03d33205eb415322861cac1002e523..94118af929cf5aa40d58a372f4b64a8d40a2544c 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation and Administration Manual : Installation (Original version by Iain Phillips, G0RDI)</TITLE>
+ <TITLE>The DXSpider Installation and Administration Manual: Installation (Original version by Iain Philipps, G0RDI)</TITLE>
  <LINK HREF="adminmanual-2.html" REL=next>
 
  <LINK HREF="adminmanual.html#toc1" REL=contents>
 Previous
 <A HREF="adminmanual.html#toc1">Contents</A>
 <HR>
-<H2><A NAME="s1">1. Installation (Original version by Iain Phillips, G0RDI)</A></H2>
+<H2><A NAME="s1">1. Installation (Original version by Iain Philipps, G0RDI)</A></H2>
 
-<P>Last modified: 13 January 2001 by Ian Maude, G0VGS
-<P>
 <H2><A NAME="ss1.1">1.1 Introduction</A>
 </H2>
 
-<P>This section describes the installation of DX Spider v1.35 on a 
-<A HREF="http://www.redhat.com">RedHat</A> Linux Distribution.  
+<P>This section describes the installation of DX Spider v1.46 on a 
+<A HREF="http://www.redhat.com">RedHat</A> Linux Distribution.
+Wherever possible I will try to include differences for other distributions.  
 I do not intend to try and cover the installation of Linux or the setup 
 of the AX25 utilities.  If you need help on this then read Iains original 
-HOWTO on the 
-<A HREF="http://www.dxcluster.org">DXSpider</A> 
-website.
+installation guide that comes with the Spider distribution.
 <P>
 <P>I am assuming a general knowledge of Linux and its commands.  You should 
 know how to use <EM>tar</EM> and how to edit files using your favourite editor.
 <P>
 <P>The crucial ingredient for all of this is 
-<A HREF="http://www.perl.org">Perl 5.004</A>.  Now I know Perl 5.005 
-is out and this will almost certainly work with it, but 
-<A HREF="http://www.redhat.com">RedHat 5.1</A> comes with 5.004. 
-<EM>Be Warned</EM>, earlier versions of 
-<A HREF="http://www.redhat.com">RedHat</A> <B>do not</B> come 
-with 5.004 as standard, you need to 
-<A HREF="ftp://upgrade.redhat.com">upgrade</A><P>
+<A HREF="http://www.perl.org">Perl</A>.  Earlier versions of
+Spider required perl 5.004, however it is now <I>STRONGLY</I> recommended
+that you use at least version 5.005_03 as this is the version being used
+in the development of Spider.
+<P>
 <P>In addition to the standard Red Hat distribution you will require the 
-following 
-<A HREF="http://www.cpan.org/CPAN.html">CPAN</A> modules: -
+following modules from 
+<A HREF="http://www.cpan.org/CPAN.html">http://www.cpan.org/CPAN.html</A> ...
 <P>
 <P>
 <UL>
-<LI>            MD5-1.7.tar.gz</LI>
-<LI>            Data-Dumper-2.10.tar.gz</LI>
-<LI>            FreezeThaw-0.3.tar.gz</LI>
-<LI>            MLDBM-2.00.tar.gz</LI>
-<LI>            TimeDate-1.08.tar.gz</LI>
-<LI>            IO-1.20.tar.gz</LI>
+<LI>            Data-Dumper-2.101.tar.gz</LI>
+<LI>            TimeDate-1.10.tar.gz</LI>
+<LI>            IO-1.20.tar.gz (for perl 5.00403 and lower)</LI>
 <LI>            Net-Telnet-3.02.tar.gz</LI>
 <LI>            Curses-1.05.tar.gz</LI>
 <LI>            Time-HiRes-01.20.tar.gz
@@ -66,7 +58,7 @@ but use the above list as the earliest versions usable.
 
 <P>I will assume that you have already downloaded the latest tarball of 
 the DXSpider software and are ready to install it. I am assuming version 
-1.35 for this section but of course you would use the latest version.
+1.46 for this section but of course you would use the latest version.
 <P>
 <P>Login as root and create a user to run the cluster under.  <B><I>UNDER 
 NO CIRCUMSTANCES USE ROOT AS THIS USER!</I></B>.  I am going to use 
@@ -101,7 +93,7 @@ permissions.  Copy the tarball to /home/sysop and do the following.
 <BLOCKQUOTE><CODE>
 <PRE>
 # cd ~sysop
-# tar xvfz spider-1.35.tar.gz
+# tar xvfz spider-1.46.tar.gz
 # ln -s ~sysop/spider /spider
 # groupadd -g 251 spider       (or another number)
 </PRE>
@@ -174,10 +166,10 @@ for the file to work so leave it in.
 <P>
 <P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
 <P>
-<P>DON'T alter the DXVars.pm (or any other file) in /spider/perl, they are 
-overwritten with every release. Any files or commands you place in /spider/local 
-or /spider/local_cmd will automagically be used in preference to the ones in 
-/spider/perl EVEN while the cluster is running!
+<P>DON'T alter any file in /spider/perl, they are overwritten with every
+release. Any files or commands you place in /spider/local or /spider/local_cmd 
+will automagically be used in preference to the ones in /spider/perl EVEN 
+while the cluster is running!
 <P>
 <P>Save the new file and change directory to ../perl ....
 <P>
@@ -192,7 +184,7 @@ the sysop.
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-$ create_sysop.pl
+$ ./create_sysop.pl
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
@@ -204,8 +196,8 @@ It should look something like this ...
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-$ cluster.pl
-DXSpider DX Cluster Version 1.35
+$ ./cluster.pl
+DXSpider DX Cluster Version 1.46
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
@@ -218,11 +210,11 @@ orft we jolly well go ...
 </CODE></BLOCKQUOTE>
 <P>
 <P>If all is well then login on another term or console as <EM>sysop</EM> and 
-cd to /spider/perl.  Now issue the following command ...
+cd to /spider/src.  Now issue the following command ...
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-$ client.pl
+$ ./client
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
@@ -248,6 +240,18 @@ shutdown
 <P>
 <P>and both the cluster and the client should return to Linux prompts.
 <P>
+<H2><A NAME="ss1.6">1.6 The Client program</A>
+</H2>
+
+<P>In earlier versions of Spider, all the processes were Perl scripts.  This 
+was fine but with a lot of users your computer memory would soon be used up.  
+To combat this a new client was written in "C".  This client only works for
+<EM>incoming</EM> connects at the moment.  Before you can use it though it 
+has to be "made".  CD to /spider/src and type <EM>make</EM>.  You 
+should see the output on your screen and hopefully now have a small C program 
+called <EM>client</EM>.  Leave it in this directory.
+<P>
+<P>
 <HR>
 <A HREF="adminmanual-2.html">Next</A>
 Previous