txt/spiderFAQ_en.txt

   1   The DXSpider FAQ
   2   Ian Maude, G0VGS, (g0vgs@gb7mbc.net)
   3   February 2005 Revision: 1.8
   4
   5   A reference for SysOps of the DXSpider DXCluster program.
   6   ______________________________________________________________________
   7
   8   Table of Contents
   9
  10
  11   1. Installation
  12      1.1 Where do I get DXSpider?
  13      1.2 How do I use the patches?
  14      1.3 If I use a tarball to overwrite my installation, what happens to my configuration?
  15      1.4 I am running RedHat 5.2 and I am getting strange errors, what is wrong?
  16
  17   2. Administration
  18      2.1 How can I get Spider to restart automatically if it crashes?
  19      2.2 How can I monitor traffic to and from a node or user?
  20      2.3 I see spots coming in my debug log, but none go out to the users
  21      2.4 My neighbouring node cannot use the RCMD command to me, he just keeps getting the "tut tut" message.
  22      2.5 I do not seem to be sending any bulletin mail to my link partners, what is wrong?
  23      2.6 How can I automatically limit the amount of debug logfiles that are stored?
  24      2.7 I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem?
  25      2.8 Since I last updated I seem to be getting duplicate spots appearing.
  26      2.9 I have deleted a message but it is still there, why?
  27      2.10 I have updated from CVS and I get all sorts of errors when I restart
  28      2.11 I have done a CVS update, restarted and it says that "fileX" is missing
  29
  30
  31   ______________________________________________________________________
  32
  33   Please mail any FAQs to the maintainer at the address above.
  34
  35
  36
  37   \e[1m1.  Installation\e[0m
  38
  39   \e[1m1.1.  Where do I get DXSpider?\e[0m
  40
  41   All things Spider can be found at www.dxcluster.org and the actual
  42   program and patches can be found in the download area.
  43
  44
  45   \e[1m1.2.  How do I use the patches?\e[0m
  46
  47   Patching is done in the standard linux way ...
  48
  49
  50
  51        zcat /tmp/patch-1.40 | patch -p0
  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
  64   \e[1m1.3.  If I use a tarball to overwrite my installation, what happens to\e[0m
  65   \e[1mmy configuration?\e[0m
  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   \e[1m1.4.  I am running RedHat 5.2 and I am getting strange errors, what is\e[0m
  73   \e[1mwrong?\e[0m
  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   \e[1m2.  Administration\e[0m
  82
  83   \e[1m2.1.  How can I get Spider to restart automatically if it crashes?\e[0m
  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   Run \e[4mtelinit\e[24m \e[4mq\e[24m as root.  Spider will restart so be aware.  However, any
  94   time you reboot, cluster.pl will start in tty7 and if it crashes, it
  95   should restart ok.
  96
  97
  98   \e[1m2.2.  How can I monitor traffic to and from a node or user?\e[0m
  99
 100   There are 2 ways to achieve this.  You can use the \e[4mtail\e[24m command like
 101   this ..
 102
 103
 104
 105        tail -f /spider/data/debug/167.dat |grep G0VGS
 106
 107
 108
 109   or in later versions of Spider, there is a command called \e[4mwatchdbg\e[24m in
 110   which case you simply type ..
 111
 112
 113
 114        watchdbg G0VGS
 115
 116
 117
 118   \e[1m2.3.  I see spots coming in my debug log, but none go out to the users\e[0m
 119
 120   Please check the time on your PC.
 121
 122
 123   All spots are checked that they are no more than 15 minutes in the
 124   future and 60 minutes in the past. If your clock on your client prompt
 125   (or console.pl display) is not set to the correct time in GMT (UTC)
 126   and is more than one hour out (say on your local (summer) time) then
 127   the test will fail and no spots will come out. Neither will they be
 128   stored.
 129
 130
 131   If you are connected to the internet, most linux distributions have an
 132   implementation of ntpd. The Microsoft Windows 2003, XP, 2000 and NT
 133   machine clock can also be set to be syncronised to an NTP source.
 134   This can be done in the standard time configuration screen. There is
 135   also the simple nettime program for Windows 95/98/ME.
 136
 137
 138
 139   \e[1m2.4.  My neighbouring node cannot use the RCMD command to me, he just\e[0m
 140   \e[1mkeeps getting the "tut tut" message.\e[0m
 141
 142   Assuming that the permissions are set correctly (perm level 5
 143   required), it could be that the home_node is set incorrectly.  You can
 144   reset the home_node using the \e[4mspoof\e[24m command like this ..
 145
 146
 147
 148        spoof gb7adx set/home gb7adx
 149
 150
 151
 152   Assuming that the node_call you are changing is gb7adx.
 153
 154
 155   \e[1m2.5.  I do not seem to be sending any bulletin mail to my link part-\e[0m
 156   \e[1mners, what is wrong?\e[0m
 157
 158   There is a file in /spider/msg called forward.pl.issue.  Rename this
 159   to forward.pl and edit it to meet your requirements.  You will need to
 160   issue the command \e[4mload/forward\e[24m or restart Spider for the changes to
 161   take effect.
 162
 163
 164   \e[1m2.6.  How can I automatically limit the amount of debug logfiles that\e[0m
 165   \e[1mare stored?\e[0m
 166
 167   Use the tmpwatch command.  Create a file in /etc/cron.daily/
 168   containing the line ...
 169
 170
 171
 172        /usr/sbin/tmpwatch -f 240 /spider/data/debug
 173
 174
 175
 176   Remember to make it executable!
 177
 178   This will limit your debug data down to the last 10 days.
 179
 180   However, modern versions of DXSpider will do this for you, so this is
 181   now probably unnecessary.
 182
 183
 184   \e[1m2.7.  I updated my Linux distribution and now Spider cannot read the\e[0m
 185   \e[1musers file or the dupefile, what is the problem?\e[0m
 186
 187   Almost certainly this is a change in the db format of perl.  Follow
 188   these few steps to correct the problem.
 189
 190   o  stop the cluster (disable any autostart in inittab)
 191
 192   o  cd /spider/data
 193
 194   o  issue the command: perl user_asc
 195
 196   o  restart the cluster
 197
 198   That should solve the problem.
 199
 200
 201   \e[1m2.8.  Since I last updated I seem to be getting duplicate spots\e[0m
 202   \e[1mappearing.\e[0m
 203
 204   What has probably happened is that the dupefile has got corrupted in
 205   some way.  Simply delete the /spider/data/dupefile and restart the
 206   cluster.  It may take a little time to become fully functional but
 207   should solve your problem.
 208
 209
 210   \e[1m2.9.  I have deleted a message but it is still there, why?\e[0m
 211
 212   This is now the way messages are handled for deletion in Spider.  If
 213   you look closely you will see a 'D' following the message number.
 214   This message is marked for deletion and will be deleted in 2 days if
 215   nothing further is done.  Optionally you can use the command
 216   \e[4mdelete/expunge\e[24m to delete it immediately.
 217
 218
 219   \e[1m2.10.  I have updated from CVS and I get all sorts of errors when I\e[0m
 220   \e[1mrestart\e[0m
 221
 222   Whenever you update from CVS, a log is displayed. Next to each file
 223   that is downloaded there is a letter, e.g.:
 224
 225
 226
 227        ? fred.pl
 228        ? jim
 229        ..
 230        .
 231        ..
 232        cvs server: Updating perl
 233        P cluster.pl
 234        C Messages
 235        M Internet.pm
 236        U DXProt.pm
 237        ..
 238        .
 239        ..
 240
 241
 242
 243   For normal CVS use you should only ever see the letters 'P', 'U' or
 244   '?'. The letter 'P' means that the file has changed in CVS and is more
 245   recent than the one that is currently on your system. You will also
 246   see the letter '?', which means that there is a file that you (or the
 247   system) has created that CVS doesn't know about and isn't under its
 248   control. These are all normal and good.
 249
 250
 251   Sometimes you will see the letter 'U' next to a file. This means that
 252   it is a new file that you don't currently have. This is also OK.
 253
 254   However, if you see the letter 'C' or 'M', that means that CVS thinks
 255   that the file has changed locally. For the letter 'C', it has changed
 256   sufficiently near to one or more modifications which CVS wants to
 257   download to your system. For the 'M', CVS thinks that it is OK to make
 258   the change (you may also see some messages about "merging revision
 259   1.xx with 1.yy").  Neither of these things are good. Files that are
 260   under the control of CVS must not be changed by sysops. It is the
 261   files that have the 'C' next to them that will show the errors that
 262   you are complaining about and they will be things like:-
 263
 264
 265
 266        Syntax error near '<<<<' at line 23
 267        Syntax error near '===' at line 40
 268        Syntax error near '>>>' at line 51
 269
 270
 271
 272   You will not necessarily see all of the errors shown but you will get
 273   one or more sets of some of them. The cure is simple:
 274
 275
 276   o  identify the file that is causing the problem.
 277
 278   o  remove the file.
 279
 280   o  run the cvs update again.
 281
 282
 283   You will see that file come back (with a letter 'U' next to it). That
 284   will be the correct file as CVS thinks it should be. If you \e[4mstill\e[24m have
 285   a problem, then get onto the dxspider-support mailing list.
 286
 287
 288   If all else fails (or you have several conflicts) you can safely
 289   remove the entire /spider/perl and /spider/cmd directories and then
 290   run the cvs update. They will all be recreated in their pristine
 291   condition.
 292
 293
 294   \e[1m2.11.  I have done a CVS update, restarted and it says that "fileX" is\e[0m
 295   \e[1mmissing\e[0m
 296
 297   The correct way to run cvs is:-
 298
 299
 300
 301        cd /spider
 302        cvs -z3 update -d
 303
 304
 305
 306   The '-d' is crucial. It makes sure that any new directories, that may
 307   contain new code, are created and that new code downloaded. I have
 308   absolutely no idea why this is not the default, seeing as CVS (in
 309   other circumstances) happily recurses its merry way down a directory
 310   tree, but there you are.
 311
 312
 313   WinCVS and other graphical CVS frontends have a checkbox for the
 314   update screen called something like "create sub-directories" (it may
 315   be hidden in some sub-screen - go look for it if it isn't obvious).
 316   Make sure that this box is checked. If you can make this the default
 317   setting in the program's setup screen then please do that. It will
 318   save you a lot of pulled hair.
 319
 320
 321