minor changes to admin manual to reflect perl changes etc

[spider.git] / sgml / adminmanual.sgml

diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml
index d7bae3d5e0dbfaacf1df9a505ff47069c07fab6a..65bf0ae863405e6f9c1460bca56f39b47c27e8b7 100644 (file)
--- 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)
 
 <title>The DXSpider Installation and Administration Manual 
 <author>Ian Maude, G0VGS, (ianmaude@btinternet.com)

-<date>Version 1.32 February 2001
+<date>Version 1.33 (Revision 1.21) February 2001

 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
 </abstract>
 <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>
 <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 
 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 
 
 <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 
 
 <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: -
 
 <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>         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
 <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 
 <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 
 
 <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
 
 <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>
 # 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
 
 <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 ...
 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>
 
 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>
 <sect1>Allowing telnet connects from users
 
 <P>


@@ -601,6 +602,15 @@ the following lines to the file near the end ...
 DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7
 </verb></tscreen>
 
 DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7
 </verb></tscreen>
 

+<P>
+This line works fine for RedHat and SuSE distributions.  The line required for
+Slackware distributions is slightly different.  My thanks to Aurelio, PA3EZL for
+this information.
+
+<tscreen><verb>
+DX:23:respawn:/bin/su - sysop -c "/usr/bin/perl -w /spider/perl/cluster.pl" >/dev/tty7
+</verb></tscreen>
+

 <P>
 This will automatically start DXSpider on tty7 (ALT-F7) on bootup and restart 
 it should it crash for any reason.
 <P>
 This will automatically start DXSpider on tty7 (ALT-F7) on bootup and restart 
 it should it crash for any reason.


@@ -1928,6 +1938,16 @@ load/keps
 
 That is it!  the kepler data has been updated.
 
 
 That is it!  the kepler data has been updated.
 

+<sect1>The QRZ callbook
+
+<P>
+The command <em>sh/qrz</em> will only work once you have followed a few
+simple steps.  First you need to get a user ID and password from qrz.com.
+Simply go to the site and create one.  Secondly you need to copy the file
+/spider/perl/Internet.pm to /spider/local and alter it to match your user
+ID and password.  You also at this point need to set $allow=1 to complete
+the setup.  Many thanks to Fred Lloyd, the proprieter of
+<htmlurl url="http://www.qrz.com" name="qrz.com"> for allowing this access.

 
 <sect>CVS
 
 
 <sect>CVS
 


@@ -3515,7 +3535,18 @@ Set the node_call as a CLX type node
 </tt>
 
 <P>
 </tt>
 
 <P>

-You can remove this level with unset/debug &lt;name&gt;
+You can choose to log several different levels.  The levels are
+
+chan
+state
+msg
+cron
+connect
+
+You can show what levels you are logging with the <em>show/debug</em>
+command.
+
+You can remove a debug level with unset/debug &lt;name&gt;

 
 <sect1>set/dx (0)
 
 
 <sect1>set/dx (0)
 


@@ -3963,7 +3994,7 @@ for more information.
 
 <P>
 <tt>
 
 <P>
 <tt>

-<bf>show/badspotter</bf>Show all the bad spotters in the system
+<bf>show/badspotter</bf> Show all the bad spotters in the system

 </tt>
 
 <P>
 </tt>
 
 <P>


@@ -3987,6 +4018,16 @@ time and UTC as the computer has it right now. If you give some prefixes
 then it will show UTC and UTC + the local offset (not including DST) at
 the prefixes or callsigns that you specify.
 
 then it will show UTC and UTC + the local offset (not including DST) at
 the prefixes or callsigns that you specify.
 

+<sect1>show/debug (9)
+
+<P>
+<tt>
+<bf>show/debug</bf> Show what levels of debug you are logging
+</tt>
+
+<P>
+The levels can be set with <em>set/debug</em>
+

 <sect1>show/dx (0)
 
 <P>
 <sect1>show/dx (0)
 
 <P>