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.
______________________________________________________________________
9.5 Forward.pl
9.6 Distribution lists
9.7 Console.pl
+ 9.8 BBS interface
10. CVS
1\b1.\b. I\bIn\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn (\b(O\bOr\bri\big\bgi\bin\bna\bal\bl v\bve\ber\brs\bsi\bio\bon\bn b\bby\by I\bIa\bai\bin\bn P\bPh\bhi\bil\bll\bli\bip\bps\bs,\b, G\bG0\b0R\bRD\bDI\bI)\b)
- Last modified: 13 January 2001 by Ian Maude, G0VGS
+ Last modified: 24 January 2001 by Ian Maude, G0VGS
1\b1.\b.1\b1.\b. I\bIn\bnt\btr\bro\bod\bdu\buc\bct\bti\bio\bon\bn
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. _\bU_\bN_\bD_\bE_\bR _\bN_\bO
_\bC_\bI_\bR_\bC_\bU_\bM_\bS_\bT_\bA_\bN_\bC_\bE_\bS _\bU_\bS_\bE _\bR_\bO_\bO_\bT _\bA_\bS _\bT_\bH_\bI_\bS _\bU_\bS_\bE_\bR_\b!. I am going to use the name
_\bs_\by_\bs_\bo_\bp. You can call it anything you wish. Depending on your security
edit the file with your favourite editor.
+ 9\b9.\b.8\b8.\b. B\bBB\bBS\bS i\bin\bnt\bte\ber\brf\bfa\bac\bce\be
+
+ 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.
+
+
1\b10\b0.\b. C\bCV\bVS\bS
CVS stands for "Concurrent Versions System" and the CVS for DXSpider
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 ...
- tar cvfz /tmp/s.tgz spider
- cd /
- tar xvfzp /tmp/s.tgz
+
+
+ tar cvfz /tmp/s.tgz spider
+ cd /
+ tar xvfzp /tmp/s.tgz
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 <string> eg: iota or qsl
- by <prefixes> eg: G,M,2
- origin <prefixes>
- origin_dxcc <numbers> eg: 61,62 (from eg: sh/pre G)
- origin_itu <numbers>
- origin_zone <numbers>
- by_dxcc <numbers>
- by_itu <numbers>
- by_zone <numbers>
- channel <prefixes>
- wx 1 filter WX announces
- dest <prefixes> eg: 6MUK,WDX (distros)
+ info <string> eg: iota or qsl
+
by <prefixes> eg: G,M,2
+ origin_dxcc <numbers> eg: 61,62 (from eg: sh/pre G)
+ origin_itu <numbers>
+ origin_zone <numbers>
+ by_dxcc <numbers>
+ by_itu <numbers>
+ by_zone <numbers>
+ wx 1 filter WX announces
+
dest <prefixes> eg: 6MUK,WDX (distros)
- 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
+
+
-
but this probably for advanced users...
a
\bac
\bcc
\bce
\bep
\bpt
\bt/
\b/s
\bsp
\bpo
\bot
\bts
\bs <
\b<c
\bca
\bal
\bll
\bl>
\b> [
\b[i
\bin
\bnp
\bpu
\but
\bt]
\b] [
\b[0
\b0-
\b-9
\b9]
\b] <
\b<p
\bpa
\bat
\btt
\bte
\ber
\brn
\bn>
\b> 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:-
- accept/wcy node_default all
- set/hops node_default 10
-
+ accept/wcy node_default all
+ set/hops node_default 10
+
1\b11\b1.\b.9\b9.\b. a\ban\bnn\bno\bou\bun\bnc\bce\be (\b(0\b0)\b)
a\ban\bnn\bno\bou\bun\bnc\bce\be <\b<t\bte\bex\bxt\bt>\b> Send an announcement to local users
Send an announcement to LOCAL users only, where <text> is the text of
the announcement you wish to broadcast
+
1\b11\b1.\b.1\b10\b0.\b. a\ban\bnn\bno\bou\bun\bnc\bce\be f\bfu\bul\bll\bl (\b(0\b0)\b)
a\ban\bnn\bno\bou\bun\bnc\bce\be f\bfu\bul\bll\bl <\b<t\bte\bex\bxt\bt>\b> Send an announcement cluster wide
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.
c\bco\bon\bnn\bne\bec\bct\bt <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Start a connection to another DX Cluster
+
Start a connection process that will culminate in a new connection to
the DX cluster <callsign>. This process creates a new 'client' process
which will use the script in /spider/connect/<callsign> to effect the
- 's' => [
- ..
- ..
- '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
- ..
- ..
- ],
+
+
+ 's' => [
+ ..
+ ..
+ '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
+ ..
+ ..
+ ],
+
+
to allow
d\bdb\bbs\bsh\bho\bow\bw <\b<d\bdb\bbn\bna\bam\bme\be>\b> <\b<k\bke\bey\by>\b> 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
You can combine some of the various directory commands together eg:-
-
DIR TO G1TLH 5
or
DIR SUBJECT IOTA 200-250
syntax:-
+
DIR/T G1* 10
DIR/S QSL 10-100 5
- DX by G1TLH FR0G 144.600 he isn't on the cluster
+
+ DX by G1TLH FR0G 144.600 he isn't on the cluster
e\bex\bxp\bpo\bor\brt\bt <\b<m\bms\bsg\bgn\bno\bo>\b> <\b<f\bfi\bil\ble\ben\bna\bam\bme\be>\b> 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
Look at the APROPOS <string> command which will search the help
database for the <string> you specify and give you a list of likely
commands to look at with HELP.
+
+
1\b11\b1.\b.3\b32\b2.\b. i\bin\bni\bit\bt (\b(5\b5)\b)
i\bin\bni\bit\bt <\b<n\bno\bod\bde\be c\bca\bal\bll\bl>\b> Re-initialise a link to an AK1A compatible node
same subject will be deleted. Beware!
+
+
1\b11\b1.\b.3\b36\b6.\b. l\bli\bin\bnk\bks\bs (\b(0\b0)\b)
l\bli\bin\bnk\bks\bs Show which nodes are physically connected
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.
+
+
+
1\b11\b1.\b.3\b38\b8.\b. l\blo\boa\bad\bd/\b/b\bba\bad\bdd\bdx\bx (\b(9\b9)\b)
l\blo\boa\bad\bd/\b/b\bba\bad\bdd\bdx\bx Reload the bad DX table
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 <msgno> <call> - change TO callsign to <call>
MSG FRom <msgno> <call> - change FROM callsign to <call>
MSG PRrivate <msgno> - set private flag
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)
-
-
1\b11\b1.\b.5\b52\b2.\b. r\bre\bea\bad\bd (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(5\b5)\b)
r\bre\bea\bad\bd <\b<m\bms\bsg\bgn\bno\bo>\b> Read a message on the system
r
\bre
\bej
\bje
\bec
\bct
\bt/
\b/a
\ban
\bnn
\bno
\bou
\bun
\bnc
\bce
\be <
\b<c
\bca
\bal
\bll
\bl>
\b> [
\b[i
\bin
\bnp
\bpu
\but
\bt]
\b] [
\b[0
\b0-
\b-9
\b9]
\b] <
\b<p
\bpa
\bat
\btt
\bte
\ber
\brn
\bn>
\b> 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:-
- rej/spot 3 all
+ rej/spot 3 all
- by <prefixes> eg: G,M,2
- origin <prefixes>
- origin_dxcc <numbers> eg: 61,62 (from eg: sh/pre G)
- origin_itu <numbers>
- origin_zone <numbers>
- by_dxcc <numbers>
- by_itu <numbers>
- by_zone <numbers>
- channel <prefixes>
+
+
+
+
+
+
+
+
+
+ by <prefixes> eg: G,M,2
+ origin <prefixes>
+ origin_dxcc <numbers> eg: 61,62 (from eg: sh/pre G)
+ origin_itu <numbers>
+ origin_zone <numbers>
+ by_dxcc <numbers>
+ by_itu <numbers>
+ by_zone <numbers>
+ channel <prefixes>
r
\bre
\bej
\bje
\bec
\bct
\bt/
\b/w
\bwc
\bcy
\by <
\b<c
\bca
\bal
\bll
\bl>
\b> [
\b[i
\bin
\bnp
\bpu
\but
\bt]
\b] [
\b[0
\b0-
\b-9
\b9]
\b] <
\b<p
\bpa
\bat
\btt
\bte
\ber
\brn
\bn>
\b> 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:-
-
-
1\b11\b1.\b.6\b61\b1.\b. r\bre\bep\bpl\bly\by (\b(0\b0)\b)
r\bre\bep\bpl\bly\by Reply (privately) to the last message that you have read
- SEND RR COPY 123 PRIVATE G1TLH G0RDI
+
+ SEND RR COPY 123 PRIVATE G1TLH G0RDI
Allow announce messages to arrive at your terminal.
+
1\b11\b1.\b.6\b65\b5.\b. s\bse\bet\bt/\b/a\bar\brc\bcl\blu\bus\bst\bte\ber\br (\b(5\b5)\b)
s\bse\bet\bt/\b/a\bar\brc\bcl\blu\bus\bst\bte\ber\br <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[<\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Make the node_call an AR-
Use with extreme care. This command may well be superceded by
FILTERing.
-
-
1\b11\b1.\b.6\b69\b9.\b. s\bse\bet\bt/\b/b\bbe\bee\bep\bp (\b(0\b0)\b)
s\bse\bet\bt/\b/b\bbe\bee\bep\bp Add beeps to terminal messages
You can remove this level with unset/debug <name>
-
1\b11\b1.\b.7\b72\b2.\b. s\bse\bet\bt/\b/d\bdx\bx (\b(0\b0)\b)
s\bse\bet\bt/\b/d\bdx\bxAllow DX messages to arrive at your terminal
- SET/HOMENODE gb7djk
+ SET/HOMENODE gb7djk
- set/location 54 04 N 2 02 E
+ set/location 54 04 N 2 02 E
s\bse\bet\bt/\b/l\blo\boc\bck\bko\bou\but\bt <\b<c\bca\bal\bll\bl>\b> Stop a callsign connecting to the cluster
+
You can show who is locked out with the _\bs_\bh_\bo_\bw_\b/_\bl_\bo_\bc_\bk_\bo_\bu_\bt command. To
allow the user to connect again, use the _\bu_\bn_\bs_\be_\bt_\b/_\bl_\bo_\bc_\bk_\bo_\bu_\bt command.
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
minutes, it is disconnected.
+
+
+
1\b11\b1.\b.8\b88\b8.\b. s\bse\bet\bt/\b/p\bpa\bag\bge\be (\b(0\b0)\b)
s\bse\bet\bt/\b/p\bpa\bag\bge\be <\b<n\bn>\b> Set the number of lines per page
- 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.
s\bse\bet\bt/\b/s\bsy\bys\bs_\b_q\bqr\bra\ba <\b<l\blo\boc\bca\bat\bto\bor\br>\b> Set your cluster QRA locator
-
-
1\b11\b1.\b.9\b94\b4.\b. s\bse\bet\bt/\b/q\bqr\bra\ba (\b(0\b0)\b)
s\bse\bet\bt/\b/q\bqr\bra\ba <\b<l\blo\boc\bca\bat\bto\bor\br>\b> Set your QRA locator
Allow WX information to be seen at your console. You can switch off
WX messages with the _\bu_\bn_\bs_\be_\bt_\b/_\bw_\bx command.
+
+
1\b11\b1.\b.1\b10\b00\b0.\b. s\bsh\bho\bow\bw/\b/b\bba\bad\bdd\bdx\bx (\b(1\b1)\b)
s\bsh\bho\bow\bw/\b/b\bba\bad\bdd\bdx\bxShow all the bad dx calls in the system
+ on <band> - eg 160m 20m 2m 23cm 6mm
+ on <region> - eg hf vhf uhf shf (see SHOW/BANDS)
+ <number> - the number of spots you want
+ <from>-<to> - <from> spot no <to> spot no in
+ the selected list
+ <prefix> - for a spotted callsign beginning with <prefix>
+ *<suffix> - for a spotted callsign ending in <suffix>
+ *<string>* - for a spotted callsign containing <string>
+ day <number> - starting <number> days ago
+ day <from>-<to> - <from> days <to> days ago
+ info <text> - any spots containing <text> in the info or remarks
+ by <call> - any spots spotted by <call> (spotter <call>
+ is the same).
+ qsl - this automatically looks for any qsl info on the call
+ held in the spot database.
+ iota [<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 <band> - eg 160m 20m 2m 23cm 6mm
- on <region> - eg hf vhf uhf shf (see SHOW/BANDS)
-
- <number> - the number of spots you want
- <from>-<to> - <from> spot no <to> spot no in
- the selected list
-
- <prefix> - for a spotted callsign beginning with <prefix>
- *<suffix> - for a spotted callsign ending in <suffix>
- *<string>* - for a spotted callsign containing <string>
-
- day <number> - starting <number> days ago
- day <from>-<to> - <from> days <to> days ago
-
- info <text> - any spots containing <text> in the info or remarks
-
- by <call> - any spots spotted by <call> (spotter <call>
- is the same).
-
- qsl - this automatically looks for any qsl info on the call
- held in the spot database.
-
- iota [<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 [<locator>] - this will look for the specific locator if
- you specify one or else anything that looks like a locator.
+ qra [<locator>] - this will look for the specific locator if
+ you specify one or else anything that looks like a locator.
SH/DX iota eu-064
SH/DX qra jn86
-
-
-
-
1\b11\b1.\b.1\b10\b05\b5.\b. s\bsh\bho\bow\bw/\b/d\bdx\bxc\bcc\bc (\b(0\b0)\b)
s
\bsh
\bho
\bow
\bw/
\b/d
\bdx
\bxc
\bcc
\bc <
\b<p
\bpr
\bre
\bef
\bfi
\bix
\bx>
\b> Interrogate the spot database by country
-
-
- SH/DXCC G
- SH/DXCC W on 20m info iota
+ SH/DXCC G
+ SH/DXCC W on 20m info iota
s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the filters set by <callsign>
-
A sysop can look at any filters that have been set.
which category you want to see. If you leave the category out then all
the categories will be listed.
+
1\b11\b1.\b.1\b11\b10\b0.\b. s\bsh\bho\bow\bw/\b/i\bis\bso\bol\bla\bat\bte\be (\b(1\b1)\b)
s\bsh\bho\bow\bw/\b/i\bis\bso\bol\bla\bat\bte\be Show a list of isolated nodes
s
\bsh
\bho
\bow
\bw/
\b/m
\bmu
\buf
\bf <
\b<p
\bpr
\bre
\bef
\bfi
\bix
\bx>
\b> [
\b[<
\b<h
\bho
\bou
\bur
\brs
\bs>
\b>]
\b][
\b[l
\blo
\bon
\bng
\bg]
\b] Show the likely propagation to
<prefix>
-
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
inputing:-
-
SH/MUF W 24
-
-
- SH/MUF W L 24
- SH/MUF W 24 Long
+ SH/MUF W L 24
+ SH/MUF W 24 Long
given on the command line) the distance and beraing from your station
to the locator. For example:-
-
-
SH/QRA IO92QL
SH/QRA JN06 IN73
So for example:-
+
SH/SAT AO-10
SH/SAT FENGYUN1 12 2
system
+
+
1\b11\b1.\b.1\b12\b24\b4.\b. s\bsh\bho\bow\bw/\b/w\bww\bwv\bv (\b(0\b0)\b)
s\bsh\bho\bow\bw/\b/w\bww\bwv\bv Show the last 10 WWV broadcasts
etc etc.
+
+
1\b11\b1.\b.1\b13\b30\b0.\b. s\bst\bta\bat\bt/\b/u\bus\bse\ber\br (\b(5\b5)\b)
s\bst\bta\bat\bt/\b/u\bus\bse\ber\br <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the full status of a user
Only the fields that are defined (in perl term) will be displayed.
-
-
1\b11\b1.\b.1\b13\b31\b1.\b. s\bsy\bys\bso\bop\bp (\b(0\b0)\b)
s\bsy\bys\bso\bop\bp Regain your privileges if you login remotely
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
This is a quick listing that shows which callsigns are connected and
what sort of connection they have
-
-
1\b11\b1.\b.1\b13\b35\b5.\b. w\bwx\bx (\b(0\b0)\b)
w\bwx\bx <\b<t\bte\bex\bxt\bt>\b> Send a weather message to local users
-
-
-
-
-
-
-
-
-
-
projects / spider.git / commitdiff