X-Git-Url: http://gb7djk.dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;f=txt%2Fadminmanual.txt;h=16c3e0de813ce54ce03cf22343830b38646e1890;hb=ab0ea211ea17085944f4ce2b0100932fa6af02c8;hp=c2a3f93c2ba789377c14dac178f32883e2ba88e9;hpb=6374fb31da62987e676244c38eb6cf73c81bf891;p=spider.git diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt index c2a3f93c..16c3e0de 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) - $Date$ $Revision$ + Version 1.47 (Revision 1.30), April 2001 A reference for SysOps of the DXSpider DXCluster program. ______________________________________________________________________ @@ -73,7 +73,7 @@ 1.5 Starting up for the first time 1.6 The Client program - 2. Quick installation guide + 2. Quick installation guide (Linux version) 3. Configuration @@ -251,42 +251,45 @@ 13.100 show/baddx (1) 13.101 show/badnode (6) 13.102 show/badspotter (1) - 13.103 show/date (0) - 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) + 13.103 show/configuration (0) + 13.104 show/configuration/node (0) + 13.105 show/connect (1) + 13.106 show/date (0) + 13.107 show/debug (9) + 13.108 show/dx (0) + 13.109 show/dxcc (0) + 13.110 show/files (0) + 13.111 show/filter (0) + 13.112 show/filter (extended for sysops) (5) + 13.113 show/hops (8) + 13.114 show/isolate (1) + 13.115 show/lockout (9) + 13.116 show/log (8) + 13.117 show/moon (0) + 13.118 show/muf (0) + 13.119 show/node (1) + 13.120 show/prefix (0) + 13.121 show/program (5) + 13.122 show/qra (0) + 13.123 show/qrz (0) + 13.124 show/route (0) + 13.125 show/satellite (0) + 13.126 show/sun (0) + 13.127 show/time (0) + 13.128 show/wcy (0) + 13.129 show/wwv (0) + 13.130 shutdown (5) + 13.131 spoof (9) + 13.132 stat/db (5) + 13.133 stat/channel (5) + 13.134 stat/msg (5) + 13.135 stat/user (5) + 13.136 sysop (0) + 13.137 talk (0) + 13.138 type (0) + 13.139 who (0) + 13.140 wx (0) + 13.141 wx (enhanced for sysops) (5) ______________________________________________________________________ @@ -327,7 +330,6 @@ +o Net-Telnet-3.02.tar.gz - +o Curses-1.05.tar.gz +o Time-HiRes-01.20.tar.gz @@ -392,9 +394,7 @@ If you do not have the command _g_r_o_u_p_a_d_d available to you simply add a line in /etc/group by hand. - - - # vi /etc/group (or your favorite editor) + # vi /etc/group (or your favorite editor) @@ -572,7 +572,7 @@ - 22.. QQuuiicckk iinnssttaallllaattiioonn gguuiiddee + 22.. QQuuiicckk iinnssttaallllaattiioonn gguuiiddee ((LLiinnuuxx vveerrssiioonn)) This section is designed for experienced Spider sysops who want to install Spider from scratch. It is simply a check list of things that @@ -685,7 +685,7 @@ For most purposes this is not desirable. The only time you probably will need this is when you need to allow other cluster nodes that are - using SSID's in. In this case it owuld probably be better to use the + using SSID's in. In this case it would probably be better to use the first example and then add a specific line for that node like this: @@ -711,7 +711,7 @@ - spdlogin 7300/tcp # spider anonymous login port + spdlogin 8000/tcp # spider anonymous login port @@ -755,7 +755,7 @@ - telnet localhost 7300 + telnet localhost 8000 @@ -766,8 +766,8 @@ 33..33.. SSeettttiinngg uupp tteellnneett ccoonnnneeccttss ((ffrroomm 11..4477 oonnwwaarrddss)) - From version 1.47 you can chose to allow the perl cluster.pl program - to allow connections direct (i.e. not via the /spider/src/client + From version 1.47 you can choose to allow the perl cluster.pl program + to allow connections directly (i.e. not via the /spider/src/client interface program). If you are using Windows then this is the only method available of allowing incoming telnet connections. @@ -786,12 +786,12 @@ to make the change happen... - Having done that then you need to copy the file - /spider/perl/Listeners.pm to /spider/local and then edit it. You will - need to uncomment the line containing "0.0.0.0" and select the correct - port to listen on. So that it looks like this:- + Having done that, you need to copy the file _/_s_p_i_d_e_r_/_p_e_r_l_/_L_i_s_t_e_n_e_r_s_._p_m + to _/_s_p_i_d_e_r_/_l_o_c_a_l and then edit it. You will need to uncomment the line + containing "0.0.0.0" and select the correct port to listen on. So that + it looks like this:- @listen = ( - ["0.0.0.0", 7300], + ["0.0.0.0", 8000], ); @@ -799,13 +799,13 @@ As standard, the listener will listen on all interfaces - simultaniously. If you require more control than this, you can specify - each interface individually:- + simultaneously. If you require more control than this, you can + specify each interface individually:- @listen = ( - ["gb7baa.dxcluster.net", 7300], + ["gb7baa.dxcluster.net", 8000], ["44.131.16.2", 6300], ); @@ -815,7 +815,7 @@ This will only be successful if the IP addresses on each interface are static. If you are using some kind of dynamic IP addressing then the - 'default' method is the only one which will work. + 'default' method is the only one that will work. Restart the cluster.pl program to enable the listener. @@ -824,7 +824,7 @@ One important difference with the internal listener is that no echoing is done by the cluster program. Users will need to set 'local-echo' on in their telnet clients if it isn't set automatically (as per the - standards). Needless to say this will probably only apply to Windows + standards). Needless to say this will probably only apply to Windows users. @@ -835,7 +835,7 @@ In order to enable access to an AGW Engine you need to copy - /spider/perl/AGWConnect.pm to /spider/local and edit it. Specifically + _/_s_p_i_d_e_r_/_p_e_r_l_/_A_G_W_C_o_n_n_e_c_t_._p_m to _/_s_p_i_d_e_r_/_l_o_c_a_l and edit it. Specifically you must:- @@ -4909,21 +4909,52 @@ SET/BADSPOTTER for more information. - 1133..110033.. sshhooww//ddaattee ((00)) + 1133..110033.. sshhooww//ccoonnffiigguurraattiioonn ((00)) + + sshhooww//ccoonnffiigguurraattiioonn [[<>]] Show all visible nodes and their users + + + This command allows you to see all the users that can be seen and the + nodes to which they are connected. With the optional _n_o_d_e, you can + specify a particular node to look at. + + This command is normally abbreviated to: sh/c + + BE WARNED: the list that is returned can be VERY long + + + 1133..110044.. sshhooww//ccoonnffiigguurraattiioonn//nnooddee ((00)) + + sshhooww//ccoonnffiigguurraattiioonn//nnooddee Show all the nodes connected + + + Show all the nodes connected locally and the nodes they have + connected. + + + 1133..110055.. sshhooww//ccoonnnneecctt ((11)) + + sshhooww//ccoonnnneecctt Show all the active connections + + + This command shows information on all the active connections known to + the node. This command gives slightly more information than WHO. + + + 1133..110066.. sshhooww//ddaattee ((00)) sshhooww//ddaattee [[<>||<>]] Show the local time This is very nearly the same as SHOW/TIME, the only difference the format of the date string if no arguments are given. - If no prefixes or callsigns are given then this command returns the local 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. - 1133..110044.. sshhooww//ddeebbuugg ((99)) + 1133..110077.. sshhooww//ddeebbuugg ((99)) sshhooww//ddeebbuugg Show what levels of debug you are logging @@ -4931,7 +4962,7 @@ The levels can be set with _s_e_t_/_d_e_b_u_g - 1133..110055.. sshhooww//ddxx ((00)) + 1133..110088.. sshhooww//ddxx ((00)) sshhooww//ddxx [[ooppttiioonnss]] interrogate the spot database @@ -4945,38 +4976,35 @@ + on - eg 160m 20m 2m 23cm 6mm + on - eg hf vhf uhf shf (see SHOW/BANDS) + - the number of spots you want + - - spot no spot no in + the selected list + - for a spotted callsign beginning with + * - for a spotted callsign ending in + ** - for a spotted callsign containing - on - eg 160m 20m 2m 23cm 6mm - on - eg hf vhf uhf shf (see SHOW/BANDS) - - - the number of spots you want - - - spot no spot no in - the selected list - - - for a spotted callsign beginning with - * - for a spotted callsign ending in - ** - for a spotted callsign containing + day - starting days ago + day - - days days ago - day - starting days ago - day - - days days ago + info - any spots containing in the info or remarks - info - any spots containing in the info or remarks + by - any spots spotted by (spotter + is the same). - by - any spots spotted by (spotter - is the same). + qsl - this automatically looks for any qsl info on the call + held in the spot database. - qsl - this automatically looks for any qsl info on the call - held in the spot database. + iota [] - If the iota island number is missing it will + look for the string iota and anything which looks like + an iota island number. If you specify then it will look + for that island. - iota [] - If the iota island number is missing it will - look for the string iota and anything which looks like - an iota island number. If you specify then it will look - for that island. - - qra [] - this will look for the specific locator if - you specify one or else anything that looks like a locator. + qra [] - this will look for the specific locator if + you specify one or else anything that looks like a locator. @@ -4986,19 +5014,19 @@ - SH/DX 9m0 - SH/DX on 20m info iota - SH/DX 9a on vhf day 30 - SH/DX rf1p qsl - SH/DX iota - SH/DX iota eu-064 - SH/DX qra jn86 + SH/DX 9m0 + SH/DX on 20m info iota + SH/DX 9a on vhf day 30 + SH/DX rf1p qsl + SH/DX iota + SH/DX iota eu-064 + SH/DX qra jn86 - 1133..110066.. sshhooww//ddxxcccc ((00)) + 1133..110099.. sshhooww//ddxxcccc ((00)) sshhooww//ddxxcccc <> Interrogate the spot database by country @@ -5012,16 +5040,14 @@ + SH/DXCC G + SH/DXCC W on 20m info iota - SH/DXCC G - SH/DXCC W on 20m info iota - - - 1133..110077.. sshhooww//ffiilleess ((00)) + 1133..111100.. sshhooww//ffiilleess ((00)) sshhooww//ffiilleess [[<> [[<>]]]] List the contents of a filearea @@ -5053,7 +5079,8 @@ See also TYPE - to see the contents of a file. - 1133..110088.. sshhooww//ffiilltteerr ((00)) + + 1133..111111.. sshhooww//ffiilltteerr ((00)) sshhooww//ffiilltteerr Show the filters you have set @@ -5062,7 +5089,7 @@ displays all the filters set - for all the various categories. - 1133..110099.. sshhooww//ffiilltteerr ((eexxtteennddeedd ffoorr ssyyssooppss)) ((55)) + 1133..111122.. sshhooww//ffiilltteerr ((eexxtteennddeedd ffoorr ssyyssooppss)) ((55)) sshhooww//ffiilltteerr <> Show the filters set by @@ -5070,7 +5097,7 @@ A sysop can look at any filters that have been set. - 1133..111100.. sshhooww//hhooppss ((88)) + 1133..111133.. sshhooww//hhooppss ((88)) sshhooww//hhooppss <> [[aannnn||ssppoottss||wwccyy||wwwwvv||]] Show the hop counts for a node @@ -5080,7 +5107,8 @@ which category you want to see. If you leave the category out then all the categories will be listed. - 1133..111111.. sshhooww//iissoollaattee ((11)) + + 1133..111144.. sshhooww//iissoollaattee ((11)) sshhooww//iissoollaattee Show a list of isolated nodes @@ -5088,7 +5116,7 @@ Show which nodes are currently set to be isolated. - 1133..111122.. sshhooww//lloocckkoouutt ((99)) + 1133..111155.. sshhooww//lloocckkoouutt ((99)) sshhooww//lloocckkoouutt Show a list of excluded callsigns @@ -5097,7 +5125,7 @@ cluster locally with the _s_e_t_/_l_o_c_k_o_u_t command - 1133..111133.. sshhooww//lloogg ((88)) + 1133..111166.. sshhooww//lloogg ((88)) sshhooww//lloogg [[<>]] Show excerpts from the system log @@ -5107,7 +5135,7 @@ show output from the log associated with that callsign. - 1133..111144.. sshhooww//mmoooonn ((00)) + 1133..111177.. sshhooww//mmoooonn ((00)) sshhooww//mmoooonn [[<>||<>]] Show moon rise and set times @@ -5137,7 +5165,7 @@ - 1133..111155.. sshhooww//mmuuff ((00)) + 1133..111188.. sshhooww//mmuuff ((00)) sshhooww//mmuuff <> [[<>]][[lloonngg]] Show the likely propagation to @@ -5184,9 +5212,6 @@ SH/MUF W - - - produces: @@ -5212,6 +5237,9 @@ SH/MUF W 24 + + + will get you the above display, but with the next 24 hours worth of propagation data. @@ -5228,7 +5256,7 @@ terrible accurate, but it is included for completeness. - 1133..111166.. sshhooww//nnooddee ((11)) + 1133..111199.. sshhooww//nnooddee ((11)) sshhooww//nnooddee [[<> ......]] Show the type and version number of nodes @@ -5238,7 +5266,7 @@ the non-user callsigns known to the system will be displayed. - 1133..111177.. sshhooww//pprreeffiixx ((00)) + 1133..112200.. sshhooww//pprreeffiixx ((00)) sshhooww//pprreeffiixx <> Interrogate the prefix database @@ -5250,9 +5278,7 @@ See also SHOW/DXCC - - - 1133..111188.. sshhooww//pprrooggrraamm ((55)) + 1133..112211.. sshhooww//pprrooggrraamm ((55)) sshhooww//pprrooggrraamm Show the locations of all the included program modules @@ -5262,7 +5288,7 @@ from. - 1133..111199.. sshhooww//qqrraa ((00)) + 1133..112222.. sshhooww//qqrraa ((00)) sshhooww//qqrraa <> [[<>]] Show the distance between locators sshhooww//qqrraa <> <> Convert latitude and longitude to a locator @@ -5278,6 +5304,9 @@ SH/QRA IO92QL SH/QRA JN06 IN73 + + + The first example will show the distance and bearing to the locator from yourself, the second example will calculate the distance and bearing from the first locator to the second. You can use 4 or 6 @@ -5295,7 +5324,7 @@ - 1133..112200.. sshhooww//qqrrzz ((00)) + 1133..112233.. sshhooww//qqrrzz ((00)) sshhooww//qqrrzz <> Show any callbook details on a callsign @@ -5305,7 +5334,7 @@ provided for users of this software by http://www.qrz.com - 1133..112211.. sshhooww//rroouuttee ((00)) + 1133..112244.. sshhooww//rroouuttee ((00)) sshhooww//rroouuttee <> Show the route to @@ -5315,13 +5344,13 @@ - sh/route n2tly + sh/route n2tly - 1133..112222.. sshhooww//ssaatteelllliittee ((00)) + 1133..112255.. sshhooww//ssaatteelllliittee ((00)) sshhooww//ssaatteelllliittee <> [[<> <>]] Show satellite tracking data @@ -5343,7 +5372,6 @@ Each pass in a period is separated with a row of '-----' characters - So for example:- @@ -5355,7 +5383,7 @@ - 1133..112233.. sshhooww//ssuunn ((00)) + 1133..112266.. sshhooww//ssuunn ((00)) sshhooww//ssuunn [[<>||<>]] Show sun rise and set times @@ -5382,7 +5410,7 @@ - 1133..112244.. sshhooww//ttiimmee ((00)) + 1133..112277.. sshhooww//ttiimmee ((00)) sshhooww//ttiimmee [[<>||<>]] Show the local time @@ -5393,7 +5421,7 @@ including DST) at the prefixes or callsigns that you specify. - 1133..112255.. sshhooww//wwccyy ((00)) + 1133..112288.. sshhooww//wwccyy ((00)) sshhooww//wwccyy Show the last 10 WCY broadcasts sshhooww//wwccyy <> Show the last WCY broadcasts @@ -5403,19 +5431,18 @@ system - 1133..112266.. sshhooww//wwwwvv ((00)) + 1133..112299.. sshhooww//wwwwvv ((00)) sshhooww//wwwwvv Show the last 10 WWV broadcasts sshhooww//wwwwvv <> Show the last WWV broadcasts - Display the most recent WWV information that has been received by the system - 1133..112277.. sshhuuttddoowwnn ((55)) + 1133..113300.. sshhuuttddoowwnn ((55)) sshhuuttddoowwnn Shutdown the cluster @@ -5424,7 +5451,7 @@ set to respawn in /etc/inittab it will of course restart. - 1133..112288.. ssppooooff ((99)) + 1133..113311.. ssppooooff ((99)) ssppooooff <> <> Run commands as another user @@ -5435,7 +5462,7 @@ like home_node for example. - 1133..112299.. ssttaatt//ddbb ((55)) + 1133..113322.. ssttaatt//ddbb ((55)) ssttaatt//ddbb <> Show the status of a database @@ -5447,7 +5474,9 @@ other than a sysop. - 1133..113300.. ssttaatt//cchhaannnneell ((55)) + + + 1133..113333.. ssttaatt//cchhaannnneell ((55)) ssttaatt//cchhaannnneell <> Show the status of a channel on the cluster @@ -5458,7 +5487,7 @@ Only the fields that are defined (in perl term) will be displayed. - 1133..113311.. ssttaatt//mmssgg ((55)) + 1133..113344.. ssttaatt//mmssgg ((55)) ssttaatt//mmssgg <> Show the status of a message @@ -5468,7 +5497,7 @@ etc etc. - 1133..113322.. ssttaatt//uusseerr ((55)) + 1133..113355.. ssttaatt//uusseerr ((55)) ssttaatt//uusseerr <> Show the full status of a user @@ -5479,7 +5508,7 @@ Only the fields that are defined (in perl term) will be displayed. - 1133..113333.. ssyyssoopp ((00)) + 1133..113366.. ssyyssoopp ((00)) ssyyssoopp Regain your privileges if you login remotely @@ -5513,15 +5542,12 @@ or 2 0 5 7 3 or 20573 - - - They will all match. If there is no password you will still be offered numbers but nothing will happen when you input a string. Any match is case sensitive. - 1133..113344.. ttaallkk ((00)) + 1133..113377.. ttaallkk ((00)) ttaallkk <> Enter talk mode with ttaallkk <> <> Send a text message to @@ -5572,7 +5598,7 @@ - 1133..113355.. ttyyppee ((00)) + 1133..113388.. ttyyppee ((00)) ttyyppee <>//<> Look at a file in one of the fileareas @@ -5582,7 +5608,6 @@ enter:- - TYPE bulletins/arld051 @@ -5592,7 +5617,7 @@ content. - 1133..113366.. wwhhoo ((00)) + 1133..113399.. wwhhoo ((00)) wwhhoo Show who is physically connected locally @@ -5601,18 +5626,17 @@ what sort of connection they have - 1133..113377.. wwxx ((00)) + 1133..114400.. wwxx ((00)) wwxx <> Send a weather message to local users wwxx ffuullll <> Send a weather message to all cluster users - Weather messages can sometimes be useful if you are experiencing an extreme that may indicate enhanced conditions - 1133..113388.. wwxx ((eennhhaanncceedd ffoorr ssyyssooppss)) ((55)) + 1133..114411.. wwxx ((eennhhaanncceedd ffoorr ssyyssooppss)) ((55)) wwxx ssyyssoopp <> Send a weather message to other clusters only @@ -5639,30 +5663,6 @@ - - - - - - - - - - - - - - - - - - - - - - - -