add some SuSE specific info to the Installation manual

[spider.git] / sgml / installation.sgml

diff --git a/sgml/installation.sgml b/sgml/installation.sgml
index 086cdb3883431bfcad47e26127bfa96b14ce7c0e..845f8951e8887318b1e7ce57d0744a26ff772aec 100644 (file)
--- a/sgml/installation.sgml
+++ b/sgml/installation.sgml
@@ -4,10 +4,10 @@
 
 <!-- Title information -->
 
-<title>The DXSpider Installation Manual v1.49</title> 
+<title>The DXSpider Installation Manual v1.50</title> 
 <author>Iain Philipps, G0RDI (g0rdi@77hz.com) and
 Ian Maude, G0VGS, (g0vgs@gb7mbc.net)</author>
-<date>February 2002 revision 1.2</date>
+<date>July 2002 revision 0.3</date>
 
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
@@ -23,12 +23,9 @@ A reference for SysOps of the DXSpider DXCluster program.
 <sect1>Introduction
 
 <P>
-This section describes the installation of DX Spider v1.47 on a 
+This section describes the installation of DX Spider v1.50 on a 
 <htmlurl url="http://www.redhat.com" name="RedHat"> 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>
 I am assuming a general knowledge of Linux and its commands.  You should 
@@ -43,7 +40,7 @@ in the development of Spider.
 
 <P>
 In addition to the standard Red Hat distribution you will require the 
-following modules from <htmlurl url="http://www.cpan.org/CPAN.html" name="http://www.cpan.org/CPAN.html"> , please note however that with later versions of perl, some of these
+following modules from <htmlurl url="http://www.cpan.org/modules/by-module/" name="http://www.cpan.org/modules/bymodule/"> , 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.
@@ -56,6 +53,7 @@ perl distribution.
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Net/Net-Telnet-3.02.tar.gz" name="Net-Telnet-3.02.tar.gz">
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Curses/Curses-1.06.tar.gz" name="Curses-1.06.tar.gz">
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz" name="Time-HiRes-01.20.tar.gz">
+<item> <htmlurl url="http://www.cpan.org/modules/by-module/Digest/Digest-SHA1-2.01.tar.gz" name="Digest-SHA1-2.01.tar.gz">
 </itemize>
 
 <P>
@@ -108,6 +106,13 @@ Log in as 'root', and make sure you're at '/root' before you continue. Here are
 # 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 ..
 </verb>
 
 <P>
@@ -120,7 +125,7 @@ nearly are! Pay particular attention to the instructions of <em>IO</em>, above.
 <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>
 Login as root and create a user to run the cluster under.  <bf><it>UNDER 
@@ -134,7 +139,7 @@ however this is your own choice.
 </verb></tscreen>
 
 <P>
-For SUSE distributions, the command would be ..
+For SuSE distributions, the command would be ..
 
 <tscreen><verb>
 # useradd -m sysop
@@ -158,7 +163,7 @@ permissions.  Copy the tarball to /home/sysop and do the following.
 
 <tscreen><verb>
 # 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)
 </verb></tscreen>
@@ -296,7 +301,7 @@ It should look something like this ...
 
 <tscreen><verb>
 $ ./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 ...
@@ -436,6 +441,10 @@ There are 2 main node packages in use of which I shall keep to the
 original by Tomi Manninen, OH2BNS as this is included in the ax25
 rpms as standard.  The other is <htmlurl url="ftp://ftp.funet.fi/pub/ham/packet/linux/awznode/" name="AWZNode"> by IZ5AWZ.
 
+<P>
+NB: The AX25 stuff in 2.4 kernels appears to have been broken until 2.4.18.  I
+strongly suggest you get at least this kernel.
+
 <P>
 For 2.4 kernels you need these files...
 
@@ -1312,7 +1321,7 @@ DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/t
 
 <P>
 This line works fine for RedHat distributions. It is also fine for SuSE up to
-7.0.  From Suse 7.1 you need to add runlevels 2 and 5 like this ...
+7.0.  From SuSE 7.1 you need to add runlevels 2 and 5 like this ...
 
 <tscreen><verb>
 DX:235:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7
@@ -1330,6 +1339,10 @@ DX:23:respawn:/bin/su - sysop -c "/usr/bin/perl -w /spider/perl/cluster.pl" >/de
 This will automatically start DXSpider on tty7 (ALT-F7) on bootup and restart 
 it should it crash for any reason.
 
+<P>
+NB: It should be noted that /dev/tty7 is only an example.  Some SuSE systems will
+only accept upto tty6.  It really does not matter which tty you run it on.
+
 <P>
 As root type the command <em>telinit q</em>.  DXSpider should start up 
 immediately.  You will see the output on tty7 and if you login as <em>sysop</em>