X-Git-Url: http://scm.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=txt%2Fadminmanual.txt;h=537cacdcc34e4c40eb6ce2e7ce37e609a21a8a9d;hb=63b5e2134b2ffba051682618f88b09d5ee5457c7;hp=f7073ed7c5e84ef2e32f9f1503ff3d7722b119c5;hpb=b2478484ac66d4c499a2348b8163a7e0966f4250;p=spider.git diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt index f7073ed7..537cacdc 100644 --- a/txt/adminmanual.txt +++ b/txt/adminmanual.txt @@ -1,6 +1,6 @@ The DXSpider Installation and Administration Manual Ian Maude, G0VGS, (ianmaude@btinternet.com) - Version 1.32 February 2001 + Version 1.34 (Revision 1.01) April 2001 A reference for SysOps of the DXSpider DXCluster program. ______________________________________________________________________ @@ -64,15 +64,16 @@ - 1. Installation (Original version by Iain Phillips, G0RDI) + 1. Installation (Original version by Iain Philipps, G0RDI) 1.1 Introduction 1.2 Preparation 1.3 Installing the software 1.4 Setting callsigns etc 1.5 Starting up for the first time + 1.6 The Client program - 2. The Client program + 2. Quick installation guide 3. Configuration @@ -140,6 +141,7 @@ 11.4 The Aliases file 11.5 Console.pl 11.6 Updating kepler data + 11.7 The QRZ callbook 12. CVS @@ -248,52 +250,55 @@ 13.101 show/badnode (6) 13.102 show/badspotter (1) 13.103 show/date (0) - 13.104 show/dx (0) - 13.105 show/dxcc (0) - 13.106 show/files (0) - 13.107 show/filter (0) - 13.108 show/filter (extended for sysops) (5) - 13.109 show/hops (8) - 13.110 show/isolate (1) - 13.111 show/lockout (9) - 13.112 show/log (8) - 13.113 show/moon (0) - 13.114 show/muf (0) - 13.115 show/node (1) - 13.116 show/prefix (0) - 13.117 show/program (5) - 13.118 show/qra (0) - 13.119 show/qrz (0) - 13.120 show/route (0) - 13.121 show/satellite (0) - 13.122 show/sun (0) - 13.123 show/time (0) - 13.124 show/wcy (0) - 13.125 show/wwv (0) - 13.126 shutdown (5) - 13.127 spoof (9) - 13.128 stat/db (5) - 13.129 stat/channel (5) - 13.130 stat/msg (5) - 13.131 stat/user (5) - 13.132 sysop (0) - 13.133 talk (0) - 13.134 type (0) - 13.135 who (0) - 13.136 wx (0) - 13.137 wx (enhanced for sysops) (5) + 13.104 show/debug (9) + 13.105 show/dx (0) + 13.106 show/dxcc (0) + 13.107 show/files (0) + 13.108 show/filter (0) + 13.109 show/filter (extended for sysops) (5) + 13.110 show/hops (8) + 13.111 show/isolate (1) + 13.112 show/lockout (9) + 13.113 show/log (8) + 13.114 show/moon (0) + 13.115 show/muf (0) + 13.116 show/node (1) + 13.117 show/prefix (0) + 13.118 show/program (5) + 13.119 show/qra (0) + 13.120 show/qrz (0) + 13.121 show/route (0) + 13.122 show/satellite (0) + 13.123 show/sun (0) + 13.124 show/time (0) + 13.125 show/wcy (0) + 13.126 show/wwv (0) + 13.127 shutdown (5) + 13.128 spoof (9) + 13.129 stat/db (5) + 13.130 stat/channel (5) + 13.131 stat/msg (5) + 13.132 stat/user (5) + 13.133 sysop (0) + 13.134 talk (0) + 13.135 type (0) + 13.136 who (0) + 13.137 wx (0) + 13.138 wx (enhanced for sysops) (5) ______________________________________________________________________ - 11.. IInnssttaallllaattiioonn ((OOrriiggiinnaall vveerrssiioonn bbyy IIaaiinn PPhhiilllliippss,, GG00RRDDII)) + 11.. IInnssttaallllaattiioonn ((OOrriiggiinnaall vveerrssiioonn bbyy IIaaiinn PPhhiilliippppss,, GG00RRDDII)) 11..11.. IInnttrroodduuccttiioonn - 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 @@ -301,14 +306,14 @@ 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. _B_e _W_a_r_n_e_d, earlier versions of RedHat ddoo nnoott - 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 _S_T_R_O_N_G_L_Y 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 - following CPAN modules: - + following modules from http://www.cpan.org/CPAN.html ... @@ -316,16 +321,13 @@ +o Data-Dumper-2.10.tar.gz - +o FreezeThaw-0.3.tar.gz - - +o MLDBM-2.00.tar.gz - +o TimeDate-1.08.tar.gz +o IO-1.20.tar.gz +o Net-Telnet-3.02.tar.gz + +o Curses-1.05.tar.gz +o Time-HiRes-01.20.tar.gz @@ -340,7 +342,7 @@ 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. @@ -380,7 +382,7 @@ # 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) @@ -392,7 +394,10 @@ - # 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 @@ -459,7 +464,6 @@ alter the text of any section. Some of the lines look a little odd. Take this line for example .... - $myemail = "ianmaude\@btinternet.com"; @@ -470,11 +474,10 @@ PPLLEEAASSEE UUSSEE CCAAPPIITTAALL LLEETTTTEERRSS FFOORR CCAALLLLSSIIGGNNSS - 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! Save the new file and change directory to ../perl .... @@ -492,7 +495,7 @@ - $ create_sysop.pl + $ ./create_sysop.pl @@ -505,8 +508,8 @@ - $ 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 ... @@ -521,12 +524,9 @@ If all is well then login on another term or console as _s_y_s_o_p and cd - to /spider/perl. Now issue the following command ... - - + to /spider/src. Now issue the following command ... - - $ client.pl + $ ./client @@ -560,7 +560,7 @@ and both the cluster and the client should return to Linux prompts. - 22.. TThhee CClliieenntt pprrooggrraamm + 11..66.. TThhee CClliieenntt pprrooggrraamm In earlier versions of Spider, all the processes were Perl scripts. This was fine but with a lot of users your computer memory would soon @@ -571,8 +571,93 @@ small C program called _c_l_i_e_n_t. Leave it in this directory. + + 22.. QQuuiicckk iinnssttaallllaattiioonn gguuiiddee + + This section is designed for experienced Spider sysops who want to + install Spider from scratch. It is simply a check list of things that + need to be done without any explanations. The name in brackets at the + end of each line is the user that should be doing that process. + + + +o Login as root + + +o Get the additional CPAN modules and install them (root) + + +o Create the "sysop" user and set a password (root) + + +o Put the Spider tarball in sysop and untar it (root) + + +o ln -s sysop/spider /spider (root) + + +o groupadd -g 251 spider (root) + + +o Add any more users you need to the group entry in /etc/group (root) + + +o Set the permissions on the spider tree (root) + + +o Fix permissions on ax25_call and netrom_call (root) + + +o Login as the sysop user + + +o cd to /spider (sysop) + + +o mkdir local (sysop) + + +o mkdir local_cmd (sysop) + + +o cp perl/DXVars.pm.issue local/DXVars.pm (sysop) + + +o cd to /spider/local and edit DXVars to set your details (sysop) + + +o cd ../perl (sysop) + + +o ./create_sysop.pl (sysop) + + +o ./cluster.pl (sysop) + + Spider should now be running and you should be able to login using the + client program. + + + +o Login as root + + +o Enter the correct line in ax25d.conf (root) + + +o Enter the correct line in /etc/services (root) + + +o Enter the correct line in /etc/inetd.conf (root) + + +o killall -HUP inetd (root) + + Spider should now be able to accept logins via telnet, netrom and + ax25. + + + +o Login as sysop + + +o Start the cluster (sysop) + + +o set/node and type for links (sysop) + + +o Write any connect scripts (sysop) + + +o Edit /spider/crontab as required (sysop) + + +o Edit any other files as necessary (sysop) + + +o Set filters, hops and forwarding files (sysop) + + +o Login as root + + +o Enter the correct line in /etc/inittab (root) + + 33.. CCoonnffiigguurraattiioonn + + + 33..11.. AAlllloowwiinngg aaxx2255 ccoonnnneeccttss ffrroomm uusseerrss As stated previously, the aim of this document is not to tell you how @@ -588,6 +673,13 @@ + or, if you wish your users to be able to use SSID's on their callsigns + .. + + + + default * * * * * * - sysop /spider/src/client client %s ax25 + @@ -627,12 +719,12 @@ - Now login as _s_y_s_o_p and cd spider/perl. You can test that spider is + Now login as _s_y_s_o_p and cd spider/src. You can test that spider is accepting telnet logins by issuing the following command .... - client.pl login telnet + ./client login telnet @@ -656,8 +748,6 @@ You should now get the login prompt and be able to login as before. - - 33..33.. SSeettttiinngg uupp nnooddee ccoonnnneeccttss In order to allow cluster node connections, spider needs to know that @@ -689,7 +779,7 @@ Start up the cluster as you did before and login as the sysop with - client.pl. The cluster node I am wanting to make a connection to is + client. The cluster node I am wanting to make a connection to is GB7BAA but you would obviously use whatever callsign you required. At the prompt type ... @@ -700,18 +790,17 @@ - The case does not matter as long as you have a version of DXSpider later than 1.33. Earlier versions required the callsign to be in upper case. That is now set, it is as simple as that. To prove it, login on yet - another console as sysop and issue the command ... + another console as sysop, cd to spider/src and issue the command ... - client.pl gb7baa (using the callsign you set as a node) + ./client gb7baa (using the callsign you set as a node) @@ -721,9 +810,12 @@ - client.pl gb7baa + ./client 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 be outgoing then a connection script needs to be written. @@ -743,6 +835,27 @@ + + + + + + + + + + + + + + + + + + + + + # All lines starting with a # are ignored, as are completely blank lines. @@ -788,14 +901,12 @@ - - - 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 @@ -811,9 +922,6 @@ client gb7djk telnet - - - Both these examples assume that everything is set up properly at the other end. You will find other examples in the /spider/examples directory. @@ -839,49 +947,32 @@ - - - - - - - - - - - - - - - - - - <- D G1TLH connect gb7djk-1 - -> D G1TLH connection to GB7DJK-1 started - -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z > - timeout set to 15 - CONNECT sort: telnet command: dirkl.tobit.co.uk - CHAT "login" -> "gb7djk" - received " - Red Hat Linux release 5.1 (Manhattan) - Kernel 2.0.35 on an i586 - " - received "login: " - sent "gb7djk" - CHAT "word" -> "gb7djk" - received "gb7djk" - received "Password: " - sent "gb7djk" - Connected to GB7DJK-1, starting normal protocol - <- O GB7DJK-1 telnet - -> B GB7DJK-1 0 - GB7DJK-1 channel func state 0 -> init - <- D GB7DJK-1 - <- D GB7DJK-1 Last login: Sun Dec 13 17:59:56 from dirk1 - <- D GB7DJK-1 PC38^GB7DJK-1^~ - <- D GB7DJK-1 PC18^ 1 nodes, 0 local / 1 total users Max users 0 Uptime - 0 00:00^5447^~ - etc + <- D G1TLH connect gb7djk-1 + -> D G1TLH connection to GB7DJK-1 started + -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z > + timeout set to 15 + CONNECT sort: telnet command: dirkl.tobit.co.uk + CHAT "login" -> "gb7djk" + received " + Red Hat Linux release 5.1 (Manhattan) + Kernel 2.0.35 on an i586 + " + received "login: " + sent "gb7djk" + CHAT "word" -> "gb7djk" + received "gb7djk" + received "Password: " + sent "gb7djk" + Connected to GB7DJK-1, starting normal protocol + <- O GB7DJK-1 telnet + -> B GB7DJK-1 0 + GB7DJK-1 channel func state 0 -> init + <- D GB7DJK-1 + <- D GB7DJK-1 Last login: Sun Dec 13 17:59:56 from dirk1 + <- D GB7DJK-1 PC38^GB7DJK-1^~ + <- D GB7DJK-1 PC18^ 1 nodes, 0 local / 1 total users Max users 0 Uptime + 0 00:00^5447^~ + etc @@ -897,12 +988,6 @@ avoid this use the following line ... - - - - - - In a script, this might look like ... @@ -988,6 +1073,30 @@ + + 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 ... + + + + DX:235:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7 + + + + + + The line required for Slackware distributions is slightly different. + My thanks to Aurelio, PA3EZL for this information. + + + + DX:23:respawn:/bin/su - sysop -c "/usr/bin/perl -w /spider/perl/cluster.pl" >/dev/tty7 + + + + + This will automatically start DXSpider on tty7 (ALT-F7) on bootup and restart it should it crash for any reason. @@ -1008,10 +1117,13 @@ - # check every 10 minutes to see if gb7xxx is connected and if not - # start a connect job going - 0,10,20,30,40,50 * * * * start_connect('gb7xxx') if !connected('gb7xxx') + + + # check every 10 minutes to see if gb7xxx is connected and if not + # start a connect job going + + 0,10,20,30,40,50 * * * * start_connect('gb7xxx') if !connected('gb7xxx') @@ -1053,6 +1165,26 @@ + + + + + + + + + + + + + + + + + + + + # # hop table construction @@ -2264,14 +2396,14 @@ directly or nested under directories. One use for this would be to store DX bulletins such as the OPDX bulletins. These can be listed and read by the user. To keep things tidy, make a directory under - /spider/packclus called _b_u_l_l_e_t_i_n_s. Now copy any OPDX or similar + /spider/packclus called _b_u_l_l_e_t_i_n. Now copy any OPDX or similar bulletins into it. These can be listed by the user in the same way as - above using the _s_h_o_w_/_f_i_l_e_s command with an extension for the bulletins + above using the _s_h_o_w_/_f_i_l_e_s command with an extension for the bulletin directory you have just created, like this .... - show/files bulletins + show/files bulletin @@ -2282,13 +2414,13 @@ sh/files - bulletins DIR 20-Dec-1999 1715Z news 1602 14-Dec-1999 1330Z + bulletin DIR 20-Dec-1999 1715Z news 1602 14-Dec-1999 1330Z You can see that in the files area (basically the packclus directory) - there is a file called _n_e_w_s and a directory called _b_u_l_l_e_t_i_n_s. You can + there is a file called _n_e_w_s and a directory called _b_u_l_l_e_t_i_n. You can also see that dates they were created. In the case of the file _n_e_w_s, you can also see the time it was last modified, a good clue as to whether the file has been updated since you last read it. To read the @@ -2301,14 +2433,14 @@ - To look what is in the bulletins directory you issue the command .... + To look what is in the bulletin directory you issue the command .... - show/files bulletins + show/files bulletin opdx390 21381 29-Nov-1999 1621Z opdx390.1 1670 29-Nov-1999 1621Z opdx390.2 2193 29-Nov-1999 1621Z opdx391 25045 29-Nov-1999 1621Z opdx392 35969 29-Nov-1999 1621Z opdx393 15023 29-Nov-1999 1621Z @@ -2332,7 +2464,7 @@ - type bulletins/opdx391 + type bulletin/opdx391 Ohio/Penn DX Bulletin No. 391 The Ohio/Penn Dx PacketCluster DX Bulletin No. 391 @@ -2521,7 +2653,7 @@ In later versions of Spider a simple console program is provided for the sysop. This has a type ahead buffer with line editing facilities and colour for spots, announces etc. To use this program, simply use - console.pl instead of client.pl. + console.pl instead of client. To edit the colours, copy /spider/perl/Console.pl to /spider/local and @@ -2572,6 +2704,17 @@ + 1111..77.. TThhee QQRRZZ ccaallllbbooookk + + The command _s_h_/_q_r_z 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 qrz.com for allowing this access. + + 1122.. CCVVSS CVS stands for "Concurrent Versions System" and the CVS for DXSpider @@ -2618,10 +2761,13 @@ What happens next depends on whether you have an existing installation that you want to update with the latest and greatest or whether you just want to see what is there and/or run it on a new machine for - testing. Either way you will want to change directory to a new place, - if you want to update an existing installation then I suggest /tmp, - otherwise choose a suitable place according to the normal installation - instructions. + testing. + + If you are installing Spider from CVS then change directory to + /home/sysop + + If you are wanting to update Spider then cd to /tmp + The next step will create a brand new 'spider' directory in your @@ -2667,7 +2813,7 @@ Remember to recompile the C client (cd /spider/src; make) - At this point the files have been upgraded. You can (usually) restrt + At this point the files have been upgraded. You can (usually) restart the cluster in your own time. However, if you attempt to use any new commands or features expect it to be fatal! At least your cluster will have been restarted then so it will be too late to worry about @@ -2690,7 +2836,6 @@ any of the perl scripts have been altered or added, again, CVS will tell you. - You will find any changes documented in the /spider/Changes file. @@ -2703,7 +2848,6 @@ is the permissions level needed to use the command. - 1133..11.. aacccceepptt//aannnnoouunnccee ((00)) aacccceepptt//aannnnoouunnccee [[00--99]] <
> Set an accept filter line for announce
@@ -2758,9 +2902,6 @@
This filter would only allow announces that were posted buy UK
stations. You can use the tag 'all' to accept everything eg:
-
-
-
acc/ann all
@@ -2769,7 +2910,6 @@
but this probably for advanced users...
-
1133..22.. aacccceepptt//aannnnoouunnccee ((eexxtteennddeedd ffoorr ssyyssooppss)) ((88))
aacccceepptt//aannnnoouunnccee < > Announce filter sysop
@@ -2828,7 +2968,6 @@
thus: hf/ssb. You can also just have a simple range like: 0/30000 -
this is more efficient than saying simply: freq HF (but don't get too
hung up about that)
-
some examples:-
@@ -2836,6 +2975,9 @@
acc/spot 1 on hf/cw
acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
+
+
+
You can use the tag 'all' to accept everything, eg:
@@ -2901,7 +3043,6 @@
See HELP FILTER for information.
-
1133..66.. aacccceepptt//wwccyy ((eexxtteennddeedd ffoorr ssyyssooppss)) ((88))
aacccceepptt//wwccyy < > WCY filter sysop version
@@ -2957,6 +3098,8 @@
See HELP FILTER for information.
+
+
1133..88.. aacccceepptt//wwwwvv ((eexxtteennddeedd ffoorr ssyyssooppss)) ((88))
aacccceepptt//wwwwvv < > WWV filter sysop version
@@ -2967,12 +3110,11 @@
+ accept/wwv db0sue-7 1 by_zone 4
+ accept/wwv node_default all
+ set/hops node_default 10
- accept/wwv db0sue-7 1 by_zone 4
- accept/wwv node_default all
- set/hops node_default 10
-
- accept/wwv user_default by W,K
+ accept/wwv user_default by W,K
@@ -3022,6 +3164,8 @@
This will disconnect you from the cluster
+
+
1133..1144.. ccaattcchhuupp ((55))
ccaattcchhuupp < > Interrogate the spot database by country
@@ -4698,14 +4880,16 @@
- SH/DXCC G
- SH/DXCC W on 20m info iota
+ SH/DXCC G
+ SH/DXCC W on 20m info iota
- 1133..110066.. sshhooww//ffiilleess ((00))
+
+
+ 1133..110077.. sshhooww//ffiilleess ((00))
sshhooww//ffiilleess [[< >||< > [[< >||< >||<>]]]] List the contents of a filearea
@@ -4737,7 +4921,7 @@
See also TYPE - to see the contents of a file.
- 1133..110077.. sshhooww//ffiilltteerr ((00))
+ 1133..110088.. sshhooww//ffiilltteerr ((00))
sshhooww//ffiilltteerr Show the filters you have set
@@ -4746,14 +4930,15 @@
displays all the filters set - for all the various categories.
- 1133..110088.. sshhooww//ffiilltteerr ((eexxtteennddeedd ffoorr ssyyssooppss)) ((55))
+ 1133..110099.. sshhooww//ffiilltteerr ((eexxtteennddeedd ffoorr ssyyssooppss)) ((55))
sshhooww//ffiilltteerr <