From 640675d8ace63cdc06ef89b7020791ab91b62ce5 Mon Sep 17 00:00:00 2001
From: g0vgs <g0vgs>
Date: Sat, 31 Mar 2001 21:12:20 +0000
Subject: [PATCH] minor changes to admin manual to reflect perl changes etc

---
 html/adminmanual-1.html | 29 +++++++--------
 html/adminmanual-3.html |  7 ++++
 html/adminmanual.html   |  2 +-
 sgml/adminmanual.sgml   | 35 +++++++++---------
 txt/adminmanual.txt     | 78 ++++++++++++++++++++---------------------
 5 files changed, 77 insertions(+), 74 deletions(-)

diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html
index 500b6364..b4143876 100644
--- a/html/adminmanual-1.html
+++ b/html/adminmanual-1.html
@@ -18,25 +18,22 @@ Previous
 <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: -
@@ -45,8 +42,6 @@ following
 <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>            Net-Telnet-3.02.tar.gz</LI>
@@ -64,7 +59,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 
@@ -99,7 +94,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>
@@ -203,7 +198,7 @@ It should look something like this ...
 <BLOCKQUOTE><CODE>
 <PRE>
 $ cluster.pl
-DXSpider DX Cluster Version 1.35
+DXSpider DX Cluster Version 1.46
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
diff --git a/html/adminmanual-3.html b/html/adminmanual-3.html
index 41e6eb87..0beafd34 100644
--- a/html/adminmanual-3.html
+++ b/html/adminmanual-3.html
@@ -28,6 +28,13 @@ each interface that you wish to allow connections on, use the following format .
 default  * * * * * *  - sysop /spider/src/client client %u ax25
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>or, if you wish your users to be able to use SSID's on their callsigns ..
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+default  * * * * * *  - sysop /spider/src/client client %s ax25
+</PRE>
+</CODE></BLOCKQUOTE>
 <P>
 <H2><A NAME="ss3.2">3.2 Allowing telnet connects from users</A>
 </H2>
diff --git a/html/adminmanual.html b/html/adminmanual.html
index 8c8fc419..9522aee4 100644
--- a/html/adminmanual.html
+++ b/html/adminmanual.html
@@ -15,7 +15,7 @@ Contents
 <HR>
 <H1>The DXSpider Installation and Administration Manual </H1>
 
-<H2>Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>Version 1.33 (Revision 1.20) February 2001
+<H2>Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>Version 1.33 (Revision 1.21) February 2001
 <P><HR>
 <EM>A reference for SysOps of the DXSpider DXCluster program.</EM>
 <HR>
diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml
index 8af052ba..65bf0ae8 100644
--- a/sgml/adminmanual.sgml
+++ b/sgml/adminmanual.sgml
@@ -6,7 +6,7 @@
 
 <title>The DXSpider Installation and Administration Manual 
 <author>Ian Maude, G0VGS, (ianmaude@btinternet.com)
-<date>Version 1.33 (Revision 1.20) February 2001
+<date>Version 1.33 (Revision 1.21) February 2001
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
 </abstract>
@@ -21,12 +21,12 @@ A reference for SysOps of the DXSpider DXCluster program.
 <sect1>Introduction
 
 <P>
-This section describes the installation of DX Spider v1.35 on a 
-<htmlurl url="http://www.redhat.com" name="RedHat"> Linux Distribution.  
+This section describes the installation of DX Spider v1.46 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 
-HOWTO on the <htmlurl url="http://www.dxcluster.org" name="DXSpider"> 
-website.
+installation guide that comes with the Spider distribution.
 
 <P>
 I am assuming a general knowledge of Linux and its commands.  You should 
@@ -34,13 +34,10 @@ know how to use <em>tar</em> and how to edit files using your favourite editor.
 
 <P>
 The crucial ingredient for all of this is 
-<htmlurl url="http://www.perl.org" name="Perl 5.004">.  Now I know Perl 5.005 
-is out and this will almost certainly work with it, but 
-<htmlurl url="http://www.redhat.com" name="RedHat 5.1"> comes with 5.004. 
-<em>Be Warned</em>, earlier versions of 
-<htmlurl url="http://www.redhat.com" name="RedHat"> <bf>do not</bf> come 
-with 5.004 as standard, you need to 
-<htmlurl url="ftp://upgrade.redhat.com" name="upgrade">
+<htmlurl url="http://www.perl.org" name="Perl">.  Earlier versions of
+Spider required perl 5.004, however it is now <it>STRONGLY</it> recommended
+that you use at least version 5.005_03 as this is the version being used
+in the development of Spider.
 
 <P>In addition to the standard Red Hat distribution you will require the 
 following <htmlurl url="http://www.cpan.org/CPAN.html" name="CPAN"> modules: -
@@ -50,8 +47,6 @@ following <htmlurl url="http://www.cpan.org/CPAN.html" name="CPAN"> modules: -
 
 <item>		MD5-1.7.tar.gz
 <item>		Data-Dumper-2.10.tar.gz
-<item>		FreezeThaw-0.3.tar.gz
-<item>		MLDBM-2.00.tar.gz
 <item>		TimeDate-1.08.tar.gz
 <item>		IO-1.20.tar.gz
 <item>		Net-Telnet-3.02.tar.gz
@@ -70,7 +65,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>
 Login as root and create a user to run the cluster under.  <bf><it>UNDER 
