make additions and changes to manuals
[spider.git] / html / installation-1.html
index a781b1e24f053f44bef34daea13737ed041e59e2..6e9dfa39faa35637cedb8ff74934b070e607e08b 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.49: Linux Installation </TITLE>
+ <TITLE>The DXSpider Installation Manual v1.50: Linux Installation </TITLE>
  <LINK HREF="installation-2.html" REL=next>
 
  <LINK HREF="installation.html#toc1" REL=contents>
@@ -18,12 +18,9 @@ Previous
 <H2><A NAME="ss1.1">1.1 Introduction</A>
 </H2>
 
-<P>This section describes the installation of DX Spider v1.47 on a 
+<P>This section describes the installation of DX Spider v1.50 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 
-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.
@@ -36,7 +33,10 @@ in the development of Spider.
 <P>
 <P>In addition to the standard Red Hat distribution you will require the 
 following modules from 
-<A HREF="http://www.cpan.org/CPAN.html">http://www.cpan.org/CPAN.html</A> ...
+<A HREF="http://www.cpan.org/CPAN.html">http://www.cpan.org/CPAN.html</A> , please note however that with later versions of perl, some of these
+modules may be included with the distribution.  Get the modules anyway and try
+to install as below.  If they complain, they are probably already a part of your
+perl distribution.
 <P>
 <P>
 <UL>
@@ -52,9 +52,13 @@ following modules from
 <A HREF="http://www.cpan.org/modules/by-module/Curses/Curses-1.06.tar.gz">Curses-1.06.tar.gz</A></LI>
 <LI> 
 <A HREF="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz">Time-HiRes-01.20.tar.gz</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Digest/Digest-SHA1-2.01.tar.gz">Digest-SHA1-2.01.tar.gz</A></LI>
 </UL>
 <P>
-<P>Copy the CPAN modules listed above to a convenient place on your computer. One good place would be /usr/local/packages, and the instructions which follow will assume that that's where you have put them.
+<P>Copy the CPAN modules listed above to a convenient place on your computer. One good 
+place would be /usr/local/packages, and the instructions which follow will assume that 
+that's where you have put them.
 <P>
 <P>Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
 <P>
@@ -100,9 +104,17 @@ following modules from
 # make test
 # make install
 # cd ..
+#
+# tar xvfz /usr/local/packages/Digest-SHA1-2.01.tar.gz
+# cd Digest-SHA1-2.01
+# perl Makefile.pl
+# make test
+# make install
+# cd ..
 </PRE>
 <P>
-<P>Do not fall into the trap of thinking they're all the same, just because they nearly are! Pay particular attention to the instructions of IO, above.
+<P>Do not fall into the trap of thinking they're all the same, just because they 
+nearly are! Pay particular attention to the instructions of <EM>IO</EM>, above.
 <P>
 <P>
 <H2><A NAME="ss1.2">1.2 Preparation</A>
@@ -110,7 +122,7 @@ following modules from
 
 <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.47 for this section but of course you would use the latest version.
+1.50 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 
@@ -152,11 +164,12 @@ permissions.  Copy the tarball to /home/sysop and do the following.
 <BLOCKQUOTE><CODE>
 <PRE>
 # cd ~sysop
-# tar xvfz spider-1.47.tar.gz
+# tar xvfz spider-1.50.tar.gz
 # ln -s ~sysop/spider /spider
 # groupadd -g 251 spider       (or another number)
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>
 <P>If you do not have the command <EM>groupadd</EM> available to you simply 
 add a line in /etc/group by hand.
 <P>
@@ -165,6 +178,7 @@ add a line in /etc/group by hand.
 # vi /etc/group                (or your favorite editor)
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>
 <P>You also need to add some others to the group, including your own callsign 
 (this will be used as an alias) and root.  The finished line in /etc/group 
 should look something like this
@@ -213,18 +227,36 @@ $ vi DXVars.pm (or your favourite editor)
 </CODE></BLOCKQUOTE>
 <P>
 <P>Using the distributed DXVars.pm as a a template, set your cluster callsign, 
-sysop callsign and other user info to suit your own environment. Note that 
-this a perl file which will be parsed and executed as part of the cluster. If 
-you get it wrong then perl will complain when you start the cluster process.  
-It is important only to alter the text of any section.  Some of the lines look 
-a little odd.  Take this line for example ....
+sysop callsign and other user info to suit your own environment. 
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+$mycall = "GB7DJK";     
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
+<P>This is the call sign of your cluster.  If you use an SSID then include it here
+also.
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+$myalias = "G1TLH";
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
+<P>This is the sysop user callsign, normally your own.
+<P>
+<P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
+<P>
+<P>Note that this a perl file which will be parsed and executed as part of the 
+cluster. If you get it wrong then perl will complain when you start the cluster 
+process.  It is important only to alter the text of any section.  Some of the 
+lines look a little odd.  Take this line for example ....
 <P><CODE>$myemail = "ianmaude\@btinternet.com";</CODE>
 <P>
 <P>There appears to be an extra slash in there.  However this has to be there 
 for the file to work so leave it in.
 <P>
-<P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
-<P>
 <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 
@@ -268,7 +300,7 @@ It should look something like this ...
 <BLOCKQUOTE><CODE>
 <PRE>
 $ ./cluster.pl
-DXSpider DX Cluster Version 1.47
+DXSpider DX Cluster Version 1.50
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
@@ -299,6 +331,7 @@ was set as GB7MBC.  You should therefore see this when you login ....
 G0VGS de GB7MBC 19-Nov-1999 2150Z >
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>
 <P>If you do, congratulations!  If not, look over the instructions again, you 
 have probably missed something out.  You can shut spider down again with the 
 command ....