From 08c1d4cfc96357b3706f50d683c53abfe802d16b Mon Sep 17 00:00:00 2001 From: minima Date: Tue, 25 Jul 2000 20:01:21 +0000 Subject: [PATCH] added new veriosn of admin manual --- Changes | 1 + html/adminmanual-1.html | 12 +++--- html/adminmanual-3.html | 2 +- html/adminmanual-5.html | 44 ++++++++++++++++++-- html/adminmanual-6.html | 89 ++++++++++++++++++++++++++++++++++++++++- html/adminmanual-7.html | 30 +++++++++----- html/adminmanual.html | 15 ++++--- 7 files changed, 166 insertions(+), 27 deletions(-) diff --git a/Changes b/Changes index 7b6c83e2..fc94a8d4 100644 --- a/Changes +++ b/Changes @@ -2,6 +2,7 @@ 1. ignore \n in ax25 mode for C client. 2. remove extra space at the end of a DX spot announce when no grid square is output. +3. added new admin manual from Ian G0VGS 20Jul00======================================================================= 1. Finally managed to update my source with the sourceforge one 2. added user->qra cleaning in various places diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html index d9f0454f..6a109bf8 100644 --- a/html/adminmanual-1.html +++ b/html/adminmanual-1.html @@ -14,7 +14,7 @@ Previous

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

-

Last modified: 18 June 2000 by Ian Maude, G0VGS +

Last modified: 25 July 2000 by Ian Maude, G0VGS

1.1 Introduction