@@ -102,7 +97,7 @@ permissions.  Copy the tarball to /home/sysop and do the following.
 
 <tscreen><verb>
 # 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)
 </verb></tscreen>
@@ -208,7 +203,7 @@ It should look something like this ...
 
 <tscreen><verb>
 $ cluster.pl
-DXSpider DX Cluster Version 1.35
+DXSpider DX Cluster Version 1.46
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
@@ -273,6 +268,12 @@ each interface that you wish to allow connections on, use the following format .
 default  * * * * * *  - sysop /spider/src/client client %u ax25
 </verb></tscreen>
 
+or, if you wish your users to be able to use SSID's on their callsigns ..
+
+<tscreen><verb>
+default  * * * * * *  - sysop /spider/src/client client %s ax25
+</verb></tscreen>
+
 <sect1>Allowing telnet connects from users
 
 <P>
diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt
index fc3e64de..107b4dce 100644
--- a/txt/adminmanual.txt
+++ b/txt/adminmanual.txt
@@ -1,6 +1,6 @@
   The DXSpider Installation and Administration Manual
   Ian Maude, G0VGS, (ianmaude@btinternet.com)
-  Version 1.33 (Revision 1.20) February 2001
+  Version 1.33 (Revision 1.21) February 2001
 
   A reference for SysOps of the DXSpider DXCluster program.
   ______________________________________________________________________
@@ -292,10 +292,12 @@
 
   11..11..  IInnttrroodduuccttiioonn
 
-  This section describes the installation of DX Spider v1.35 on a RedHat
-  Linux Distribution.  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 DXSpider website.
+  This section describes the installation of DX Spider v1.46 on a 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.
 
 
   I am assuming a general knowledge of Linux and its commands.  You
@@ -303,10 +305,10 @@
   editor.
 
 
-  The crucial ingredient for all of this is Perl 5.004.  Now I know Perl
-  5.005 is out and this will almost certainly work with it, but RedHat
-  5.1 comes with 5.004.  _B_e _W_a_r_n_e_d, earlier versions of RedHat ddoo nnoott
-  come with 5.004 as standard, you need to upgrade
+  The crucial ingredient for all of this is Perl.  Earlier versions of
+  Spider required perl 5.004, however it is now _S_T_R_O_N_G_L_Y recommended
+  that you use at least version 5.005_03 as this is the version being
+  used in the development of Spider.
 
 
   In addition to the standard Red Hat distribution you will require the
@@ -318,10 +320,6 @@
 
   +o  Data-Dumper-2.10.tar.gz
 
-  +o  FreezeThaw-0.3.tar.gz
-
-  +o  MLDBM-2.00.tar.gz
-
   +o  TimeDate-1.08.tar.gz
 
   +o  IO-1.20.tar.gz
@@ -342,7 +340,7 @@
 
   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.
 
 
@@ -382,7 +380,7 @@
 
 
        # 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)
 
@@ -394,10 +392,7 @@
 
 
 
-  # vi /etc/group                (or your favorite editor)
-
-
-
+       # vi /etc/group                (or your favorite editor)
 
   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
@@ -464,6 +459,7 @@
   alter the text of any section.  Some of the lines look a little odd.
   Take this line for example ....
 
+
   $myemail = "ianmaude\@btinternet.com";
 
 
@@ -510,7 +506,7 @@
 
 
        $ cluster.pl
-       DXSpider DX Cluster Version 1.35
+       DXSpider DX Cluster Version 1.46
        Copyright (c) 1998 Dirk Koopman G1TLH
        loading prefixes ...
        loading band data ...
@@ -526,7 +522,11 @@
 
   If all is well then login on another term or console as _s_y_s_o_p and cd
   to /spider/perl.  Now issue the following command ...
-       $ client.pl
+
+
+
+
+  $ client.pl
 
 
 
@@ -588,6 +588,12 @@
 
 
 
+  or, if you wish your users to be able to use SSID's on their callsigns
+  ..
+
+
+       default  * * * * * *  - sysop /spider/src/client client %s ax25
+
 
 
 
@@ -652,12 +658,9 @@
 
 
 
-
   You should now get the login prompt and be able to login as before.
 
 
-
-
   33..33..  SSeettttiinngg uupp nnooddee ccoonnnneeccttss
 
   In order to allow cluster node connections, spider needs to know that
@@ -721,8 +724,11 @@
 
 
 
-       client.pl gb7baa
-       PC38^GB7MBC^~
+  client.pl gb7baa
+  PC38^GB7MBC^~
+
+
+
 
   If the callsign you just set up as a cluster node is for an incoming
   connect, this is all that needs to be done.  If the connection is to
@@ -783,19 +789,18 @@
 
 
 
+
   There are many possible ways to configure the script but here are two
   examples, one for a NETRom/AX25 connect and one for tcp/ip.
 
 
 
-
-
-  timeout 60
-  abort (Busy|Sorry|Fail)
-  # don't forget to chmod 4775 netrom_call!
-  connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh
-  # you can leave this out if you call the script 'gb7dxm'
-  client gb7dxm ax25
+       timeout 60
+       abort (Busy|Sorry|Fail)
+       # don't forget to chmod 4775 netrom_call!
+       connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh
+       # you can leave this out if you call the script 'gb7dxm'
+       client gb7dxm ax25
 
 
 
@@ -851,11 +856,6 @@
 
 
 
-
-
-
-
-
   <- D G1TLH connect gb7djk-1
   -> D G1TLH connection to GB7DJK-1 started
   -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z >
-- 
2.34.1