txt/spiderFAQ.txt

   1   The DXSpider FAQ
   2   Ian Maude, G0VGS, (ianmaude@btinternet.com)
   3   $Date$ $Revision$
   4
   5   A reference for SysOps of the DXSpider DXCluster program.
   6   ______________________________________________________________________
   7
   8   Table of Contents
   9
  10
  11   1. Installation
  12
  13      1.1 Where do I get DXSpider?
  14      1.2 How do I use the patches?
  15      1.3 If I use a tarball to overwrite my installation, what happens to my configuration?
  16      1.4 I am running RedHat 5.2 and I am getting strange errors, what is wrong?
  17
  18   2. Administration
  19
  20      2.1 How can I get Spider to restart automatically if it crashes?
  21      2.2 How can I monitor traffic to and from a node or user?
  22      2.3 My neighbouring node cannot use the RCMD command to me, he just keeps getting the "tut tut" message.
  23      2.4 I do not seem to be sending any bulletin mail to my link partners, what is wrong?
  24      2.5 How can I automatically limit the amount of debug logfiles that are stored?
  25      2.6 I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem?
  26      2.7 Since I last updated I seem to be getting duplicate spots appearing.
  27
  28
  29   ______________________________________________________________________
  30
  31   Please mail any FAQs to the maintainer at the address above.
  32
  33
  34
  35   1\b1.\b.  I\bIn\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn
  36
  37   1\b1.\b.1\b1.\b.  W\bWh\bhe\ber\bre\be d\bdo\bo I\bI g\bge\bet\bt D\bDX\bXS\bSp\bpi\bid\bde\ber\br?\b?
  38
  39   All things Spider can be found at www.dxcluster.org and the actual
  40   program and patches can be found in the download area.
  41
  42
  43   1\b1.\b.2\b2.\b.  H\bHo\bow\bw d\bdo\bo I\bI u\bus\bse\be t\bth\bhe\be p\bpa\bat\btc\bch\bhe\bes\bs?\b?
  44
  45   Patching is done in the standard linux way ...
  46
  47
  48
  49        zcat /tmp/patch-1.40 | patch -p0
  50
  51
  52
  53
  54
  55   assuming the patch version you are using is 1.40 and resides in /tmp!
  56
  57
  58   Be aware that each patch assumes the previous patch has been applied.
  59   That is to say if you are patching from version 1.38 to 1.40 you would
  60   first need to apply patch-1.39 and then patch-1.40.
  61
  62
  63   1\b1.\b.3\b3.\b.  I\bIf\bf I\bI u\bus\bse\be a\ba t\bta\bar\brb\bba\bal\bll\bl t\bto\bo o\bov\bve\ber\brw\bwr\bri\bit\bte\be m\bmy\by i\bin\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn,\b, w\bwh\bha\bat\bt h\bha\bap\bpp\bpe\ben\bns\bs t\bto\bo
  64   m\bmy\by c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn?\b?
  65
  66
  67   The tarballs are designed to not overwrite your existing configuration
  68   and can be used at any time to update your Spider software.  All the
  69   key files have the suffix .issue (eg. DXVars.pm.issue) at default.
  70
  71
  72   1\b1.\b.4\b4.\b.  I\bI a\bam\bm r\bru\bun\bnn\bni\bin\bng\bg R\bRe\bed\bdH\bHa\bat\bt 5\b5.\b.2\b2 a\ban\bnd\bd I\bI a\bam\bm g\bge\bet\btt\bti\bin\bng\bg s\bst\btr\bra\ban\bng\bge\be e\ber\brr\bro\bor\brs\bs,\b, w\bwh\bha\bat\bt i\bis\bs
  73   w\bwr\bro\bon\bng\bg?\b?
  74
  75   The version of Perl that comes with 5.2 seems to be some kind of pre-
  76   release and is broken.  You can get a new version of perl from
  77   www.dxcluster.org or ftp://updates.redhat.com.  Don't forget to patch
  78   it with the CPAN modules.
  79
  80
  81   2\b2.\b.  A\bAd\bdm\bmi\bin\bni\bis\bst\btr\bra\bat\bti\bio\bon\bn
  82
  83   2\b2.\b.1\b1.\b.  H\bHo\bow\bw c\bca\ban\bn I\bI g\bge\bet\bt S\bSp\bpi\bid\bde\ber\br t\bto\bo r\bre\bes\bst\bta\bar\brt\bt a\bau\but\bto\bom\bma\bat\bti\bic\bca\bal\bll\bly\by i\bif\bf i\bit\bt c\bcr\bra\bas\bsh\bhe\bes\bs?\b?
  84
  85   Put this line into /etc/inittab ..
  86
  87
  88
  89        DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop > /dev/tty7
  90
  91
  92
  93
  94   Run _\bt_\be_\bl_\bi_\bn_\bi_\bt _\bq as root.  Spider will restart so be aware.  However, any
  95   time you reboot, cluster.pl will start in tty7 and if it crashes, it
  96   should restart ok.
  97
  98
  99   2\b2.\b.2\b2.\b.  H\bHo\bow\bw c\bca\ban\bn I\bI m\bmo\bon\bni\bit\bto\bor\br t\btr\bra\baf\bff\bfi\bic\bc t\bto\bo a\ban\bnd\bd f\bfr\bro\bom\bm a\ba n\bno\bod\bde\be o\bor\br u\bus\bse\ber\br?\b?
 100
 101   There are 2 ways to achieve this.  You can use the _\bt_\ba_\bi_\bl command like
 102   this ..
 103
 104
 105
 106        tail -f /spider/data/debug/167.dat |grep G0VGS
 107
 108
 109
 110
 111   or in later versions of Spider, there is a command called _\bw_\ba_\bt_\bc_\bh_\bd_\bb_\bg in
 112   which case you simply type ..
 113
 114
 115
 116        watchdbg G0VGS
 117
 118
 119
 120
 121
 122   2\b2.\b.3\b3.\b.  M\bMy\by n\bne\bei\big\bgh\bhb\bbo\bou\bur\bri\bin\bng\bg n\bno\bod\bde\be c\bca\ban\bnn\bno\bot\bt u\bus\bse\be t\bth\bhe\be R\bRC\bCM\bMD\bD c\bco\bom\bmm\bma\ban\bnd\bd t\bto\bo m\bme\be,\b, h\bhe\be j\bju\bus\bst\bt
 123   k\bke\bee\bep\bps\bs g\bge\bet\btt\bti\bin\bng\bg t\bth\bhe\be "\b"t\btu\but\bt t\btu\but\bt"\b" m\bme\bes\bss\bsa\bag\bge\be.\b.
 124
 125   Assuming that the permissions are set correctly (perm level 5
 126   required), it could be that the home_node is set incorrectly.  You can
 127   reset the home_node using the _\bs_\bp_\bo_\bo_\bf command like this ..
 128
 129
 130
 131        spoof gb7adx set/home gb7adx
 132
 133   Assuming that the node_call you are changing is gb7adx.
 134
 135
 136   2\b2.\b.4\b4.\b.  I\bI d\bdo\bo n\bno\bot\bt s\bse\bee\bem\bm t\bto\bo b\bbe\be s\bse\ben\bnd\bdi\bin\bng\bg a\ban\bny\by b\bbu\bul\bll\ble\bet\bti\bin\bn m\bma\bai\bil\bl t\bto\bo m\bmy\by l\bli\bin\bnk\bk p\bpa\bar\brt\bt-\b-
 137   n\bne\ber\brs\bs,\b, w\bwh\bha\bat\bt i\bis\bs w\bwr\bro\bon\bng\bg?\b?
 138
 139   There is a file in /spider/msg called forward.pl.issue.  Rename this
 140   to forward.pl and edit it to meet your requirements.  You will need to
 141   issue the command _\bl_\bo_\ba_\bd_\b/_\bf_\bo_\br_\bw_\ba_\br_\bd or restart Spider for the changes to
 142   take effect.
 143
 144
 145   2\b2.\b.5\b5.\b.  H\bHo\bow\bw c\bca\ban\bn I\bI a\bau\but\bto\bom\bma\bat\bti\bic\bca\bal\bll\bly\by l\bli\bim\bmi\bit\bt t\bth\bhe\be a\bam\bmo\bou\bun\bnt\bt o\bof\bf d\bde\beb\bbu\bug\bg l\blo\bog\bgf\bfi\bil\ble\bes\bs t\bth\bha\bat\bt
 146   a\bar\bre\be s\bst\bto\bor\bre\bed\bd?\b?
 147
 148   Use the tmpwatch command.  Create a file in /etc/cron.daily/
 149   containing the line ...
 150
 151
 152
 153        /usr/sbin/tmpwatch -f 240 /spider/data/debug
 154
 155
 156
 157
 158   Remember to make it executable!
 159
 160   This will limit your debug data down to the last 10 days
 161
 162
 163   2\b2.\b.6\b6.\b.  I\bI u\bup\bpd\bda\bat\bte\bed\bd m\bmy\by L\bLi\bin\bnu\bux\bx d\bdi\bis\bst\btr\bri\bib\bbu\but\bti\bio\bon\bn a\ban\bnd\bd n\bno\bow\bw S\bSp\bpi\bid\bde\ber\br c\bca\ban\bnn\bno\bot\bt r\bre\bea\bad\bd t\bth\bhe\be
 164   u\bus\bse\ber\brs\bs f\bfi\bil\ble\be o\bor\br t\bth\bhe\be d\bdu\bup\bpe\bef\bfi\bil\ble\be,\b, w\bwh\bha\bat\bt i\bis\bs t\bth\bhe\be p\bpr\bro\bob\bbl\ble\bem\bm?\b?
 165
 166   Almost certainly this is a change in the db format of perl.  Follow
 167   these few steps to correct the problem.
 168
 169
 170   +\bo  stop the cluster (disable any autostart in inittab)
 171
 172   +\bo  cd /spider/data
 173
 174   +\bo  issue the command perl user_asc
 175
 176   +\bo  restart the cluster
 177
 178   That should solve the problem.
 179
 180
 181   2\b2.\b.7\b7.\b.  S\bSi\bin\bnc\bce\be I\bI l\bla\bas\bst\bt u\bup\bpd\bda\bat\bte\bed\bd I\bI s\bse\bee\bem\bm t\bto\bo b\bbe\be g\bge\bet\btt\bti\bin\bng\bg d\bdu\bup\bpl\bli\bic\bca\bat\bte\be s\bsp\bpo\bot\bts\bs
 182   a\bap\bpp\bpe\bea\bar\bri\bin\bng\bg.\b.
 183
 184   What has probably happened is that the dupefile has got corrupted in
 185   some way.  Simply delete the /spider/data/dupefile and restart the
 186   cluster.  It may take a little time to become fully functional but
 187   should solve your problem.
 188
 189
 190
 191
 192
 193
 194
 195
 196
 197
 198