INSTALL

   1 DXSPIDER INSTALLATION
   2
   3 This version of dxspider requires perl5 (it is written entirely in perl5 and
   4 makes extensive use of perl objects). This program is known to work with
   5 RedHat 5.1 perl5_004.
   6
   7 In addition to the standard perl5 distribution you will require to load the
   8 the following modules:-
   9
  10 1) CPAN - this has a load of the standard extra stuff in it. To load it type:-
  11
  12   # perl -MCPAN -e shell
  13   cpan> install Bundle::CPAN
  14   cpan> q
  15
  16   Please sure there were no errors, be particularly careful when installing
  17   libwww stuff, I would suggest 'no host lookups' and pressing <space> and
  18   enter for each of the offered default hostnames.
  19
  20 2) Date::Parse, MLDBM, IO::Select
  21
  22   As you have so carefully loaded it, I suggest you use the CPAN system
  23   above:-
  24
  25   # perl -MCPAN -e shell
  26   cpan> install Date::Parse
  27   ..
  28   ..
  29   cpan> install MLDBM
  30   ..
  31   ..
  32   cpan> install IO::Select
  33
  34 3) select a user to run the cluster as UNDER _NO_ CIRCUMSTANCES USE ROOT.
  35
  36    I say again DO NOT USE root.
  37
  38    Pick an existing user or create a new one. Don't care which. I don't know
  39    your security requirements.
  40
  41 4) login as root (I shall use 'jim' for any examples).
  42
  43 5) # cd ~jim
  44    # tar xvfz spider-x.x.tar.gz
  45    # ln -s ~jim/spider /spider
  46    # groupadd -g 251 spider       (or another number)
  47    # vi /etc/group                (or your favorite editor)
  48      add jim (or whatever) and root to the group spider
  49      it should look something like:-
  50
  51          spider:x:251:jim,root
  52          :x
  53    # chown -R jim.spider spider
  54    # find . -type d -exec chmod 2775 {} \;
  55    # find . -type f -exec chmod 775 {} \;
  56
  57    This last step allows various users of group spider to have write
  58    access to all the directories. Not really needed for now but will
  59    be useful when web interfaces start to appear.
  60
  61 6) if you have any users that require network logins, set them up as real
  62    users with useradd -m <callsign>. Alter the default .bashrc so that it
  63    contains just one line (assuming you use the default bash shell).
  64
  65    exec /spider/perl/client.pl <callsign>
  66
  67    Don't forget to give them a real password. This is really for network
  68    cluster logins
  69
  70 7) for incoming AX25 connections you are expected to have got the AX25
  71    utilities setup, tested and working. See the AX25-HOWTO for more info
  72    on this - it really is outside the scope of this document. I would
  73    recommend using ax25-utils-2.1.42a-5.i386.rpm or above as a starting
  74    point. DXSpider uses ax25d for incoming connections. You need to have
  75    entries like this:-
  76
  77    [ether]
  78    NOCALL   * * * * * *  L
  79    default  * * * * * *  - djk /spider/perl/client.pl client.pl %u ax25
  80    <bbs>
  81    NOCALL   * * * * * *  L
  82    default  * * * * * *  - djk /spider/perl/client.pl client.pl %u ax25
  83
  84    where ether and bbs are appropriate KNOWN WORKING axport and nrport
  85    names respectively.
  86
  87    Obviously you can use different names, callsigns or whatever for your
  88    purposes, but it is up to you to get it to work.
  89
  90    Note I use BPQ over ethernet which why I have the port names I have.
  91
  92 8) login as jim (or whatever)
  93    $ startx                     (much easier to use X)
  94    $ cd /spider
  95    $ mkdir local
  96    $ mkdir local_cmd
  97    $ cp perl/DXVars.pm local
  98    $ cd local
  99    $ vi DXVars.pm
 100
 101    now alter your cluster callsign, sysop callsign and other user info
 102    as you wish. Note that this a perl file which will parsed and executed
 103    as part of the cluster. If you get it wrong then perl will complain
 104    when you start the cluster process.
 105
 106    PLEASE USE CAPITAL LETTERS FOR CALLSIGNS
 107
 108    DON'T alter the DXVars.pm (or any other file) in /spider/perl, they are
 109    overwritten with every release. Any files or commands you place in
 110    /spider/local or /spider/local_cmd will automagically be used in preference
 111    to the ones in /spider/perl EVEN whilst the cluster is running!
 112
 113    :x
 114
 115    $ cd ../perl
 116    $ cluster.pl
 117    DXSpider DX Cluster Version x.x
 118    Copyright (c) 1998 Dirk Koopman G1TLH
 119    loading prefixes ...
 120    loading band data ...
 121    loading user file system ...
 122    starting listener ...
 123    reading existing message headers
 124    reading cron jobs
 125    orft we jolly well go ...
 126
 127
 128 9) now log in again or start another rxvt or xterm
 129    $ client.pl
 130
 131    you should now see a normal cluster prompt.
 132
 133    at the cluster prompt:-
 134
 135    G1JIM de GB7JIM 10-Sep-98 1000Z> set/node GB7XXX
 136
 137    for every dxcluster you expect to connect to or from.
 138
 139    G1JIM de GB7JIM 10-Sep-98 1001Z> shutdown
 140
 141    The cluster and the client should both go back to prompts
 142
 143    Restart the cluster.
 144
 145    The callsigns should be the sysop callsign and the cluster callsign
 146    as per your modified DXVars.pm. You can check that the cluster
 147    connections will work by:-
 148
 149    $ client.pl gb7xxx      (doesn't have to be uppercase).
 150    PC38^GB7JIM^~           <- the cluster thinks this is a cluster
 151    ^C                      <- to get out
 152
 153
 154
 155
 156
 157