X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=txt%2Fadminmanual.txt;h=f8de19b2fddcd531c0ab54b1c6f1cfbfda1868d5;hb=b21ba4d796c6e285685a18be32f538facb2408c5;hp=de47e0af844cc43569aa059e35c5fa25e5c5e2ff;hpb=ad10d0e662650f1ac03895d5c9143e204764ef53;p=spider.git diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt index de47e0af..f8de19b2 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.33 February 2001 + Version 1.33 (Revision 1.22) March 2001 A reference for SysOps of the DXSpider DXCluster program. ______________________________________________________________________ @@ -249,40 +249,41 @@ 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) ______________________________________________________________________ @@ -291,10 +292,12 @@ 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 @@ -302,14 +305,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 ... @@ -317,17 +320,12 @@ +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 @@ -342,7 +340,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. @@ -382,7 +380,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) @@ -394,10 +392,7 @@ - # 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 @@ -464,6 +459,7 @@ alter the text of any section. Some of the lines look a little odd. Take this line for example .... + $myemail = "ianmaude\@btinternet.com"; @@ -474,11 +470,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 .... @@ -496,7 +491,7 @@ - $ create_sysop.pl + $ ./create_sysop.pl @@ -509,8 +504,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 ... @@ -526,11 +521,10 @@ 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 ... - $ client.pl - + $ ./client.pl This should log you into the cluster as the sysop under the alias callsign we set earlier. In this case the callsign is G0VGS. The @@ -588,6 +582,12 @@ + or, if you wish your users to be able to use SSID's on their callsigns + .. + + + + default * * * * * * - sysop /spider/src/client client %s ax25 @@ -632,7 +632,7 @@ - client.pl login telnet + ./client.pl login telnet @@ -707,11 +707,11 @@ 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/perl and issue the command ... - client.pl gb7baa (using the callsign you set as a node) + ./client.pl gb7baa (using the callsign you set as a node) @@ -721,7 +721,7 @@ - client.pl gb7baa + ./client.pl gb7baa PC38^GB7MBC^~ If the callsign you just set up as a cluster node is for an incoming @@ -988,6 +988,29 @@ + 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. @@ -1028,6 +1051,9 @@ website at the cron page where it is explained more fully. + + + 55.. HHoopp ccoonnttrrooll Starting with version 1.13 there is simple hop control available on a @@ -1054,6 +1080,46 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + # # hop table construction # @@ -4203,7 +4269,13 @@ sseett//ddeebbuugg <> Add a debug level to the debug set - You can remove this level with unset/debug + 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 _s_h_o_w_/_d_e_b_u_g command. + + You can remove a debug level with unset/debug 1133..7722.. sseett//ddxx ((00)) @@ -4214,6 +4286,8 @@ You can stop DX messages with the _u_n_s_e_t_/_d_x command + + 1133..7733.. sseett//ddxxggrriidd ((00)) sseett//ddxxggrriiddAllow grid squares on the end of DX messages @@ -4222,6 +4296,8 @@ Some logging programs do not like the additional information at the end of a DX spot. If this is the case, use the _u_n_s_e_t_/_d_x_g_r_i_d command to remove the grid squares. + + 1133..7744.. sseett//ddxxnneett ((55)) sseett//ddxxnneett <> [[<> ......]] Make the node_call a DXNet @@ -4276,6 +4352,8 @@ + + 1133..7788.. sseett//hhooppss ((88)) sseett//hhooppss <> aannnn||ssppoottss||wwwwvv||wwccyy <> Set hop count @@ -4288,9 +4366,9 @@ - eg: - set/hops gb7djk ann 10 - set/hops gb7mbc spots 20 + eg: + set/hops gb7djk ann 10 + set/hops gb7mbc spots 20 @@ -4342,7 +4420,6 @@ - 1133..8822.. sseett//ssyyss__llooccaattiioonn ((99)) sseett//ssyyss__llooccaattiioonn <> Set your cluster latitude and longitude @@ -4354,6 +4431,7 @@ example:- + SET/LOCATION 52 22 N 0 57 E @@ -4406,18 +4484,17 @@ - set/spider - set/dxnet - set/clx - set/arcluster + set/spider + set/dxnet + set/clx + set/arcluster - To see what your nodes are set to, use the _s_h_o_w_/_n_o_d_e_s command. - + To see what your nodes are set to, use the _s_h_o_w_/_n_o_d_e_s command. 1133..8877.. sseett//oobbssccoouunntt ((99)) @@ -4474,6 +4551,7 @@ type password. + 1133..9900.. sseett//ppiinnggiinntteerrvvaall ((99)) sseett//ppiinnggiinntteerrvvaall <> <> Set the ping time to neighbouring @@ -4485,7 +4563,6 @@ in future, to affect routing decisions. The default interval is 300 secs or 5 minutes. - You can use this command to set a different interval. Please don't. But if you do the value you enter is treated as minutes up 60 and @@ -4552,6 +4629,7 @@ + 1133..9955.. sseett//qqtthh ((00)) sseett//qqtthh <> Set your QTH @@ -4603,6 +4681,9 @@ WX messages with the _u_n_s_e_t_/_w_x command. + + + 1133..110000.. sshhooww//bbaaddddxx ((11)) sshhooww//bbaaddddxxShow all the bad dx calls in the system @@ -4617,14 +4698,13 @@ sshhooww//bbaaddnnooddee Show all the bad nodes in the system - Display all the bad node callsigns in the system, see SET/BADNODE for more information. 1133..110022.. sshhooww//bbaaddssppootttteerr ((11)) - sshhooww//bbaaddssppootttteerrShow all the bad spotters in the system + sshhooww//bbaaddssppootttteerr Show all the bad spotters in the system Display all the bad spotter's callsigns in the system, see @@ -4645,38 +4725,24 @@ including DST) at the prefixes or callsigns that you specify. - 1133..110044.. sshhooww//ddxx ((00)) - - sshhooww//ddxx [[ooppttiioonnss]] interrogate the spot database - - - If you just type SHOW/DX you will get the last so many spots (sysop - configurable, but usually 10). - - In addition you can add any number of these options in very nearly any - order to the basic SHOW/DX command, they are:- - - - - - - - - - - - - - + 1133..110044.. sshhooww//ddeebbuugg ((99)) + sshhooww//ddeebbuugg Show what levels of debug you are logging + The levels can be set with _s_e_t_/_d_e_b_u_g + 1133..110055.. sshhooww//ddxx ((00)) + sshhooww//ddxx [[ooppttiioonnss]] interrogate the spot database + If you just type SHOW/DX you will get the last so many spots (sysop + configurable, but usually 10). + In addition you can add any number of these options in very nearly any + order to the basic SHOW/DX command, they are:- @@ -4734,7 +4800,7 @@ - 1133..110055.. sshhooww//ddxxcccc ((00)) + 1133..110066.. sshhooww//ddxxcccc ((00)) sshhooww//ddxxcccc <> Interrogate the spot database by country @@ -4757,7 +4823,7 @@ - 1133..110066.. sshhooww//ffiilleess ((00)) + 1133..110077.. sshhooww//ffiilleess ((00)) sshhooww//ffiilleess [[<> [[<>]]]] List the contents of a filearea @@ -4789,7 +4855,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 @@ -4798,7 +4864,7 @@ 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 <> Show the filters set by @@ -4806,7 +4872,7 @@ A sysop can look at any filters that have been set. - 1133..110099.. sshhooww//hhooppss ((88)) + 1133..111100.. sshhooww//hhooppss ((88)) sshhooww//hhooppss <> [[aannnn||ssppoottss||wwccyy||wwwwvv||]] Show the hop counts for a node @@ -4816,7 +4882,7 @@ which category you want to see. If you leave the category out then all the categories will be listed. - 1133..111100.. sshhooww//iissoollaattee ((11)) + 1133..111111.. sshhooww//iissoollaattee ((11)) sshhooww//iissoollaattee Show a list of isolated nodes @@ -4824,7 +4890,7 @@ Show which nodes are currently set to be isolated. - 1133..111111.. sshhooww//lloocckkoouutt ((99)) + 1133..111122.. sshhooww//lloocckkoouutt ((99)) sshhooww//lloocckkoouutt Show a list of excluded callsigns @@ -4833,7 +4899,7 @@ cluster locally with the _s_e_t_/_l_o_c_k_o_u_t command - 1133..111122.. sshhooww//lloogg ((88)) + 1133..111133.. sshhooww//lloogg ((88)) sshhooww//lloogg [[<>]] Show excerpts from the system log @@ -4843,7 +4909,7 @@ show output from the log associated with that callsign. - 1133..111133.. sshhooww//mmoooonn ((00)) + 1133..111144.. sshhooww//mmoooonn ((00)) sshhooww//mmoooonn [[<>||<>]] Show moon rise and set times @@ -4873,7 +4939,7 @@ - 1133..111144.. sshhooww//mmuuff ((00)) + 1133..111155.. sshhooww//mmuuff ((00)) sshhooww//mmuuff <> [[<>]][[lloonngg]] Show the likely propagation to @@ -4964,7 +5030,7 @@ terrible accurate, but it is included for completeness. - 1133..111155.. sshhooww//nnooddee ((11)) + 1133..111166.. sshhooww//nnooddee ((11)) sshhooww//nnooddee [[<> ......]] Show the type and version number of nodes @@ -4974,7 +5040,7 @@ the non-user callsigns known to the system will be displayed. - 1133..111166.. sshhooww//pprreeffiixx ((00)) + 1133..111177.. sshhooww//pprreeffiixx ((00)) sshhooww//pprreeffiixx <> Interrogate the prefix database @@ -4988,7 +5054,7 @@ - 1133..111177.. sshhooww//pprrooggrraamm ((55)) + 1133..111188.. sshhooww//pprrooggrraamm ((55)) sshhooww//pprrooggrraamm Show the locations of all the included program modules @@ -4998,7 +5064,7 @@ from. - 1133..111188.. sshhooww//qqrraa ((00)) + 1133..111199.. sshhooww//qqrraa ((00)) sshhooww//qqrraa <> [[<>]] Show the distance between locators sshhooww//qqrraa <> <> Convert latitude and longitude to a locator @@ -5031,7 +5097,7 @@ - 1133..111199.. sshhooww//qqrrzz ((00)) + 1133..112200.. sshhooww//qqrrzz ((00)) sshhooww//qqrrzz <> Show any callbook details on a callsign @@ -5041,7 +5107,7 @@ provided for users of this software by http://www.qrz.com - 1133..112200.. sshhooww//rroouuttee ((00)) + 1133..112211.. sshhooww//rroouuttee ((00)) sshhooww//rroouuttee <> Show the route to @@ -5057,7 +5123,7 @@ - 1133..112211.. sshhooww//ssaatteelllliittee ((00)) + 1133..112222.. sshhooww//ssaatteelllliittee ((00)) sshhooww//ssaatteelllliittee <> [[<> <>]] Show satellite tracking data @@ -5091,7 +5157,7 @@ - 1133..112222.. sshhooww//ssuunn ((00)) + 1133..112233.. sshhooww//ssuunn ((00)) sshhooww//ssuunn [[<>||<>]] Show sun rise and set times @@ -5118,7 +5184,7 @@ - 1133..112233.. sshhooww//ttiimmee ((00)) + 1133..112244.. sshhooww//ttiimmee ((00)) sshhooww//ttiimmee [[<>||<>]] Show the local time @@ -5129,7 +5195,7 @@ including DST) at the prefixes or callsigns that you specify. - 1133..112244.. sshhooww//wwccyy ((00)) + 1133..112255.. sshhooww//wwccyy ((00)) sshhooww//wwccyy Show the last 10 WCY broadcasts sshhooww//wwccyy <> Show the last WCY broadcasts @@ -5139,7 +5205,7 @@ system - 1133..112255.. sshhooww//wwwwvv ((00)) + 1133..112266.. sshhooww//wwwwvv ((00)) sshhooww//wwwwvv Show the last 10 WWV broadcasts sshhooww//wwwwvv <> Show the last WWV broadcasts @@ -5151,7 +5217,7 @@ - 1133..112266.. sshhuuttddoowwnn ((55)) + 1133..112277.. sshhuuttddoowwnn ((55)) sshhuuttddoowwnn Shutdown the cluster @@ -5160,7 +5226,7 @@ set to respawn in /etc/inittab it will of course restart. - 1133..112277.. ssppooooff ((99)) + 1133..112288.. ssppooooff ((99)) ssppooooff <> <> Run commands as another user @@ -5171,7 +5237,7 @@ like home_node for example. - 1133..112288.. ssttaatt//ddbb ((55)) + 1133..112299.. ssttaatt//ddbb ((55)) ssttaatt//ddbb <> Show the status of a database @@ -5183,7 +5249,7 @@ other than a sysop. - 1133..112299.. ssttaatt//cchhaannnneell ((55)) + 1133..113300.. ssttaatt//cchhaannnneell ((55)) ssttaatt//cchhaannnneell <> Show the status of a channel on the cluster @@ -5194,7 +5260,7 @@ Only the fields that are defined (in perl term) will be displayed. - 1133..113300.. ssttaatt//mmssgg ((55)) + 1133..113311.. ssttaatt//mmssgg ((55)) ssttaatt//mmssgg <> Show the status of a message @@ -5204,7 +5270,7 @@ etc etc. - 1133..113311.. ssttaatt//uusseerr ((55)) + 1133..113322.. ssttaatt//uusseerr ((55)) ssttaatt//uusseerr <> Show the full status of a user @@ -5215,7 +5281,7 @@ Only the fields that are defined (in perl term) will be displayed. - 1133..113322.. ssyyssoopp ((00)) + 1133..113333.. ssyyssoopp ((00)) ssyyssoopp Regain your privileges if you login remotely @@ -5257,7 +5323,7 @@ case sensitive. - 1133..113333.. ttaallkk ((00)) + 1133..113344.. ttaallkk ((00)) ttaallkk <> Enter talk mode with ttaallkk <> <> Send a text message to @@ -5308,7 +5374,7 @@ - 1133..113344.. ttyyppee ((00)) + 1133..113355.. ttyyppee ((00)) ttyyppee <>//<> Look at a file in one of the fileareas @@ -5328,7 +5394,7 @@ content. - 1133..113355.. wwhhoo ((00)) + 1133..113366.. wwhhoo ((00)) wwhhoo Show who is physically connected locally @@ -5337,7 +5403,7 @@ what sort of connection they have - 1133..113366.. wwxx ((00)) + 1133..113377.. wwxx ((00)) wwxx <> Send a weather message to local users wwxx ffuullll <> Send a weather message to all cluster users @@ -5348,7 +5414,7 @@ extreme that may indicate enhanced conditions - 1133..113377.. wwxx ((eennhhaanncceedd ffoorr ssyyssooppss)) ((55)) + 1133..113388.. wwxx ((eennhhaanncceedd ffoorr ssyyssooppss)) ((55)) wwxx ssyyssoopp <> Send a weather message to other clusters only