html/spiderFAQ_en-2.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <HTML>
   3 <HEAD>
   4  <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
   5  <TITLE>The DXSpider FAQ: Administration</TITLE>
   6  <LINK HREF="spiderFAQ_en-1.html" REL=previous>
   7  <LINK HREF="spiderFAQ_en.html#toc2" REL=contents>
   8 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
   9 </HEAD>
  10 <BODY>
  11 Next
  12 <A HREF="spiderFAQ_en-1.html">Previous</A>
  13 <A HREF="spiderFAQ_en.html#toc2">Contents</A>
  14 <HR>
  15 <H2><A NAME="s2">2.</A> <A HREF="spiderFAQ_en.html#toc2">Administration</A></H2>
  16
  17 <H2><A NAME="ss2.1">2.1</A> <A HREF="spiderFAQ_en.html#toc2.1">How can I get Spider to restart automatically if it crashes?</A>
  18 </H2>
  19
  20 <P>Put this line into /etc/inittab ..</P>
  21 <P>
  22 <BLOCKQUOTE><CODE>
  23 <PRE>
  24 DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop > /dev/tty7
  25 </PRE>
  26 </CODE></BLOCKQUOTE>
  27 </P>
  28 <P>Run <EM>telinit q</EM> as root.  Spider will restart so be aware.  However, any
  29 time you reboot, cluster.pl will start in tty7 and if it crashes, it should restart ok.</P>
  30
  31 <H2><A NAME="ss2.2">2.2</A> <A HREF="spiderFAQ_en.html#toc2.2">How can I monitor traffic to and from a node or user?</A>
  32 </H2>
  33
  34 <P>There are 2 ways to achieve this.  You can use the <EM>tail</EM> command like this ..</P>
  35 <P>
  36 <BLOCKQUOTE><CODE>
  37 <PRE>
  38 tail -f /spider/data/debug/167.dat |grep G0VGS
  39 </PRE>
  40 </CODE></BLOCKQUOTE>
  41 </P>
  42 <P>or in later versions of Spider, there is a command called <EM>watchdbg</EM> in which
  43 case you simply type ..</P>
  44 <P>
  45 <BLOCKQUOTE><CODE>
  46 <PRE>
  47 watchdbg G0VGS
  48 </PRE>
  49 </CODE></BLOCKQUOTE>
  50 </P>
  51
  52 <H2><A NAME="ss2.3">2.3</A> <A HREF="spiderFAQ_en.html#toc2.3">I see spots coming in my debug log, but none go out to the users</A>
  53 </H2>
  54
  55 <P>Please check the time on your PC. </P>
  56
  57 <P>All spots are checked that they are no more
  58 than 15 minutes in the future and 60 minutes in the past. If your clock on your client
  59 prompt (or console.pl display) is not set to the correct time
  60 in GMT (UTC) and is more than one hour out (say on your local (summer) time) then
  61 the test will fail and no spots will come out. Neither will they be stored.</P>
  62
  63 <P>If you are connected to the internet, most linux distributions have an implementation of
  64 <A HREF="http://www.ntp.org">ntpd</A>. The Microsoft Windows 2003, XP,
  65 2000 and NT machine clock can also be set to be syncronised
  66 to an NTP source.  This can be done in the standard time configuration screen. There is also
  67 the simple
  68 <A HREF="http://nettime.sourceforge.net">nettime</A> program for Windows 95/98/ME.</P>
  69
  70
  71 <H2><A NAME="ss2.4">2.4</A> <A HREF="spiderFAQ_en.html#toc2.4">My neighbouring node cannot use the RCMD command to me, he just keeps getting the "tut tut" message.</A>
  72 </H2>
  73
  74 <P>Assuming that the permissions are set correctly (perm level 5 required), it could be
  75 that the home_node is set incorrectly.  You can reset the home_node using the <EM>spoof</EM>
  76 command like this ..</P>
  77 <P>
  78 <BLOCKQUOTE><CODE>
  79 <PRE>
  80 spoof gb7adx set/home gb7adx
  81 </PRE>
  82 </CODE></BLOCKQUOTE>
  83 </P>
  84 <P>Assuming that the node_call you are changing is gb7adx.</P>
  85
  86 <H2><A NAME="ss2.5">2.5</A> <A HREF="spiderFAQ_en.html#toc2.5">I do not seem to be sending any bulletin mail to my link partners, what is wrong?</A>
  87 </H2>
  88
  89 <P>There is a file in /spider/msg called forward.pl.issue.  Rename this to
  90 forward.pl and edit it to meet your requirements.  You will need to issue
  91 the command <EM>load/forward</EM> or restart Spider for the changes to
  92 take effect.</P>
  93
  94 <H2><A NAME="ss2.6">2.6</A> <A HREF="spiderFAQ_en.html#toc2.6">How can I automatically limit the amount of debug logfiles that are stored?</A>
  95 </H2>
  96
  97 <P>Use the tmpwatch command.  Create a file in /etc/cron.daily/ containing the line ...</P>
  98 <P>
  99 <BLOCKQUOTE><CODE>
 100 <PRE>
 101 /usr/sbin/tmpwatch -f 240 /spider/data/debug
 102 </PRE>
 103 </CODE></BLOCKQUOTE>
 104 </P>
 105 <P>Remember to make it executable!</P>
 106 <P>This will limit your debug data down to the last 10 days. </P>
 107 <P>However, modern versions of DXSpider will do this for you, so this is now probably unnecessary.</P>
 108
 109 <H2><A NAME="ss2.7">2.7</A> <A HREF="spiderFAQ_en.html#toc2.7">I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem?</A>
 110 </H2>
 111
 112 <P>Almost certainly this is a change in the db format of perl.  Follow these
 113 few steps to correct the problem.</P>
 114 <P>
 115 <UL>
 116 <LI>stop the cluster (disable any autostart in inittab)</LI>
 117 <LI>cd /spider/data</LI>
 118 <LI>issue the command: perl user_asc</LI>
 119 <LI>restart the cluster</LI>
 120 </UL>
 121 </P>
 122 <P>That should solve the problem.</P>
 123
 124 <H2><A NAME="ss2.8">2.8</A> <A HREF="spiderFAQ_en.html#toc2.8">Since I last updated I seem to be getting duplicate spots appearing.</A>
 125 </H2>
 126
 127 <P>What has probably happened is that the dupefile has got corrupted in
 128 some way.  Simply delete the /spider/data/dupefile and restart the
 129 cluster.  It may take a little time to become fully functional but
 130 should solve your problem.</P>
 131
 132 <H2><A NAME="ss2.9">2.9</A> <A HREF="spiderFAQ_en.html#toc2.9">I have deleted a message but it is still there, why?</A>
 133 </H2>
 134
 135 <P>This is now the way messages are handled for deletion in Spider.  If you
 136 look closely you will see a 'D' following the message number.  This
 137 message is marked for deletion and will be deleted in 2 days if nothing
 138 further is done.  Optionally you can use the command <EM>delete/expunge</EM>
 139 to delete it immediately.</P>
 140
 141 <H2><A NAME="ss2.10">2.10</A> <A HREF="spiderFAQ_en.html#toc2.10">I have updated from CVS and I get all sorts of errors when I restart</A>
 142 </H2>
 143
 144 <P>Whenever you update from CVS, a log is displayed. Next to each
 145 file that is downloaded there is a letter, e.g.:</P>
 146 <P>
 147 <BLOCKQUOTE><CODE>
 148 <PRE>
 149 ? fred.pl
 150 ? jim
 151 ..
 152 .
 153 ..
 154 cvs server: Updating perl
 155 P cluster.pl
 156 C Messages
 157 M Internet.pm
 158 U DXProt.pm
 159 ..
 160 .
 161 ..
 162 </PRE>
 163 </CODE></BLOCKQUOTE>
 164 </P>
 165
 166 <P>For normal CVS use you should only ever see the letters 'P', 'U' or '?'. The
 167 letter 'P' means that the file has
 168 changed in CVS and is more recent than the one that is currently on your system. You will also
 169 see the letter '?', which means that
 170 there is a file that you (or the system) has created that CVS doesn't know about and isn't
 171 under its control. These are all normal and good.</P>
 172
 173 <P>Sometimes you will see the letter 'U' next to a file. This means that it is a new file that you don't currently
 174 have. This is also OK.</P>
 175
 176 <P>However, if you see the letter 'C' or 'M', that means that CVS thinks that the file has
 177 changed locally. For the letter 'C', it has changed sufficiently near to one or more
 178 modifications which CVS wants to download to your system. For the 'M', CVS thinks that it
 179 is OK to make the change (you may also see some messages about "merging revision 1.xx with 1.yy").
 180 Neither of these things are good. Files that are under the control of CVS
 181 must not be changed by sysops. It is the files that have the 'C' next to them that will show
 182 the errors that you are complaining about and they will be things like:-</P>
 183 <P>
 184 <BLOCKQUOTE><CODE>
 185 <PRE>
 186 Syntax error near '&lt;&lt;&lt;&lt;' at line 23
 187 Syntax error near '===' at line 40
 188 Syntax error near '>>>' at line 51
 189 </PRE>
 190 </CODE></BLOCKQUOTE>
 191 </P>
 192
 193 <P>You will not necessarily see all of the errors shown but you will get one or more sets of some
 194 of them. The cure is simple: </P>
 195 <P>
 196 <UL>
 197 <LI> identify the file that is causing the problem.  </LI>
 198 <LI> remove the file.</LI>
 199 <LI> run the cvs update again.</LI>
 200 </UL>
 201 </P>
 202
 203 <P>You will see that file come back (with a letter 'U' next to it). That will be the correct
 204 file as CVS thinks it should be. If you <EM>still</EM> have a problem, then get onto the
 205 dxspider-support mailing list.</P>
 206
 207 <P>If all else fails (or you have several conflicts) you can safely remove the entire <CODE>/spider/perl</CODE> and
 208 <CODE>/spider/cmd</CODE> directories and then run the cvs update. They will all be recreated in their pristine
 209 condition.</P>
 210
 211 <H2><A NAME="ss2.11">2.11</A> <A HREF="spiderFAQ_en.html#toc2.11">I have done a CVS update, restarted and it says that "fileX" is missing</A>
 212 </H2>
 213
 214 <P>The correct way to run cvs is:-</P>
 215 <P>
 216 <BLOCKQUOTE><CODE>
 217 <PRE>
 218 cd /spider
 219 cvs -z3 update -d
 220 </PRE>
 221 </CODE></BLOCKQUOTE>
 222 </P>
 223
 224 <P>The '-d' is crucial. It makes sure that any new directories, that may contain new code,
 225 are created and that new code downloaded. I have absolutely no idea why this is not the
 226 default, seeing as CVS (in other circumstances) happily recurses its merry way down a
 227 directory tree, but there you are.</P>
 228
 229 <P>WinCVS and other graphical CVS frontends have a checkbox for the update screen called something
 230 like "create sub-directories" (it may be hidden in some sub-screen - go look for it if it isn't
 231 obvious). Make sure that this box is checked. If you can make this the
 232 default setting in the program's setup screen then please do that. It will save you a lot
 233 of pulled hair. </P>
 234
 235 <HR>
 236 Next
 237 <A HREF="spiderFAQ_en-1.html">Previous</A>
 238 <A HREF="spiderFAQ_en.html#toc2">Contents</A>
 239 </BODY>
 240 </HTML>