Changes to manual namings to standardise. Added script from M0AZM to
[spider.git] / sgml / spiderFAQ_en.sgml
diff --git a/sgml/spiderFAQ_en.sgml b/sgml/spiderFAQ_en.sgml
new file mode 100644 (file)
index 0000000..2ebda13
--- /dev/null
@@ -0,0 +1,159 @@
+<!doctype linuxdoc system>
+
+<article>
+
+<!-- Title information -->
+
+<title>The DXSpider FAQ</title>
+<author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net)</author>
+<date>December 2001 Revision: 1.8</date>
+<abstract>
+A reference for SysOps of the DXSpider DXCluster program.
+</abstract>
+
+<!-- Table of contents -->
+<toc>
+
+<!-- Begin the document -->
+
+<P>Please mail any FAQs to the maintainer at the address above.
+
+<P>
+<sect>Installation 
+
+<sect1>Where do I get DXSpider?
+
+<P>
+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.
+
+<sect1>How do I use the patches?
+
+<P>
+Patching is done in the standard linux way ...
+
+<tscreen><verb>
+zcat /tmp/patch-1.40 | patch -p0
+</verb></tscreen>
+
+<P>
+assuming the patch version you are using is 1.40 and resides in /tmp!
+
+<P>
+Be aware that each patch assumes the previous patch has been applied.  That
+is to say if you are patching from version 1.38 to 1.40 you would first need
+to apply patch-1.39 and then patch-1.40.
+
+<sect1>If I use a tarball to overwrite my installation, what happens to my configuration?
+
+<P>
+The tarballs are designed to not overwrite your existing configuration
+and can be used at any time to update your Spider software.  All the key
+files have the suffix .issue (eg. DXVars.pm.issue) at default.
+
+<sect1>I am running RedHat 5.2 and I am getting strange errors, what is wrong?
+
+<P>
+The version of Perl that comes with 5.2 seems to be some kind of pre-release
+and is broken.  You can get a new version of perl from 
+<htmlurl url="http://www.dxcluster.org/download/index.html" name="www.dxcluster.org"> 
+or <htmlurl url="ftp://updates.redhat.com" name="ftp://updates.redhat.com">.  
+Don't forget to patch it with the CPAN modules.
+
+<sect>Administration
+
+<sect1>How can I get Spider to restart automatically if it crashes?
+
+<P>
+Put this line into /etc/inittab ..
+
+<tscreen><verb>
+DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop > /dev/tty7
+</verb></tscreen>
+
+Run <em>telinit q</em> as root.  Spider will restart so be aware.  However, any
+time you reboot, cluster.pl will start in tty7 and if it crashes, it should restart ok.
+
+<sect1>How can I monitor traffic to and from a node or user?
+
+<P>
+There are 2 ways to achieve this.  You can use the <em>tail</em> command like this ..
+
+<tscreen><verb>
+tail -f /spider/data/debug/167.dat |grep G0VGS
+</verb></tscreen>
+
+or in later versions of Spider, there is a command called <em>watchdbg</em> in which
+case you simply type ..
+
+<tscreen><verb>
+watchdbg G0VGS
+</verb></tscreen>
+
+<sect1>My neighbouring node cannot use the RCMD command to me, he just keeps 
+getting the "tut tut" message.
+
+<P>
+Assuming that the permissions are set correctly (perm level 5 required), it could be
+that the home_node is set incorrectly.  You can reset the home_node using the <em>spoof</em>
+command like this ..
+
+<tscreen><verb>
+spoof gb7adx set/home gb7adx
+</verb></tscreen>
+
+Assuming that the node_call you are changing is gb7adx.
+
+<sect1>I do not seem to be sending any bulletin mail to my link partners, what is wrong?
+
+<P>
+There is a file in /spider/msg called forward.pl.issue.  Rename this to
+forward.pl and edit it to meet your requirements.  You will need to issue
+the command <em>load/forward</em> or restart Spider for the changes to 
+take effect.
+
+<sect1>How can I automatically limit the amount of debug logfiles that are stored?
+
+<P>
+Use the tmpwatch command.  Create a file in /etc/cron.daily/ containing the line ...
+
+<tscreen><verb>
+/usr/sbin/tmpwatch -f 240 /spider/data/debug
+</verb></tscreen>
+
+Remember to make it executable!
+
+This will limit your debug data down to the last 10 days
+
+<sect1>I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem?
+
+<P>
+Almost certainly this is a change in the db format of perl.  Follow these
+few steps to correct the problem.
+
+<itemize>
+<item>stop the cluster (disable any autostart in inittab)
+<item>cd /spider/data
+<item>issue the command perl user_asc
+<item>restart the cluster
+</itemize>
+
+That should solve the problem.
+
+<sect1>Since I last updated I seem to be getting duplicate spots appearing.
+
+<P>
+What has probably happened is that the dupefile has got corrupted in
+some way.  Simply delete the /spider/data/dupefile and restart the
+cluster.  It may take a little time to become fully functional but
+should solve your problem.
+
+<sect1>I have deleted a message but it is still there, why?
+
+<P>
+This is now the way messages are handled for deletion in Spider.  If you
+look closely you will see a 'D' following the message number.  This 
+message is marked for deletion and will be deleted in 2 days if nothing
+further is done.  Optionally you can use the command <em>delete/expunge</em>
+to delete it immediately.
+
+</article>