add tmpwatch section to FAQ
[spider.git] / txt / spiderFAQ.txt
1   The DXSpider FAQ
2   Ian Maude, G0VGS, (ianmaude@btinternet.com)
3   Version 0.4 March 2001
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
26
27   ______________________________________________________________________
28
29   Please mail any FAQs to the maintainer at the address above.
30
31
32
33   1\b1.\b.  I\bIn\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn
34
35   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?
36
37   All things Spider can be found at www.dxcluster.org and the actual
38   program and patches can be found in the download area.
39
40
41   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?
42
43   Patching is done in the standard linux way ...
44
45
46
47        zcat /tmp/patch-1.40 | patch -p0
48
49
50
51
52
53   assuming the patch version you are using is 1.40 and resides in /tmp!
54
55
56   Be aware that each patch assumes the previous patch has been applied.
57   That is to say if you are patching from version 1.38 to 1.40 you would
58   first need to apply patch-1.39 and then patch-1.40.
59
60
61   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
62   m\bmy\by c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn?\b?
63
64   The tarballs are designed to not overwrite your existing configuration
65   and can be used at any time to update your Spider software.  All the
66   key files have the suffix .issue (eg. DXVars.pm.issue) at default.
67   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
68   w\bwr\bro\bon\bng\bg?\b?
69
70   The version of Perl that comes with 5.2 seems to be some kind of pre-
71   release and is broken.  You can get a new version of perl from
72   www.dxcluster.org or ftp://updates.redhat.com.  Don't forget to patch
73   it with the CPAN modules.
74
75
76   2\b2.\b.  A\bAd\bdm\bmi\bin\bni\bis\bst\btr\bra\bat\bti\bio\bon\bn
77
78   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?
79
80   Put this line into /etc/inittab ..
81
82
83
84        DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop > /dev/tty7
85
86
87
88
89   Run _\bt_\be_\bl_\bi_\bn_\bi_\bt _\bq as root.  Spider will restart so be aware.  However, any
90   time you reboot, cluster.pl will start in tty7 and if it crashes, it
91   should restart ok.
92
93
94   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?
95
96   There are 2 ways to achieve this.  You can use the _\bt_\ba_\bi_\bl command like
97   this ..
98
99
100
101        tail -f /spider/data/debug/167.dat |grep G0VGS
102
103
104
105
106   or in later versions of Spider, there is a command called _\bw_\ba_\bt_\bc_\bh_\bd_\bb_\bg in
107   which case you simply type ..
108
109
110
111        watchdbg G0VGS
112
113
114
115
116
117   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
118   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.
119
120   Assuming that the permissions are set correctly (perm level 5
121   required), it could be that the home_node is set incorrectly.  You can
122   reset the home_node using the _\bs_\bp_\bo_\bo_\bf command like this ..
123
124
125
126        spoof gb7adx set/home gb7adx
127
128
129
130
131   Assuming that the node_call you are changing is gb7adx.
132
133   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-
134   n\bne\ber\brs\bs,\b, w\bwh\bha\bat\bt i\bis\bs w\bwr\bro\bon\bng\bg?\b?
135
136   There is a file in /spider/msg called forward.pl.issue.  Rename this
137   to forward.pl and edit it to meet your requirements.  You will need to
138   issue the command _\bl_\bo_\ba_\bd_\b/_\bf_\bo_\br_\bw_\ba_\br_\bd or restart Spider for the changes to
139   take effect.
140
141
142   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
143   a\bar\bre\be s\bst\bto\bor\bre\bed\bd?\b?
144
145   Use the tmpwatch command.  Add a line in /etc/cron.daily like this ...
146
147
148
149        /usr/sbin/tmpwatch -f 240 /spider/data/debug
150
151
152
153
154   This will limit your debug data down to the last 10 days
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198