From 59e40dfc42f6e9046859fa66ff6465417e4f1750 Mon Sep 17 00:00:00 2001 From: g0vgs Date: Wed, 24 Jan 2001 21:19:06 +0000 Subject: [PATCH] Changes to Manual --- html/adminmanual-1.html | 2 +- html/adminmanual-9.html | 12 ++ html/adminmanual.html | 3 +- txt/adminmanual.txt | 288 ++++++++++++++++++++-------------------- 4 files changed, 159 insertions(+), 146 deletions(-) diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html index a6f97675..a6d6da64 100644 --- a/html/adminmanual-1.html +++ b/html/adminmanual-1.html @@ -15,7 +15,7 @@ Previous

1. Installation (Original version by Iain Phillips, G0RDI)

-

Last modified: 13 January 2001 by Ian Maude, G0VGS +

Last modified: 24 January 2001 by Ian Maude, G0VGS

1.1 Introduction

diff --git a/html/adminmanual-9.html b/html/adminmanual-9.html index 508d1d32..6f0d0ef6 100644 --- a/html/adminmanual-9.html +++ b/html/adminmanual-9.html @@ -382,6 +382,18 @@ announces etc. To use this program, simply use console.pl instead of client.pl.

To edit the colours, copy /spider/perl/Console.pl to /spider/local and edit the file with your favourite editor.

+

9.8 BBS interface +

+ +

Spider provides a simple BBS interface. No input is required from the sysop +of the cluster at all. The BBS simply sets the cluster as a BBS and pushes +any required mail to the cluster. No mail can flow from Spider to the BBS, +the interface is one-way. +

+

Please be careful not to flood the cluster network with unnecessary mail. +Make sure you only send mail to the clusters that want it by using the +Forward.pl file very carefully. +

Next Previous diff --git a/html/adminmanual.html b/html/adminmanual.html index 1591e164..66ff522c 100644 --- a/html/adminmanual.html +++ b/html/adminmanual.html @@ -15,7 +15,7 @@ Contents

The DXSpider Installation and Administration Manual

-

Ian Maude, G0VGS, (ianmaude@btinternet.com)

Version 1.29 January 2001 +

Ian Maude, G0VGS, (ianmaude@btinternet.com)

Version 1.30 January 2001

