minor changes to admin manual to reflect perl changes etc
authorg0vgs <g0vgs>
Sat, 31 Mar 2001 21:12:20 +0000 (21:12 +0000)
committerg0vgs <g0vgs>
Sat, 31 Mar 2001 21:12:20 +0000 (21:12 +0000)
html/adminmanual-1.html
html/adminmanual-3.html
html/adminmanual.html
sgml/adminmanual.sgml
txt/adminmanual.txt

index 500b636472ac37721cea0c2a7260e723f6e803c6..b41438765f2ab5a46b09e01d5a1acae12ac085f8 100644 (file)
@@ -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 ...
index 41e6eb8704b11878fab527c3bd44c3a4fdf482c7..0beafd34eee5e1ccb8ce76be7f36acf5d1c1fe22 100644 (file)
@@ -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>
index 8c8fc419c90b79fc0ab3706fc2ee7357ee5b98c6..9522aee485d1d13404f8dcc34ad1b54cb8fc12f5 100644 (file)
@@ -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>
index 8af052bada49b951ff2a516d6465fc7211556456..65bf0ae863405e6f9c1460bca56f39b47c27e8b7 100644 (file)
@@ -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>
index fc3e64deb0c170d48b1b1eb37865ac3a71b756d4..107b4dce9eb093fdbdf2d2eca3646ed70c72e28e 100644 (file)
@@ -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.
   ______________________________________________________________________
 
   1\b1.\b.1\b1.\b.  I\bIn\bnt\btr\bro\bod\bdu\buc\bct\bti\bio\bon\bn
 
-  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
   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.  _\bB_\be _\bW_\ba_\br_\bn_\be_\bd, earlier versions of RedHat d\bdo\bo n\bno\bot\bt
-  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 _\bS_\bT_\bR_\bO_\bN_\bG_\bL_\bY 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
 
   +\bo  Data-Dumper-2.10.tar.gz
 
-  +\bo  FreezeThaw-0.3.tar.gz
-
-  +\bo  MLDBM-2.00.tar.gz
-
   +\bo  TimeDate-1.08.tar.gz
 
   +\bo  IO-1.20.tar.gz
 
   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.
 
 
 
 
        # 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)
 
 
 
 
-  # 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
   alter the text of any section.  Some of the lines look a little odd.
   Take this line for example ....
 
+
   $myemail = "ianmaude\@btinternet.com";
 
 
 
 
        $ 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 ...
 
   If all is well then login on another term or console as _\bs_\by_\bs_\bo_\bp and cd
   to /spider/perl.  Now issue the following command ...
-       $ client.pl
+
+
+
+
+  $ client.pl
 
 
 
 
 
 
+  or, if you wish your users to be able to use SSID's on their callsigns
+  ..
+
+
+       default  * * * * * *  - sysop /spider/src/client client %s ax25
+
 
 
 
 
 
 
-
   You should now get the login prompt and be able to login as before.
 
 
-
-
   3\b3.\b.3\b3.\b.  S\bSe\bet\btt\bti\bin\bng\bg u\bup\bp n\bno\bod\bde\be c\bco\bon\bnn\bne\bec\bct\bts\bs
 
   In order to allow cluster node connections, spider needs to know that
 
 
 
-       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
 
 
 
+
   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
 
 
 
 
 
 
-
-
-
-
-
   <- D G1TLH connect gb7djk-1
   -> D G1TLH connection to GB7DJK-1 started
   -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z >