Added a txt directory for text versions of manuals
[spider.git] / txt / spiderFAQ.txt
diff --git a/txt/spiderFAQ.txt b/txt/spiderFAQ.txt
new file mode 100644 (file)
index 0000000..20cfae6
--- /dev/null
@@ -0,0 +1,198 @@
+  The DXSpider FAQ
+  Ian Maude, G0VGS, (ianmaude@btinternet.com)
+  Version 0.2 July 2000
+
+  A reference for SysOps of the DXSpider DXCluster program.
+  ______________________________________________________________________
+
+  Table of Contents
+
+
+  1. Installation
+
+     1.1 Where do I get DXSpider?
+     1.2 How do I use the patches?
+     1.3 If I use a tarball to overwrite my installation, what happens to my configuration?
+     1.4 I am running RedHat 5.2 and I am getting strange errors, what is wrong?
+
+  2. Administration
+
+     2.1 How can I get Spider to restart automatically if it crashes?
+     2.2 How can I monitor traffic to and from a node or user?
+     2.3 My neighbouring node cannot use the RCMD command to me, he just keeps getting the "tut tut" message.
+     2.4 I do not seem to be sending any bulletin mail to my link partners, what is wrong?
+
+
+  ______________________________________________________________________
+
+  Please mail any FAQs to the maintainer at the address above.
+
+
+
+  1\b1.\b.  I\bIn\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn
+
+  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?
+
+  All things Spider can be found at www.dxcluster.org and the actual
+  program and patches can be found in the download area.
+
+
+  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?
+
+  Patching is done in the standard linux way ...
+
+
+
+       zcat /tmp/patch-1.40 | patch -p0
+
+
+
+
+
+  assuming the patch version you are using is 1.40 and resides in /tmp!
+
+
+  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.
+
+
+  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
+  m\bmy\by c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn?\b?
+
+  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.
+
+  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
+  w\bwr\bro\bon\bng\bg?\b?
+
+  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
+  www.dxcluster.org or ftp://updates.redhat.com.  Don't forget to patch
+  it with the CPAN modules.
+
+
+  2\b2.\b.  A\bAd\bdm\bmi\bin\bni\bis\bst\btr\bra\bat\bti\bio\bon\bn
+
+  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?
+
+  Put this line into /etc/inittab ..
+
+
+
+       DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop > /dev/tty7
+
+
+
+
+  Run _\bt_\be_\bl_\bi_\bn_\bi_\bt _\bq 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.
+
+
+  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?
+
+  There are 2 ways to achieve this.  You can use the _\bt_\ba_\bi_\bl command like
+  this ..
+
+
+
+       tail -f /spider/data/debug/167.dat |grep G0VGS
+
+
+
+
+  or in later versions of Spider, there is a command called _\bw_\ba_\bt_\bc_\bh_\bd_\bb_\bg in
+  which case you simply type ..
+
+
+
+       watchdbg G0VGS
+
+
+
+
+
+  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
+  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.
+
+  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 _\bs_\bp_\bo_\bo_\bf command like this ..
+
+
+
+       spoof gb7adx set/home gb7adx
+
+
+
+
+  Assuming that the node_call you are changing is gb7adx.
+
+  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-
+  n\bne\ber\brs\bs,\b, w\bwh\bha\bat\bt i\bis\bs w\bwr\bro\bon\bng\bg?\b?
+
+  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
+  restart Spider for the changes to take effect.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+