X-Git-Url: http://gb7djk.dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;f=txt%2FspiderFAQ_en.txt;h=30be83e0f8cddb99e00a05bc0fea2fb17cb70080;hb=refs%2Fheads%2Fnew-spawn;hp=315f73cbe57812fed9b6f7712d75aba95f16c91c;hpb=0fcb7df9b5f6b17605f07d965e71d8bc4dee09a0;p=spider.git diff --git a/txt/spiderFAQ_en.txt b/txt/spiderFAQ_en.txt index 315f73cb..30be83e0 100644 --- a/txt/spiderFAQ_en.txt +++ b/txt/spiderFAQ_en.txt @@ -1,6 +1,6 @@ The DXSpider FAQ Ian Maude, G0VGS, (g0vgs@gb7mbc.net) - December 2001 Revision: 1.8 + February 2005 Revision: 1.8 A reference for SysOps of the DXSpider DXCluster program. ______________________________________________________________________ @@ -17,12 +17,15 @@ 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? - 2.5 How can I automatically limit the amount of debug logfiles that are stored? - 2.6 I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem? - 2.7 Since I last updated I seem to be getting duplicate spots appearing. - 2.8 I have deleted a message but it is still there, why? + 2.3 I see spots coming in my debug log, but none go out to the users + 2.4 My neighbouring node cannot use the RCMD command to me, he just keeps getting the "tut tut" message. + 2.5 I do not seem to be sending any bulletin mail to my link partners, what is wrong? + 2.6 How can I automatically limit the amount of debug logfiles that are stored? + 2.7 I updated my Linux distribution and now Spider cannot read the users file or the dupefile, what is the problem? + 2.8 Since I last updated I seem to be getting duplicate spots appearing. + 2.9 I have deleted a message but it is still there, why? + 2.10 I have updated from CVS and I get all sorts of errors when I restart + 2.11 I have done a CVS update, restarted and it says that "fileX" is missing ______________________________________________________________________ @@ -31,15 +34,15 @@ - 11.. IInnssttaallllaattiioonn + 1. Installation - 11..11.. WWhheerree ddoo II ggeett DDXXSSppiiddeerr?? + 1.1. Where do I get DXSpider? All things Spider can be found at www.dxcluster.org and the actual program and patches can be found in the download area. - 11..22.. HHooww ddoo II uussee tthhee ppaattcchheess?? + 1.2. How do I use the patches? Patching is done in the standard linux way ... @@ -57,16 +60,17 @@ first need to apply patch-1.39 and then patch-1.40. - 11..33.. IIff II uussee aa ttaarrbbaallll ttoo oovveerrwwrriittee mmyy iinnssttaallllaattiioonn,, wwhhaatt hhaappppeennss ttoo - mmyy ccoonnffiigguurraattiioonn?? + + 1.3. If I use a tarball to overwrite my installation, what happens to + my configuration? 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. - 11..44.. II aamm rruunnnniinngg RReeddHHaatt 55..22 aanndd II aamm ggeettttiinngg ssttrraannggee eerrrroorrss,, wwhhaatt iiss - wwrroonngg?? + 1.4. I am running RedHat 5.2 and I am getting strange errors, what is + wrong? 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 @@ -74,9 +78,9 @@ it with the CPAN modules. - 22.. AAddmmiinniissttrraattiioonn + 2. Administration - 22..11.. HHooww ccaann II ggeett SSppiiddeerr ttoo rreessttaarrtt aauuttoommaattiiccaallllyy iiff iitt ccrraasshheess?? + 2.1. How can I get Spider to restart automatically if it crashes? Put this line into /etc/inittab .. @@ -86,14 +90,14 @@ - Run _t_e_l_i_n_i_t _q as root. Spider will restart so be aware. However, any + Run telinit q 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. - 22..22.. HHooww ccaann II mmoonniittoorr ttrraaffffiicc ttoo aanndd ffrroomm aa nnooddee oorr uusseerr?? + 2.2. How can I monitor traffic to and from a node or user? - There are 2 ways to achieve this. You can use the _t_a_i_l command like + There are 2 ways to achieve this. You can use the tail command like this .. @@ -102,7 +106,7 @@ - or in later versions of Spider, there is a command called _w_a_t_c_h_d_b_g in + or in later versions of Spider, there is a command called watchdbg in which case you simply type .. @@ -111,12 +115,33 @@ - 22..33.. MMyy nneeiigghhbboouurriinngg nnooddee ccaannnnoott uussee tthhee RRCCMMDD ccoommmmaanndd ttoo mmee,, hhee jjuusstt - kkeeeeppss ggeettttiinngg tthhee ""ttuutt ttuutt"" mmeessssaaggee.. + 2.3. I see spots coming in my debug log, but none go out to the users + + Please check the time on your PC. + + + All spots are checked that they are no more than 15 minutes in the + future and 60 minutes in the past. If your clock on your client prompt + (or console.pl display) is not set to the correct time in GMT (UTC) + and is more than one hour out (say on your local (summer) time) then + the test will fail and no spots will come out. Neither will they be + stored. + + + If you are connected to the internet, most linux distributions have an + implementation of ntpd. The Microsoft Windows 2003, XP, 2000 and NT + machine clock can also be set to be syncronised to an NTP source. + This can be done in the standard time configuration screen. There is + also the simple nettime program for Windows 95/98/ME. + + + + 2.4. My neighbouring node cannot use the RCMD command to me, he just + keeps getting the "tut tut" message. 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 _s_p_o_o_f command like this .. + reset the home_node using the spoof command like this .. @@ -127,17 +152,17 @@ Assuming that the node_call you are changing is gb7adx. - 22..44.. II ddoo nnoott sseeeemm ttoo bbee sseennddiinngg aannyy bbuulllleettiinn mmaaiill ttoo mmyy lliinnkk ppaarrtt-- - nneerrss,, wwhhaatt iiss wwrroonngg?? + 2.5. I do not seem to be sending any bulletin mail to my link part- + ners, what is wrong? 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 _l_o_a_d_/_f_o_r_w_a_r_d or restart Spider for the changes to + issue the command load/forward or restart Spider for the changes to take effect. - 22..55.. HHooww ccaann II aauuttoommaattiiccaallllyy lliimmiitt tthhee aammoouunntt ooff ddeebbuugg llooggffiilleess tthhaatt - aarree ssttoorreedd?? + 2.6. How can I automatically limit the amount of debug logfiles that + are stored? Use the tmpwatch command. Create a file in /etc/cron.daily/ containing the line ... @@ -150,29 +175,31 @@ Remember to make it executable! - This will limit your debug data down to the last 10 days + This will limit your debug data down to the last 10 days. + However, modern versions of DXSpider will do this for you, so this is + now probably unnecessary. - 22..66.. II uuppddaatteedd mmyy LLiinnuuxx ddiissttrriibbuuttiioonn aanndd nnooww SSppiiddeerr ccaannnnoott rreeaadd tthhee - uusseerrss ffiillee oorr tthhee dduuppeeffiillee,, wwhhaatt iiss tthhee pprroobblleemm?? + + 2.7. I updated my Linux distribution and now Spider cannot read the + users file or the dupefile, what is the problem? Almost certainly this is a change in the db format of perl. Follow these few steps to correct the problem. + o stop the cluster (disable any autostart in inittab) - +o stop the cluster (disable any autostart in inittab) - - +o cd /spider/data + o cd /spider/data - +o issue the command perl user_asc + o issue the command: perl user_asc - +o restart the cluster + o restart the cluster That should solve the problem. - 22..77.. SSiinnccee II llaasstt uuppddaatteedd II sseeeemm ttoo bbee ggeettttiinngg dduupplliiccaattee ssppoottss - aappppeeaarriinngg.. + 2.8. Since I last updated I seem to be getting duplicate spots + appearing. What has probably happened is that the dupefile has got corrupted in some way. Simply delete the /spider/data/dupefile and restart the @@ -180,13 +207,115 @@ should solve your problem. - 22..88.. II hhaavvee ddeelleetteedd aa mmeessssaaggee bbuutt iitt iiss ssttiillll tthheerree,, wwhhyy?? + 2.9. I have deleted a message but it is still there, why? 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 - _d_e_l_e_t_e_/_e_x_p_u_n_g_e to delete it immediately. + delete/expunge to delete it immediately. + + + 2.10. I have updated from CVS and I get all sorts of errors when I + restart + + Whenever you update from CVS, a log is displayed. Next to each file + that is downloaded there is a letter, e.g.: + + + + ? fred.pl + ? jim + .. + . + .. + cvs server: Updating perl + P cluster.pl + C Messages + M Internet.pm + U DXProt.pm + .. + . + .. + + + + For normal CVS use you should only ever see the letters 'P', 'U' or + '?'. The letter 'P' means that the file has changed in CVS and is more + recent than the one that is currently on your system. You will also + see the letter '?', which means that there is a file that you (or the + system) has created that CVS doesn't know about and isn't under its + control. These are all normal and good. + + + Sometimes you will see the letter 'U' next to a file. This means that + it is a new file that you don't currently have. This is also OK. + + However, if you see the letter 'C' or 'M', that means that CVS thinks + that the file has changed locally. For the letter 'C', it has changed + sufficiently near to one or more modifications which CVS wants to + download to your system. For the 'M', CVS thinks that it is OK to make + the change (you may also see some messages about "merging revision + 1.xx with 1.yy"). Neither of these things are good. Files that are + under the control of CVS must not be changed by sysops. It is the + files that have the 'C' next to them that will show the errors that + you are complaining about and they will be things like:- + + + + Syntax error near '<<<<' at line 23 + Syntax error near '===' at line 40 + Syntax error near '>>>' at line 51 + + + + You will not necessarily see all of the errors shown but you will get + one or more sets of some of them. The cure is simple: + + + o identify the file that is causing the problem. + + o remove the file. + + o run the cvs update again. + + + You will see that file come back (with a letter 'U' next to it). That + will be the correct file as CVS thinks it should be. If you still have + a problem, then get onto the dxspider-support mailing list. + + + If all else fails (or you have several conflicts) you can safely + remove the entire /spider/perl and /spider/cmd directories and then + run the cvs update. They will all be recreated in their pristine + condition. + + + 2.11. I have done a CVS update, restarted and it says that "fileX" is + missing + + The correct way to run cvs is:- + + + + cd /spider + cvs -z3 update -d + + + + The '-d' is crucial. It makes sure that any new directories, that may + contain new code, are created and that new code downloaded. I have + absolutely no idea why this is not the default, seeing as CVS (in + other circumstances) happily recurses its merry way down a directory + tree, but there you are. + + + WinCVS and other graphical CVS frontends have a checkbox for the + update screen called something like "create sub-directories" (it may + be hidden in some sub-screen - go look for it if it isn't obvious). + Make sure that this box is checked. If you can make this the default + setting in the program's setup screen then please do that. It will + save you a lot of pulled hair.