@@ -38,10 +38,10 @@ Previous
  • MD5-1.7.tar.gz
  • Data-Dumper-2.10.tar.gz
  • FreezeThaw-0.3.tar.gz
  • -
  • MLDBM-2.00.ar.gz
  • +
  • MLDBM-2.00.tar.gz
  • TimeDate-1.8.tar.gz
  • -
  • IO-1.20.tar.tgz
  • -
  • Net-Telnet-3.01.tar.gz
  • +
  • IO-1.20.tar.gz
  • +
  • Net-Telnet-3.02.tar.gz
  • Curses-1.02.tar.gz
  • @@ -128,7 +128,7 @@ passwd: all authentication tokens updated successfully $ cd /spider $ mkdir local $ mkdir local_cmd -$ cp perl/DXVars.pm local +$ cp perl/DXVars.pm.issue local/DXVars.pm $ cd local $ vi DXVars.pm (or your favourite editor) @@ -141,7 +141,7 @@ $ vi DXVars.pm (or your favourite editor)

    PLEASE USE CAPITAL LETTERS FOR CALLSIGNS

    -

    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 whilst the cluster is running! +

    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!

    Save the new file and change directory to ../perl ....

    diff --git a/html/adminmanual-3.html b/html/adminmanual-3.html index 42605ab7..5270816e 100644 --- a/html/adminmanual-3.html +++ b/html/adminmanual-3.html @@ -116,7 +116,7 @@ PC38^GB7MBC^~

             
    -#               All lines starting with a # are ignored, as are wholly blank lines.
    +#               All lines starting with a # are ignored, as are completely blank lines.
     
     timeout         timeout followed by a number is the number of seconds to wait for a 
                     command to complete. If there is no timeout specified in the script 
    diff --git a/html/adminmanual-5.html b/html/adminmanual-5.html
    index 53b4e66b..728ea821 100644
    --- a/html/adminmanual-5.html
    +++ b/html/adminmanual-5.html
    @@ -14,13 +14,50 @@
     

    5. Filtering

    -

    Filters can be set for spots, announcements and WWV. You will find the directories for these under /spider/filter. You will find some example in the directories with the suffix .issue. There are two types of filter, one for incoming information and one for outgoing information. Outgoing filters are in the form CALLSIGN.pl and incoming filters are in the form in_CALLSIGN.pl. Filters can be set for both nodes and users. +

    Filters can be set for spots, announcements and WWV. You will find the directories for these under /spider/filter. You will find some examples in the directories with the suffix .issue. There are two types of filter, one for incoming information and one for outgoing information. Outgoing filters are in the form CALLSIGN.pl and incoming filters are in the form in_CALLSIGN.pl. Filters can be set for both nodes and users. +

    +

    All filters work in basically the same way. There are several elements delimited by commas. +There can be many lines in the filter and they are read from the top by the program. +When writing a filter you need to think carefully about just what you want to achieve. You +are either going to write a filter to accept or to reject. +Think of a filter as having 2 main elements. For a reject filter, you would have a line +or multiple lines rejecting the things you do not wish to receive and then a default +line accepting everything else that is not included in the filter. Likewise, for an +accept filter, you would have a line or multiple lines accepting the things you wish +to receive and a default line rejecting everthing else. +

    +

    In the example below, a user requires a filter that would only return SSB spots +posted in Europe on the HF bands. This is achieved by first rejecting the CW section +of each HF band and rejecting all of VHF, UHF etc based on frequency. +Secondly, a filter rule is set based on CQ zones to only accept spots posted in +Europe. Lastly, a default filter rule is set to reject anything outside the filter. +

    +

    +
    +$in = [
    +        [ 0, 0, 'r', # reject all CW spots
    +                [
    +                1800.0, 1850.0,
    +                3500.0, 3600.0,
    +                7000.0, 7040.0,
    +                14000.0, 14100.0,
    +                18068.0, 18110.0,
    +                21000.0, 21150.0,
    +                24890.0, 24930.0,
    +                28000.0, 28180.0,
    +                30000.0, 49000000000.0,
    +                ] ,1 ],
    +        [ 1, 11, 'n', [ 14, 15, 16, 20, 33, ], 15 ], #accept EU
    +        [ 0, 0, 'd', 0, 1 ], # 1 = want, 'd' = everything else
    +];
    +
    +
    +

    +

    The actual elements of each filter are described more fully in the following sections.

    5.1 Spots

    -

    All filters work in basically the same way. There are several elements delimited by commas. I will use the spot filter as an example .... -

    The elements of the Spot filter are ....

    @@ -98,6 +135,7 @@ Lets look carefully at the first line. The first element is 0 (drop). Therefor

    +  [ 0, 0, 'r',
         [  
           1800.0, 2000.0,         # top band 
           10100.0, 10150.0,       # WARC  
    diff --git a/html/adminmanual-6.html b/html/adminmanual-6.html
    index 12531028..c5a557f7 100644
    --- a/html/adminmanual-6.html
    +++ b/html/adminmanual-6.html
    @@ -253,7 +253,94 @@ package CmdAlias;
     

    You can create aliases for commands at will. Beware though, these may not always turn out as you think. Care is needed and you need to test the results once you have set an alias.

    -

    6.5 Console.pl +

    6.5 Forward.pl +

    + +

    DXSpider receives all and any mail sent to it without any alterations needed +in files. Because personal and bulletin mail are treated differently, there +is no need for a list of accepted bulletin addresses. It is necessary, however, +to tell the program which links accept which bulletins. For example, it is +pointless sending bulletins addresses to "UK" to any links other than UK +ones. The file that does this is called forward.pl and lives in /spider/msg. +At default, like other spider files it is named forward.pl.issue. Rename it +to forward.pl and edit the file to match your requirements. +The format is below ... +

    +

    +
    +#
    +# this is an example message forwarding file for the system
    +#
    +# The format of each line is as follows
    +#
    +#     type    to/from/at pattern action  destinations
    +#     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
    +#
    +# type: P - private, B - bulletin (msg), F - file (ak1a bull)
    +# to/from/at: T - to field, F - from field, A - home bbs, O - origin 
    +# pattern: a perl regex on the field requested
    +# action: I - ignore, F - forward
    +# destinations: a reference to an array containing node callsigns
    +#
    +# if it is non-private and isn't in here then it won't get forwarded 
    +#
    +# Currently only type B msgs are affected by this code.
    +# 
    +# The list is read from the top down, the first pattern that matches
    +# causes the action to be taken.
    +#
    +# The pattern can be undef or 0 in which case it will always be selected
    +# for the action specified
    +#
    +# If the BBS list is undef or 0 and the action is 'F' (and it matches the
    +# pattern) then it will always be forwarded to every node that doesn't have 
    +# it (I strongly recommend you don't use this unless you REALLY mean it, if
    +# you allow a new link with this on EVERY bull will be forwarded immediately
    +# on first connection)
    +#
    +
    +package DXMsg;
    +
    +@forward = (
    +'B',    'T',    'LOCAL',        'F',    [ qw(GB7MBC) ],
    +'B',    'T',    'ALL',          'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'UK',           'F',    [ qw(GB7BAA GB7ADX) ],
    +'B',    'T',    'QSL',          'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'QSLINF',       'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'DX',           'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'DXINFO',       'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'DXNEWS',       'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'DXQSL',        'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +'B',    'T',    'SYSOP',        'F',    [ qw(GB7BAA GB7ADX) ],
    +'B',    'T',    '50MHZ',        'F',    [ qw(GB7BAA GB7ADX PA4AB-14) ],
    +);
    +
    +
    +

    Simply insert a bulletin address and state in the brackets where you wish +that mail to go. For example, you can see here that mail sent to "UK" will +only be sent to the UK links and not to PA4AB-14. +

    +

    To force the cluster to reread the file use load/forward +

    +

    6.6 Distribution lists +

    + +

    Distribution lists are simply a list of users to send certain types of +mail to. An example of this is mail you only wish to send to other +sysops. In /spider/msg there is a directory called distro. You +put any distibution lists in here. For example, here is a file called +SYSOP.pl that caters for the UK sysops. +

    +

    +
    +qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
    +   GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH 
    +   GB7DXK GB7DXI GB7DXS)
    +
    +
    +

    Any mail sent to "sysop" would only be sent to the callsigns in this list. +

    +

    6.7 Console.pl

    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. diff --git a/html/adminmanual-7.html b/html/adminmanual-7.html index 5a60b9de..af763d04 100644 --- a/html/adminmanual-7.html +++ b/html/adminmanual-7.html @@ -182,7 +182,7 @@ and Homenode. PC41s are only sent for the information that is available.

    7.12 init (5)

    -

    init <node call> Re-initialise a link to an AK1A compatible node +

    init <node call> Re-initialise a link to an AK1A compatible node

    This command attempts to re-initialise a link to a (usually) AK1A node that has got confused, usually by a protocol loop of some kind. It may @@ -343,7 +343,7 @@ permission to send this command at all.

    7.26 set/debug (9)

    -

    set/debug <name>Add a debug level to the debug set +

    set/debug <name> Add a debug level to the debug set

    You can remove this level with unset/debug <name>

    @@ -362,7 +362,7 @@ out from it nor goes back into from the rest of the nodes connected to you.

    7.28 set/sys_location (9)

    -

    set/sys_location <lat & long>Set your cluster latitude and longitude +

    set/sys_location <lat & long> Set your cluster latitude and longitude

    In order to get accurate headings and such like you must tell the system what your latitude and longitude is. If you have not yet done a SET/QRA @@ -372,7 +372,7 @@ then this command will set your QRA locator for you. For example:-

    7.29 set/lockout (9)

    -

    set/lockout <call>Stop a callsign connecting to the cluster +

    set/lockout <call> Stop a callsign connecting to the cluster

    You can show who is locked out with the show/lockout (9) command.

    To allow the user to connect again, use the command unset/lockout @@ -380,7 +380,7 @@ then this command will set your QRA locator for you. For example:-

    7.30 set/node (9)

    -

    set/node <call> [<call> ...]Make the callsign an AK1A cluster +

    set/node <call> [<call> ...] Make the callsign an AK1A cluster

    Tell the system that the call(s) are to be treated as AK1A cluster and fed PC Protocol rather normal user commands. @@ -475,12 +475,22 @@ is useful for checking where you think you have loaded a .pm file from.

    7.37 shutdown (5)

    -

    shutdownShutdown the cluster +

    shutdown Shutdown the cluster

    Shutdown the cluster and disconnect all the users. If you have Spider set to respawn in /etc/inittab it will of course restart.

    -

    7.38 stat/db (5) +

    7.38 spoof (9) +

    + +

    spoof <callsign> <command> Run commands as another user +

    +

    This is a very simple yet powerful command for the sysop. It allows you to +issue commands as if you were a different user. This is very useful for the +kind of things that users seem to always get wrong.. like home_node for +example. +

    +

    7.39 stat/db (5)

    stat/db <dbname> Show the status of a database @@ -489,7 +499,7 @@ set to respawn in /etc/inittab it will of course restart.

    Depending on your privilege level you will see more or less information. This command is unlikely to be of much use to anyone other than a sysop.

    -

    7.39 stat/channel (5) +

    7.40 stat/channel (5)

    stat/channel <callsign> Show the status of a channel on the cluster @@ -498,7 +508,7 @@ This command is unlikely to be of much use to anyone other than a sysop. you are on or else for the callsign that you asked for.

    Only the fields that are defined (in perl term) will be displayed.

    -

    7.40 stat/msg (5) +

    7.41 stat/msg (5)

    stat/msg <msgno> Show the status of a message @@ -506,7 +516,7 @@ you are on or else for the callsign that you asked for.

    This command shows the internal status of a message and includes information such as to whom it has been forwarded, its size, origin etc etc.

    -

    7.41 stat/user (5) +

    7.42 stat/user (5)

    stat/user <callsign> Show the full status of a user diff --git a/html/adminmanual.html b/html/adminmanual.html index 64e14573..219d120d 100644 --- a/html/adminmanual.html +++ b/html/adminmanual.html @@ -14,7 +14,7 @@ Contents


    The DXSpider Installation and Administration Manual

    -

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

    Version 1.21 June 2000 +

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

    Version 1.24 July 2000


    A reference for SysOps of the DXSpider DXCluster program.
    @@ -65,7 +65,9 @@ Contents
  • 6.2 Downtime message
  • 6.3 Other text messages
  • 6.4 The Aliases file -
  • 6.5 Console.pl +
  • 6.5 Forward.pl +
  • 6.6 Distribution lists +
  • 6.7 Console.pl

    7. Sysop commands

    @@ -108,10 +110,11 @@ Contents
  • 7.35 set/sys_qra (9)
  • 7.36 show program (5)
  • 7.37 shutdown (5) -
  • 7.38 stat/db (5) -
  • 7.39 stat/channel (5) -
  • 7.40 stat/msg (5) -
  • 7.41 stat/user (5) +
  • 7.38 spoof (9) +
  • 7.39 stat/db (5) +
  • 7.40 stat/channel (5) +
  • 7.41 stat/msg (5) +
  • 7.42 stat/user (5)
    Next -- 2.43.0