X-Git-Url: http://gb7djk.dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;f=sgml%2Fadminmanual.sgml;h=034111d3a5cfdad8a6a9ca789ef89e9040ec4fe6;hb=11fa76e3940df1b02b9781303d05716812c8acd7;hp=b2d234535103ddda4ad58be2e8e7d3096aca2684;hpb=4f3bdfa16cf0d5adf08ef13fc06384e39db485c6;p=spider.git diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml index b2d23453..034111d3 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.33 (Revision 2) February 2001 +<date>Version 1.33 (Revision 1.22) March 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,24 +34,19 @@ 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: - +following modules from <htmlurl url="http://www.cpan.org/CPAN.html" name="http://www.cpan.org/CPAN.html"> ... <P> <itemize> <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> @@ -180,10 +175,10 @@ for the file to work so leave it in. <P><bf>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</bf> <P> -DON'T alter the DXVars.pm (or any other file) in /spider/perl, they are -overwritten with every release. Any files or commands you place in /spider/local -or /spider/local_cmd will automagically be used in preference to the ones in -/spider/perl EVEN while the cluster is running! +DON'T alter any file in /spider/perl, they are overwritten with every +release. Any files or commands you place in /spider/local or /spider/local_cmd +will automagically be used in preference to the ones in /spider/perl EVEN +while the cluster is running! <P> Save the new file and change directory to ../perl .... @@ -197,7 +192,7 @@ Now type the following command which creates the basic user file with you as the sysop. <tscreen><verb> -$ create_sysop.pl +$ ./create_sysop.pl </verb></tscreen> <sect1>Starting up for the first time @@ -207,8 +202,8 @@ We can now bring spider up for the first time and see if all is well or not! It should look something like this ... <tscreen><verb> -$ cluster.pl -DXSpider DX Cluster Version 1.35 +$ ./cluster.pl +DXSpider DX Cluster Version 1.46 Copyright (c) 1998 Dirk Koopman G1TLH loading prefixes ... loading band data ... @@ -224,7 +219,7 @@ If all is well then login on another term or console as <em>sysop</em> and cd to /spider/perl. Now issue the following command ... <tscreen><verb> -$ client.pl +$ ./client.pl </verb></tscreen> <P> @@ -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> @@ -302,7 +303,7 @@ killall -HUP inetd is accepting telnet logins by issuing the following command .... <tscreen><verb> -client.pl login telnet +./client.pl login telnet </verb></tscreen> You should get a login prompt and on issuing a callsign, you will be given @@ -360,17 +361,17 @@ The case does not matter as long as you have a version of DXSpider later than <P> That is now set, it is as simple as that. To prove it, login on yet another -console as sysop and issue the command ... +console as sysop, cd to spider/perl and issue the command ... <tscreen><verb> -client.pl gb7baa (using the callsign you set as a node) +./client.pl gb7baa (using the callsign you set as a node) </verb></tscreen> <P> You should get an initialisation string from DXSpider like this ... <tscreen><verb> -client.pl gb7baa +./client.pl gb7baa PC38^GB7MBC^~ </verb></tscreen> @@ -602,9 +603,16 @@ DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/t </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. +This line works fine for RedHat distributions. It is also fine for SuSE up to +7.0. From Suse 7.1 you need to add runlevels 2 and 5 like this ... + +<tscreen><verb> +DX:235:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7 +</verb></tscreen> + + +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 @@ -3534,7 +3542,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) @@ -3982,7 +4001,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> @@ -4006,6 +4025,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>