]> scm.dxcluster.org Git - spider.git/blob - txt/spiderFAQ_en.txt
fix sh/425 (mostly - bull doesn't work)
[spider.git] / 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