minor changes to admin manual to reflect perl changes etc
[spider.git] / txt / adminmanual.txt
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 >