A reference for SysOps of the DXSpider DXCluster program.
@@ -94,6 +94,7 @@ Contents
  • 9.5 Forward.pl
  • 9.6 Distribution lists
  • 9.7 Console.pl +
  • 9.8 BBS interface

    10. CVS

    diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt index 7cfbf61d..2fe1ffcc 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.29 January 2001 + Version 1.30 January 2001 A reference for SysOps of the DXSpider DXCluster program. ______________________________________________________________________ @@ -122,6 +122,7 @@ 9.5 Forward.pl 9.6 Distribution lists 9.7 Console.pl + 9.8 BBS interface 10. CVS @@ -269,7 +270,7 @@ 11.. IInnssttaallllaattiioonn ((OOrriiggiinnaall vveerrssiioonn bbyy IIaaiinn PPhhiilllliippss,, GG00RRDDII)) - Last modified: 13 January 2001 by Ian Maude, G0VGS + Last modified: 24 January 2001 by Ian Maude, G0VGS 11..11.. IInnttrroodduuccttiioonn @@ -327,7 +328,6 @@ version 1.35 for this section but of course you would use the latest version. - Login as root and create a user to run the cluster under. _U_N_D_E_R _N_O _C_I_R_C_U_M_S_T_A_N_C_E_S _U_S_E _R_O_O_T _A_S _T_H_I_S _U_S_E_R_!. I am going to use the name _s_y_s_o_p. You can call it anything you wish. Depending on your security @@ -2281,6 +2281,19 @@ edit the file with your favourite editor. + 99..88.. BBBBSS iinntteerrffaaccee + + Spider provides a simple BBS interface. No input is required from the + sysop of the cluster at all. The BBS simply sets the cluster as a BBS + and pushes any required mail to the cluster. No mail can flow from + Spider to the BBS, the interface is one-way. + + + Please be careful not to flood the cluster network with unnecessary + mail. Make sure you only send mail to the clusters that want it by + using the Forward.pl file very carefully. + + 1100.. CCVVSS CVS stands for "Concurrent Versions System" and the CVS for DXSpider @@ -2307,7 +2320,6 @@ ENTIRE SPIDER TREE!! - Assuming you are connected to the Internet, you need to login to the CVS repository and then update your Spider source. There are several steps which are listed below ... @@ -2360,9 +2372,11 @@ - tar cvfz /tmp/s.tgz spider - cd / - tar xvfzp /tmp/s.tgz + + + tar cvfz /tmp/s.tgz spider + cd / + tar xvfzp /tmp/s.tgz @@ -2425,33 +2439,23 @@ read this to understand how filters work - it will save a lot of grief later on. - You can use any of the following things in this line:- - - - - - - - - - - + You can use any of the following things in this line:- - info eg: iota or qsl - by eg: G,M,2 - origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone - channel - wx 1 filter WX announces - dest eg: 6MUK,WDX (distros) + info eg: iota or qsl + by eg: G,M,2 + origin + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu + origin_zone + by_dxcc + by_itu + by_zone + channel + wx 1 filter WX announces + dest eg: 6MUK,WDX (distros) @@ -2500,9 +2504,13 @@ - accept/ann by G,M,2 - accept/ann input node_default by G,M,2 - accept/ann user_default by G,M,2 + + + accept/ann by G,M,2 + accept/ann input node_default by G,M,2 + accept/ann user_default by G,M,2 + + @@ -2564,7 +2572,6 @@ - but this probably for advanced users... @@ -2572,6 +2579,7 @@ aacccceepptt//ssppoottss <> [[iinnppuutt]] [[00--99]] <> Spot filter sysop version + This version allows a sysop to set a filter for a callsign as well as the default for nodes and users eg:- @@ -2630,9 +2638,8 @@ - accept/wcy node_default all - set/hops node_default 10 - + accept/wcy node_default all + set/hops node_default 10 @@ -2696,6 +2703,7 @@ + 1111..99.. aannnnoouunnccee ((00)) aannnnoouunnccee <> Send an announcement to local users @@ -2704,6 +2712,7 @@ Send an announcement to LOCAL users only, where is the text of the announcement you wish to broadcast + 1111..1100.. aannnnoouunnccee ffuullll ((00)) aannnnoouunnccee ffuullll <> Send an announcement cluster wide @@ -2761,15 +2770,12 @@ and to undo what you have just done:- - - uncatchup GB7DJK all uncatchup GB7DJK 300 301 302 303 500-510 - which will arrange for them to be forward candidates again. Order is not important. @@ -2829,6 +2835,7 @@ ccoonnnneecctt <> Start a connection to another DX Cluster + Start a connection process that will culminate in a new connection to the DX cluster . This process creates a new 'client' process which will use the script in /spider/connect/ to effect the @@ -2893,13 +2900,17 @@ - 's' => [ - .. - .. - '^sh\w*/buc', 'dbshow buckmaster', 'dbshow', - .. - .. - ], + + + 's' => [ + .. + .. + '^sh\w*/buc', 'dbshow buckmaster', 'dbshow', + .. + .. + ], + + to allow @@ -2956,6 +2967,7 @@ ddbbsshhooww <> <> Display an entry, if it exists, in a database + This is the generic user interface to the database to the database system. It is expected that the sysop will add an entry to the local Aliases file so that users can use the more familiar AK1A style of @@ -3022,7 +3034,6 @@ You can combine some of the various directory commands together eg:- - DIR TO G1TLH 5 or DIR SUBJECT IOTA 200-250 @@ -3034,6 +3045,7 @@ syntax:- + DIR/T G1* 10 DIR/S QSL 10-100 5 @@ -3087,7 +3099,8 @@ - DX by G1TLH FR0G 144.600 he isn't on the cluster + + DX by G1TLH FR0G 144.600 he isn't on the cluster @@ -3100,6 +3113,7 @@ eexxppoorrtt <> <> Export a message to a file + Export a message to a file. This command can only be executed on a local console with a fully privileged user. The file produced will be in a form ready to be imported back into the cluster by placing it in @@ -3166,6 +3180,8 @@ Look at the APROPOS command which will search the help database for the you specify and give you a list of likely commands to look at with HELP. + + 1111..3322.. iinniitt ((55)) iinniitt <> Re-initialise a link to an AK1A compatible node @@ -3214,6 +3230,8 @@ same subject will be deleted. Beware! + + 1111..3366.. lliinnkkss ((00)) lliinnkkss Show which nodes are physically connected @@ -3232,6 +3250,9 @@ Reload the /spider/cmd/Aliases file after you have editted it. You will need to do this if you change this file whilst the cluster is running in order for the changes to take effect. + + + 1111..3388.. llooaadd//bbaaddddxx ((99)) llooaadd//bbaaddddxx Reload the bad DX table @@ -3343,9 +3364,6 @@ Alter message parameters like To, From, Subject, whether private or bulletin or return receipt (RR) is required or whether to keep this message from timing out. - - - MSG TO - change TO callsign to MSG FRom - change FROM callsign to MSG PRrivate - set private flag @@ -3411,6 +3429,7 @@ This command allows you to send nearly any command to another DX Cluster node that is connected to the system. + Whether you get any output is dependant on a) whether the other system knows that the node callsign of this cluster is in fact a node b) whether the other system is allowing RCMDs from this node and c) @@ -3428,8 +3447,6 @@ - - 1111..5522.. rreeaadd ((eexxtteennddeedd ffoorr ssyyssooppss)) ((55)) rreeaadd <> Read a message on the system @@ -3496,6 +3513,7 @@ rreejjeecctt//aannnnoouunnccee <> [[iinnppuutt]] [[00--99]] <> Announce filter sysop version + This version allows a sysop to set a filter for a callsign as well as the default for nodes and users eg:- @@ -3562,7 +3580,7 @@ - rej/spot 3 all + rej/spot 3 all @@ -3601,15 +3619,24 @@ - by eg: G,M,2 - origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone - channel + + + + + + + + + + by eg: G,M,2 + origin + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu + origin_zone + by_dxcc + by_itu + by_zone + channel @@ -3628,6 +3655,7 @@ rreejjeecctt//wwccyy <> [[iinnppuutt]] [[00--99]] <> WCY reject filter sysop version + This version allows a sysop to set a filter for a callsign as well as the default for nodes and users eg:- @@ -3692,8 +3720,6 @@ - - 1111..6611.. rreeppllyy ((00)) rreeppllyy Reply (privately) to the last message that you have read @@ -3733,7 +3759,8 @@ - SEND RR COPY 123 PRIVATE G1TLH G0RDI + + SEND RR COPY 123 PRIVATE G1TLH G0RDI @@ -3760,6 +3787,7 @@ Allow announce messages to arrive at your terminal. + 1111..6655.. sseett//aarrcclluusstteerr ((55)) sseett//aarrcclluusstteerr <> [[<> ......]] Make the node_call an AR- @@ -3864,8 +3892,6 @@ Use with extreme care. This command may well be superceded by FILTERing. - - 1111..6699.. sseett//bbeeeepp ((00)) sseett//bbeeeepp Add beeps to terminal messages @@ -3891,7 +3917,6 @@ You can remove this level with unset/debug - 1111..7722.. sseett//ddxx ((00)) sseett//ddxxAllow DX messages to arrive at your terminal @@ -3958,7 +3983,7 @@ - SET/HOMENODE gb7djk + SET/HOMENODE gb7djk @@ -4024,7 +4049,7 @@ - set/location 54 04 N 2 02 E + set/location 54 04 N 2 02 E @@ -4064,6 +4089,7 @@ sseett//lloocckkoouutt <> Stop a callsign connecting to the cluster + You can show who is locked out with the _s_h_o_w_/_l_o_c_k_o_u_t command. To allow the user to connect again, use the _u_n_s_e_t_/_l_o_c_k_o_u_t command. @@ -4090,6 +4116,7 @@ Tell the system that the call(s) are to be treated as AK1A cluster and fed PC Protocol rather normal user commands. + From version 1.41 you can also set the following types of cluster @@ -4126,6 +4153,9 @@ minutes, it is disconnected. + + + 1111..8888.. sseett//ppaaggee ((00)) sseett//ppaaggee <> Set the number of lines per page @@ -4191,13 +4221,14 @@ - 0 - normal user - 1 - allow remote nodes normal user RCMDs - 5 - various privileged commands (including shutdown, but not disc- - connect), the normal level for another node. - 8 - more privileged commands (including disconnect) - 9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS - LEVEL. + + 0 - normal user + 1 - allow remote nodes normal user RCMDs + 5 - various privileged commands (including shutdown, but not disc- + connect), the normal level for another node. + 8 - more privileged commands (including disconnect) + 9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS + LEVEL. @@ -4220,8 +4251,6 @@ sseett//ssyyss__qqrraa <> Set your cluster QRA locator - - 1111..9944.. sseett//qqrraa ((00)) sseett//qqrraa <> Set your QRA locator @@ -4288,6 +4317,8 @@ Allow WX information to be seen at your console. You can switch off WX messages with the _u_n_s_e_t_/_w_x command. + + 1111..110000.. sshhooww//bbaaddddxx ((11)) sshhooww//bbaaddddxxShow all the bad dx calls in the system @@ -4343,46 +4374,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 + day - starting days ago + day - - days days ago + info - any spots containing in the info or remarks + 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. + 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. - - - - 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 - - info - any spots containing in the info or remarks - - 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. - - 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. @@ -4400,10 +4420,6 @@ SH/DX iota eu-064 SH/DX qra jn86 - - - - 1111..110055.. sshhooww//ddxxcccc ((00)) sshhooww//ddxxcccc <> Interrogate the spot database by country @@ -4418,10 +4434,8 @@ - - - SH/DXCC G - SH/DXCC W on 20m info iota + SH/DXCC G + SH/DXCC W on 20m info iota @@ -4472,7 +4486,6 @@ sshhooww//ffiilltteerr <> Show the filters set by - A sysop can look at any filters that have been set. @@ -4486,6 +4499,7 @@ which category you want to see. If you leave the category out then all the categories will be listed. + 1111..111100.. sshhooww//iissoollaattee ((11)) sshhooww//iissoollaattee Show a list of isolated nodes @@ -4538,7 +4552,6 @@ sshhooww//mmuuff <> [[<>]][[lloonngg]] Show the likely propagation to - This command allow you to estimate the likelihood of you contacting a station with the prefix you have specified. The output assumes a modest power of 20dBW and receiver sensitivity of -123dBm (about @@ -4605,7 +4618,6 @@ inputing:- - SH/MUF W 24 @@ -4616,10 +4628,8 @@ - - - SH/MUF W L 24 - SH/MUF W 24 Long + SH/MUF W L 24 + SH/MUF W 24 Long @@ -4674,8 +4684,6 @@ given on the command line) the distance and beraing from your station to the locator. For example:- - - SH/QRA IO92QL SH/QRA JN06 IN73 @@ -4750,6 +4758,7 @@ So for example:- + SH/SAT AO-10 SH/SAT FENGYUN1 12 2 @@ -4805,6 +4814,8 @@ system + + 1111..112244.. sshhooww//wwwwvv ((00)) sshhooww//wwwwvv Show the last 10 WWV broadcasts @@ -4869,6 +4880,8 @@ etc etc. + + 1111..113300.. ssttaatt//uusseerr ((55)) ssttaatt//uusseerr <> Show the full status of a user @@ -4880,8 +4893,6 @@ Only the fields that are defined (in perl term) will be displayed. - - 1111..113311.. ssyyssoopp ((00)) ssyyssoopp Regain your privileges if you login remotely @@ -4936,6 +4947,7 @@ cluster system. You can send it to anyone you can see with a SHOW/CONFIGURATION command, they don't have to be connected locally. + The second form of TALK is used when other cluster nodes are connected with restricted information. This usually means that they don't send the user information usually associated with logging on and off the @@ -5002,8 +5014,6 @@ This is a quick listing that shows which callsigns are connected and what sort of connection they have - - 1111..113355.. wwxx ((00)) wwxx <> Send a weather message to local users @@ -5060,16 +5070,6 @@ - - - - - - - - - - -- 2.34.1