]> dxcluster.net Git - spider.git/blob - sgml/spiderFAQ_en.sgml
arrange for chat announces only to go to spider nodes
[spider.git] / sgml / spiderFAQ_en.sgml
1 <!doctype linuxdoc system>
2
3 <article>
4
5 <!-- Title information -->
6
7 <title>The DXSpider FAQ</title>
8 <author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net)</author>
9 <date>December 2001 Revision: 1.8</date>
10 <abstract>
11 A reference for SysOps of the DXSpider DXCluster program.
12 </abstract>
13
14 <!-- Table of contents -->
15 <toc>
16
17 <!-- Begin the document -->
18
19 <P>Please mail any FAQs to the maintainer at the address above.
20
21 <P>
22 <sect>Installation 
23
24 <sect1>Where do I get DXSpider?
25
26 <P>
27 All things Spider can be found at <htmlurl url="http://www.dxcluster.org" name="www.dxcluster.org"> and the actual program and patches can be found in the <htmlurl url="http://www.dxcluster.org/download/index.html" name="download"> area.
28
29 <sect1>How do I use the patches?
30
31 <P>
32 Patching is done in the standard linux way ...
33
34 <tscreen><verb>
35 zcat /tmp/patch-1.40 | patch -p0
36 </verb></tscreen>
37
38 <P>
39 assuming the patch version you are using is 1.40 and resides in /tmp!
40
41 <P>
42 Be aware that each patch assumes the previous patch has been applied.  That
43 is to say if you are patching from version 1.38 to 1.40 you would first need
44 to apply patch-1.39 and then patch-1.40.
45
46 <sect1>If I use a tarball to overwrite my installation, what happens to my configuration?
47
48 <P>
49 The tarballs are designed to not overwrite your existing configuration
50 and can be used at any time to update your Spider software.  All the key
51 files have the suffix .issue (eg. DXVars.pm.issue) at default.
52
53 <sect1>I am running RedHat 5.2 and I am getting strange errors, what is wrong?
54
55 <P>
56 The version of Perl that comes with 5.2 seems to be some kind of pre-release
57 and is broken.  You can get a new version of perl from 
58 <htmlurl url="http://www.dxcluster.org/download/index.html" name="www.dxcluster.org"> 
59 or <htmlurl url="ftp://updates.redhat.com" name="ftp://updates.redhat.com">.  
60 Don't forget to patch it with the CPAN modules.
61
62 <sect>Administration
63
64 <sect1>How can I get Spider to restart automatically if it crashes?
65
66 <P>
67 Put this line into /etc/inittab ..
68
69 <tscreen><verb>
70 DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop > /dev/tty7
71 </verb></tscreen>
72
73 Run <em>telinit q</em> as root.  Spider will restart so be aware.  However, any
74 time you reboot, cluster.pl will start in tty7 and if it crashes, it should restart ok.
75
76 <sect1>How can I monitor traffic to and from a node or user?
77
78 <P>
79 There are 2 ways to achieve this.  You can use the <em>tail</em> command like this ..
80
81 <tscreen><verb>
82 tail -f /spider/data/debug/167.dat |grep G0VGS
83 </verb></tscreen>
84
85 or in later versions of Spider, there is a command called <em>watchdbg</em> in which
86 case you simply type ..
87
88 <tscreen><verb>
89 watchdbg G0VGS
90 </verb></tscreen>
91
92 <sect1>My neighbouring node cannot use the RCMD command to me, he just keeps 
93 getting the "tut tut" message.
94
95 <P>
96 Assuming that the permissions are set correctly (perm level 5 required), it could be
97 that the home_node is set incorrectly.  You can reset the home_node using the <em>spoof</em>
98 command like this ..
99
100 <tscreen><verb>
101 spoof gb7adx set/home gb7adx
102 </verb></tscreen>
103
104 Assuming that the node_call you are changing is gb7adx.
105
106 <sect1>I do not seem to be sending any bulletin mail to my link partners, what is wrong?
107
108 <P>
109 There is a file in /spider/msg called forward.pl.issue.  Rename this to
110 forward.pl and edit it to meet your requirements.  You will need to issue
111 the command <em>load/forward</em> or restart Spider for the changes to 
112 take effect.
113
114 <sect1>How can I automatically limit the amount of debug logfiles that are stored?
115
116 <P>
117 Use the tmpwatch command.  Create a file in /etc/cron.daily/ containing the line ...
118
119 <tscreen><verb>
120 /usr/sbin/tmpwatch -f 240 /spider/data/debug
121 </verb></tscreen>
122
123 Remember to make it executable!
124
125 This will limit your debug data down to the last 10 days
126
127 <sect1>I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem?
128
129 <P>
130 Almost certainly this is a change in the db format of perl.  Follow these
131 few steps to correct the problem.
132
133 <itemize>
134 <item>stop the cluster (disable any autostart in inittab)
135 <item>cd /spider/data
136 <item>issue the command perl user_asc
137 <item>restart the cluster
138 </itemize>
139
140 That should solve the problem.
141
142 <sect1>Since I last updated I seem to be getting duplicate spots appearing.
143
144 <P>
145 What has probably happened is that the dupefile has got corrupted in
146 some way.  Simply delete the /spider/data/dupefile and restart the
147 cluster.  It may take a little time to become fully functional but
148 should solve your problem.
149
150 <sect1>I have deleted a message but it is still there, why?
151
152 <P>
153 This is now the way messages are handled for deletion in Spider.  If you
154 look closely you will see a 'D' following the message number.  This 
155 message is marked for deletion and will be deleted in 2 days if nothing
156 further is done.  Optionally you can use the command <em>delete/expunge</em>
157 to delete it immediately.
158
159 </article>