X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=sgml%2Fadminmanual.sgml;h=65bf0ae863405e6f9c1460bca56f39b47c27e8b7;hb=640675d8ace63cdc06ef89b7020791ab91b62ce5;hp=d7bae3d5e0dbfaacf1df9a505ff47069c07fab6a;hpb=175151ba8f0fec2628e157c1d54dcbf89091e522;p=spider.git diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml index d7bae3d5..65bf0ae8 100644 --- a/sgml/adminmanual.sgml +++ b/sgml/adminmanual.sgml @@ -6,7 +6,7 @@ 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> @@ -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> @@ -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> +<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. @@ -1928,6 +1938,16 @@ load/keps 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 @@ -3515,7 +3535,18 @@ Set the node_call as a CLX type node </tt> <P> -You can remove this level with unset/debug <name> +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 <name> <sect1>set/dx (0) @@ -3963,7 +3994,7 @@ for more information. <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> @@ -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. +<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>