From: minima
+On most modern distributions most (if not all) the modules you will need are either included or +can be loaded automatically. Please consult your distro's instructions for loading new programs +and look for modules that usually start with the string "perl-". For instance:-
++
Some distros are now packaging perl-DB_File separately as well, so you may have to add that to the list +above.
+Copy the CPAN modules listed above to a convenient place on your computer. One good place would be /usr/local/packages, and the instructions which follow will assume that that's where you have put them.
@@ -64,8 +80,8 @@ that's where you have put them.Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
-# tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz -# cd TimeDate-1.10 +# tar xvfz /usr/local/packages/TimeDate-2.27.tar.gz +# cd TimeDate-2.27 # perl Makefile.PL # make test # make install @@ -78,8 +94,8 @@ that's where you have put them. # make install # cd .. # -# tar xvfz /usr/local/packages/Curses-1.06.tar.gz -# cd Curses-1.06 +# tar xvfz /usr/local/packages/Curses-1.08a.tar.gz +# cd Curses-1.08a # perl Makefile.PL # make test # make install @@ -101,7 +117,7 @@ that's where you have put them.-
Only if you need to do these (because your perl is old):-
+Only if you need to do these because your perl is old:-
# diff --git a/html/installation_en-4.html b/html/installation_en-4.html index 96ebacec..cfb04511 100644 --- a/html/installation_en-4.html +++ b/html/installation_en-4.html @@ -20,77 +20,97 @@This is dealt with in the previous section
-4.2 Allowing telnet connects from users +
4.2 Setting up telnet connects (from 1.47 onwards)
-->From version 1.47 there is a new (more efficient) way of doing this -(see next section) but, if you prefer, the method of doing it described -here will continue to work just fine.
+>From version 1.47 you can choose to allow the perl cluster.pl program to +allow connections directly (i.e. not via the
-/spider/src/client
+interface program). If you are using Windows then this is the only method +available of allowing incoming telnet connections.Allowing telnet connections is quite simple. Firstly you need to add a line -in /etc/services to allow connections to a port number, like this ....
+to make the change happen...
+ +Having done that, you need to copy the file +/spider/perl/Listeners.pm to /spider/local and +then edit it. You will need to uncomment the line containing "0.0.0.0" +and select the correct port to listen on.
+It comes out of the box looking something like:-
- -
-spdlogin 8000/tcp # spider anonymous login port +@listen = ( +# ["0.0.0.0", 7300], +);Then add a line in /etc/inetd.conf like this ....
+Change it so that it looks like this:-
-
-spdlogin stream tcp nowait root /usr/sbin/tcpd /spider/src/client login telnet +@listen = ( + ["0.0.0.0", 7300], +);Once this is done, you need to restart inetd like this ....
+Later versions have more comments in the Listeners.pm file that +are designed to help you remove the correct '#' character.
+ +As standard, the listener will listen on all interfaces simultaneously. +If you require more control than this, you can specify each interface +individually:-
-
-killall -HUP inetd +@listen = ( + ["gb7baa.dxcluster.net", 7300], + ["44.131.16.2", 6300], +);Now login as sysop and cd spider/src. You can test that spider -is accepting telnet logins by issuing the following command ....
+This will only be successful if the IP addresses on each interface are static. +If you are using some kind of dynamic IP addressing then the 'default' method +is the only one that will work.
+ +Restart the cluster.pl program to enable the listener.
+ +One important difference with the internal listener is that no echoing +is done by the cluster program. Users will need to set 'local-echo' on in +their telnet clients if it isn't set automatically (as per the standards). +Needless to say this will probably only apply to Windows users.
+ +4.3 Allowing telnet connects from users (before version 1.47 or for special purposes) +
+ ++>From version 1.47 there is a new (more efficient) way of doing this +(see previous section) but, if you prefer, the method of doing it described +here will continue to work just fine.
+ +Allowing telnet connections is quite simple. Firstly you need to add a line +in /etc/services to allow connections to a port number, like this ....
-
-./client login telnet +spdlogin 8000/tcp # spider anonymous login portYou should get a login prompt and on issuing a callsign, you will be given -access to the cluster. Note, you will not get a password login. There seems -no good reason for a password prompt to be given so it is not asked for.
- -Assuming all is well, then try a telnet from your linux console ....
+Then add a line in /etc/inetd.conf like this ....
-
-telnet localhost 8000 +spdlogin stream tcp nowait root /usr/sbin/tcpd /spider/src/client login telnetYou should now get the login prompt and be able to login as before.
- -4.3 Setting up telnet connects (from 1.47 onwards) -
- ->From version 1.47 you can choose to allow the perl cluster.pl program to -allow connections directly (i.e. not via the
- -/spider/src/client
-interface program). If you are using Windows then this is the only method -available of allowing incoming telnet connections.To do this you need first to remove any line that you may previously have set -up in /etc/inetd.conf. Remember to:-
+Once this is done, you need to restart inetd like this ....
-
@@ -99,46 +119,31 @@ killall -HUP inetdto make the change happen...
- -Having done that, you need to copy the file -/spider/perl/Listeners.pm to /spider/local and -then edit it. You will need to uncomment the line containing "0.0.0.0" -and select the correct port to listen on. So that it looks like this:-
+Now login as sysop and cd spider/src. You can test that spider +is accepting telnet logins by issuing the following command ....
-
-@listen = ( - ["0.0.0.0", 8000], -); +./client login telnetAs standard, the listener will listen on all interfaces simultaneously. -If you require more control than this, you can specify each interface -individually:-
+You should get a login prompt and on issuing a callsign, you will be given +access to the cluster. Note, you will not get a password login. There seems +no good reason for a password prompt to be given so it is not asked for.
+ +Assuming all is well, then try a telnet from your linux console ....
-
-@listen = ( - ["gb7baa.dxcluster.net", 8000], - ["44.131.16.2", 6300], -); +telnet localhost 8000This will only be successful if the IP addresses on each interface are static. -If you are using some kind of dynamic IP addressing then the 'default' method -is the only one that will work.
- -Restart the cluster.pl program to enable the listener.
+You should now get the login prompt and be able to login as before.
-One important difference with the internal listener is that no echoing -is done by the cluster program. Users will need to set 'local-echo' on in -their telnet clients if it isn't set automatically (as per the standards). -Needless to say this will probably only apply to Windows users.
4.4 Setting up for AGW Engine (1.47 onwards)
diff --git a/html/installation_en.html b/html/installation_en.html index 31d730c7..156c8b50 100644 --- a/html/installation_en.html +++ b/html/installation_en.html @@ -55,8 +55,8 @@ Carroll, K1XX, (k1xx@ptcnh.net)March 2003 revision 0.7
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.
+files have the suffix .issue (eg. DXVars.pm.issue) at default.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 is not set -to GMT (UTC) and is more than one hour out (say on your local (summer) time) then +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 @@ -102,7 +103,8 @@ take effect.
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.
Firstly, whenever you update from CVS, a log is displayed. Next to each +
Whenever you update from CVS, a log is displayed. Next to each file that is downloaded there is a letter, e.g.:
@@ -161,9 +163,10 @@ U DXProt.pm
-For normal CVS use you should only ever see the letter 'P'. This means that the file has -changed in CVS and is more recent than the one that is currenly on your system. You may also -possibly see the letter '?', which means that +
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.
@@ -176,7 +179,7 @@ modifications which CVS wants to download to your system. For the 'M', CVS think 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 and they will be things like:- +the errors that you are complaining about and they will be things like:-
@@ -187,7 +190,7 @@ Syntax error near '>>>' at line 51
-You will now necessarily see all of the errors shown but you will get one or more sets of some +
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:
The '-d' is crucial. It makes sure that any new directories that may contain new code +
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.
diff --git a/html/spiderFAQ_en.html b/html/spiderFAQ_en.html index b6273302..5fd8edcc 100644 --- a/html/spiderFAQ_en.html +++ b/html/spiderFAQ_en.html @@ -44,7 +44,7 @@ Contents
+On most modern distributions most (if not all) the modules you will need are either included or
+can be loaded automatically. Please consult your distro's instructions for loading new programs
+and look for modules that usually start with the string "perl-". For instance:-
+
+
+Some distros are now packaging perl-DB_File separately as well, so you may have to add that to the list +above. +
Copy the CPAN modules listed above to a convenient place on your computer. One good
place would be /usr/local/packages, and the instructions which follow will assume that
@@ -66,8 +82,8 @@ that's where you have put them.
Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
-Only if you need to do these (because your perl is old):-
+Only if you need to do these because your perl is old:-
This is dealt with in the previous section
-
+>From version 1.47 you can choose to allow the perl cluster.pl program to
+allow connections directly (i.e. not via the /spider/src/client
+interface program). If you are using Windows then this is the only method
+available of allowing incoming telnet connections.
+
+
+to make the change happen...
+
+
+Having done that, you need to copy the file
+/spider/perl/Listeners.pm to /spider/local and
+then edit it. You will need to uncomment the line containing &dquot;0.0.0.0&dquot;
+and select the correct port to listen on.
+
+It comes out of the box looking something like:-
+
+
+Later versions have more comments in the Listeners.pm file that
+are designed to help you remove the correct '#' character.
+
+
+As standard, the listener will listen on all interfaces simultaneously.
+If you require more control than this, you can specify each interface
+individually:-
+
+
+This will only be successful if the IP addresses on each interface are static.
+If you are using some kind of dynamic IP addressing then the 'default' method
+is the only one that will work.
+
+
+Restart the cluster.pl program to enable the listener.
+
+
+One important difference with the internal listener is that no echoing
+is done by the cluster program. Users will need to set 'local-echo' on in
+their telnet clients if it isn't set automatically (as per the standards).
+Needless to say this will probably only apply to Windows users.
+
+
>From version 1.47 there is a new (more efficient) way of doing this
-(see next section) but, if you prefer, the method of doing it described
+(see previous section) but, if you prefer, the method of doing it described
here will continue to work just fine.
@@ -945,62 +1024,6 @@ telnet localhost 8000
You should now get the login prompt and be able to login as before.
-
->From version 1.47 you can choose to allow the perl cluster.pl program to
-allow connections directly (i.e. not via the /spider/src/client
-interface program). If you are using Windows then this is the only method
-available of allowing incoming telnet connections.
-
-
-To do this you need first to remove any line that you may previously have set
-up in /etc/inetd.conf. Remember to:-
-
-
-to make the change happen...
-
-
-Having done that, you need to copy the file
-/spider/perl/Listeners.pm to /spider/local and
-then edit it. You will need to uncomment the line containing &dquot;0.0.0.0&dquot;
-and select the correct port to listen on. So that it looks like this:-
-
-
-As standard, the listener will listen on all interfaces simultaneously.
-If you require more control than this, you can specify each interface
-individually:-
-
-
-This will only be successful if the IP addresses on each interface are static.
-If you are using some kind of dynamic IP addressing then the 'default' method
-is the only one that will work.
-
-
-Restart the cluster.pl program to enable the listener.
-
-
-One important difference with the internal listener is that no echoing
-is done by the cluster program. Users will need to set 'local-echo' on in
-their telnet clients if it isn't set automatically (as per the standards).
-Needless to say this will probably only apply to Windows users.
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.
+files have the suffix .issue (eg. DXVars.pm.issue) at default.
All spots are checked that they are no more
-than 15 minutes in the future and 60 minutes in the past. If your clock is not set
-to GMT (UTC) and is more than one hour out (say on your local (summer) time) then
+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.
@@ -141,7 +142,9 @@ Use the tmpwatch command. Create a file in /etc/cron.daily/ containing the line
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.
-Firstly, whenever you update from CVS, a log is displayed. Next to each
+Whenever you update from CVS, a log is displayed. Next to each
file that is downloaded there is a letter, e.g.:
-For normal CVS use you should only ever see the letter 'P'. This means that the file has
-changed in CVS and is more recent than the one that is currenly on your system. You may also
-possibly see the letter '?', which means that
+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.
@@ -215,7 +219,7 @@ modifications which CVS wants to download to your system. For the 'M', CVS think
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 and they will be things like:-
+the errors that you are complaining about and they will be things like:-
-You will now necessarily see all of the errors shown but you will get one or more sets of some
+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:
-The '-d' is crucial. It makes sure that any new directories that may contain new code +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. diff --git a/txt/installation_en.txt b/txt/installation_en.txt index ac606c76..35b28889 100644 --- a/txt/installation_en.txt +++ b/txt/installation_en.txt @@ -33,8 +33,8 @@ 4. Configuration 4.1 Allowing ax25 connects from users - 4.2 Allowing telnet connects from users - 4.3 Setting up telnet connects (from 1.47 onwards) + 4.2 Setting up telnet connects (from 1.47 onwards) + 4.3 Allowing telnet connects from users (before version 1.47 or for special purposes) 4.4 Setting up for AGW Engine (1.47 onwards) 4.5 Setting up node connects 4.6 Connection scripts @@ -95,19 +95,41 @@ o Data-Dumper-2.101.tar.gz [4mthis[24m [4mis[24m [4mincluded[24m [4min[24m [4mperl[24m [4m5.6.1[24m [4mand[24m [4mabove[0m - o TimeDate-1.10.tar.gz + o TimeDate-2.27.tar.gz o IO-1.20.tar.gz ([4mfor[24m [4mperl[24m [4m5.00403[24m [4mand[24m [4mlower[24m) o Net-Telnet-3.03.tar.gz - o Curses-1.06.tar.gz + o Curses-1.08a.tar.gz - o Time-HiRes-01.20.tar.gz + o Time-HiRes-01.20.tar.gz ([4mfor[24m [4mperl[24m [4mversions[24m [4mlower[24m [4mthan[24m [4m5.8[24m ) o Digest-SHA1-2.01.tar.gz + + On most modern distributions most (if not all) the modules you will + need are either included or can be loaded automatically. Please + consult your distro's instructions for loading new programs and look + for modules that usually start with the string "perl-". For instance:- + + + o Mandrake: urpmi perl-TimeDate perl-Digest-SHA1 perl-Curses perl- + Net-Telnet + + o Redhat/Fedora: up2date perl-TimeDate perl-Digest-SHA1 perl-Curses + perl-Net-Telnet + + o SuSE: use yast + + o Debian: use apt-get + + + Some distros are now packaging perl-DB_File separately as well, so you + may have to add that to the list above. + + Copy the CPAN modules listed above to a convenient place on your computer. One good place would be /usr/local/packages, and the instructions which follow will assume that that's where you have put @@ -118,9 +140,8 @@ Here are exactly the commands you must issue next: - - - # tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz - # cd TimeDate-1.10 + # tar xvfz /usr/local/packages/TimeDate-2.27.tar.gz + # cd TimeDate-2.27 # perl Makefile.PL # make test # make install @@ -133,8 +154,8 @@ # make install # cd .. # - # tar xvfz /usr/local/packages/Curses-1.06.tar.gz - # cd Curses-1.06 + # tar xvfz /usr/local/packages/Curses-1.08a.tar.gz + # cd Curses-1.08a # perl Makefile.PL # make test # make install @@ -156,7 +177,8 @@ - Only if you need to do these (because your perl is old):- + Only if you need to do these because your perl is old:- + # @@ -220,8 +242,6 @@ # Retype new UNIX password: passwd: all authentication tokens updated successfully - - [1m1.3. Installing the software[0m Now to unpack the DX Spider distribution, set symbolic links and group @@ -241,7 +261,7 @@ - # vi /etc/group (or your favorite editor) + # vi /etc/group (or your favorite editor) @@ -299,6 +319,9 @@ Using the distributed DXVars.pm as a a template, set your cluster callsign, sysop callsign and other user info to suit your own environment. + + + $mycall = "GB7DJK"; @@ -396,7 +419,6 @@ $ ./client - This should log you into the cluster as the sysop under the alias callsign we set earlier. In this case the callsign is G0VGS. The cluster callsign is set in the DXVars.pm file in /spider/local. In @@ -415,7 +437,7 @@ - shutdown + shutdown @@ -478,7 +500,6 @@ o Enter the correct line in /etc/services (root) - o Enter the correct line in /etc/inetd.conf (root) o killall -HUP inetd (root) @@ -526,7 +547,6 @@ more comprehensive and an interesting configuration program is also available called ax25-config which may help you to configure things. - The following files are extracts from the working files at GB7MBC and are in daily use. However, there are many ways that you can configure the ax25 utils, this is just the one I use, it does not mean it is @@ -545,6 +565,8 @@ There are 2 main node packages in use of which I shall keep to the original by Tomi Manninen, OH2BNS as this is included in the ax25 rpms as standard. The other is AWZNode by IZ5AWZ. + + NB: The AX25 stuff in 2.4 kernels appears to have been broken until 2.4.18. I strongly suggest you get at least this kernel. @@ -591,7 +613,6 @@ rpm -ivh ax25-apps-0.0.4-9.i386.rpm - [1m3.4. Configuration[0m You will find the configuration files in /etc/ax25. These consist of @@ -655,9 +676,9 @@ - #portname callsign alias paclen description - netrom gb7mbc-8 BARE 236 Node Netrom Port - netrom2 gb7mbc-9 MBCDX 236 Cluster Netrom Port + #portname callsign alias paclen description + netrom gb7mbc-8 BARE 236 Node Netrom Port + netrom2 gb7mbc-9 MBCDX 236 Cluster Netrom Port @@ -667,7 +688,6 @@ The file headings are as follows ... - portname - The name you will refer to the port by callsign - This is the callsign that NET/ROM traffic from this port will use @@ -1018,123 +1038,131 @@ This is dealt with in the previous section - [1m4.2. Allowing telnet connects from users[0m + [1m4.2. Setting up telnet connects (from 1.47 onwards)[0m + >From version 1.47 you can choose to allow the perl cluster.pl program + to allow connections directly (i.e. not via the /spider/src/client + interface program). If you are using Windows then this is the only + method available of allowing incoming telnet connections. - >From version 1.47 there is a new (more efficient) way of doing this - (see next section) but, if you prefer, the method of doing it - described here will continue to work just fine. + to make the change happen... - Allowing telnet connections is quite simple. Firstly you need to add - a line in /etc/services to allow connections to a port number, like - this .... + Having done that, you need to copy the file [4m/spider/perl/Listeners.pm[0m + to [4m/spider/local[24m and then edit it. You will need to uncomment the line + containing "0.0.0.0" and select the correct port to listen on. + It comes out of the box looking something like:- - spdlogin 8000/tcp # spider anonymous login port + @listen = ( + # ["0.0.0.0", 7300], + ); - Then add a line in /etc/inetd.conf like this .... - spdlogin stream tcp nowait root /usr/sbin/tcpd /spider/src/client login telnet + Change it so that it looks like this:- - Once this is done, you need to restart inetd like this .... + @listen = ( + ["0.0.0.0", 7300], + ); - killall -HUP inetd + Later versions have more comments in the Listeners.pm file that are + designed to help you remove the correct '#' character. - Now login as [4msysop[24m and cd spider/src. You can test that spider is - accepting telnet logins by issuing the following command .... + As standard, the listener will listen on all interfaces + simultaneously. If you require more control than this, you can + specify each interface individually:- - ./client login telnet + @listen = ( + ["gb7baa.dxcluster.net", 7300], + ["44.131.16.2", 6300], + ); - You should get a login prompt and on issuing a callsign, you will be - given access to the cluster. Note, you will not get a password login. - There seems no good reason for a password prompt to be given so it is - not asked for. + This will only be successful if the IP addresses on each interface are + static. If you are using some kind of dynamic IP addressing then the + 'default' method is the only one that will work. - Assuming all is well, then try a telnet from your linux console .... + Restart the cluster.pl program to enable the listener. + One important difference with the internal listener is that no echoing + is done by the cluster program. Users will need to set 'local-echo' on + in their telnet clients if it isn't set automatically (as per the + standards). Needless to say this will probably only apply to Windows + users. - telnet localhost 8000 + [1m4.3. Allowing telnet connects from users (before version 1.47 or for[0m + [1mspecial purposes)[0m - You should now get the login prompt and be able to login as before. + >From version 1.47 there is a new (more efficient) way of doing this + (see previous section) but, if you prefer, the method of doing it + described here will continue to work just fine. - [1m4.3. Setting up telnet connects (from 1.47 onwards)[0m + Allowing telnet connections is quite simple. Firstly you need to add + a line in /etc/services to allow connections to a port number, like + this .... - >From version 1.47 you can choose to allow the perl cluster.pl program - to allow connections directly (i.e. not via the /spider/src/client - interface program). If you are using Windows then this is the only - method available of allowing incoming telnet connections. + spdlogin 8000/tcp # spider anonymous login port - To do this you need first to remove any line that you may previously - have set up in /etc/inetd.conf. Remember to:- + Then add a line in /etc/inetd.conf like this .... - killall -HUP inetd + spdlogin stream tcp nowait root /usr/sbin/tcpd /spider/src/client login telnet - to make the change happen... + Once this is done, you need to restart inetd like this .... - Having done that, you need to copy the file [4m/spider/perl/Listeners.pm[0m - to [4m/spider/local[24m and then edit it. You will need to uncomment the line - containing "0.0.0.0" and select the correct port to listen on. So that - it looks like this:- + killall -HUP inetd - @listen = ( - ["0.0.0.0", 8000], - ); + Now login as [4msysop[24m and cd spider/src. You can test that spider is + accepting telnet logins by issuing the following command .... - As standard, the listener will listen on all interfaces - simultaneously. If you require more control than this, you can - specify each interface individually:- + ./client login telnet - @listen = ( - ["gb7baa.dxcluster.net", 8000], - ["44.131.16.2", 6300], - ); + You should get a login prompt and on issuing a callsign, you will be + given access to the cluster. Note, you will not get a password login. + There seems no good reason for a password prompt to be given so it is + not asked for. - This will only be successful if the IP addresses on each interface are - static. If you are using some kind of dynamic IP addressing then the - 'default' method is the only one that will work. + Assuming all is well, then try a telnet from your linux console .... - Restart the cluster.pl program to enable the listener. - One important difference with the internal listener is that no echoing - is done by the cluster program. Users will need to set 'local-echo' on - in their telnet clients if it isn't set automatically (as per the - standards). Needless to say this will probably only apply to Windows - users. + telnet localhost 8000 + + + + You should now get the login prompt and be able to login as before. + [1m4.4. Setting up for AGW Engine (1.47 onwards)[0m @@ -1146,15 +1174,12 @@ In order to enable access to an AGW Engine you need to copy [4m/spider/perl/AGWConnect.pm[24m to [4m/spider/local[24m and edit it. Specifically you must:- - - o set $enable to 1. o set $login and $passwd to the values set up in your AGW installation. If you haven't set any there, then you should not touch these values. - o You can connect to a remote AGW engine (ie on some other machine) by changing $addr and $port appropriately. @@ -1210,7 +1235,6 @@ another console as sysop, cd to spider/src and issue the command ... - ./client gb7baa (using the callsign you set as a node) @@ -1328,11 +1352,13 @@ - timeout 15 - connect telnet dirkl.tobit.co.uk - # tell GB7DJK-1 that it is connected to GB7DJK - # you can leave this out if you call this script 'gb7djk' - client gb7djk telnet + timeout 15 + connect telnet dirkl.tobit.co.uk + # tell GB7DJK-1 that it is connected to GB7DJK + # you can leave this out if you call this script 'gb7djk' + client gb7djk telnet + + Both these examples assume that everything is set up properly at the other end. You will find other examples in the /spider/examples @@ -1396,6 +1422,9 @@ This means if a node is unreachable, it will continue sending logins and logouts to users even though it is not actually connecting. To avoid this use the following line ... + + + In a script, this might look like ... @@ -1457,7 +1486,6 @@ automatically. - This is not only a way to start the cluster automatically, it also works as a watchdog, checking the sanity of DXSpider and respawning it should it crash for any reason. Before doing the following, shutdown @@ -1502,6 +1530,7 @@ tty you run it on. + As root type the command [4mtelinit[24m [4mq[24m. DXSpider should start up immediately. You will see the output on tty7 and if you login as [4msysop[24m you should find everything running nicely. @@ -1568,7 +1597,6 @@ any platform that has reasonably complete support for Perl. Is there someone out there with both an enquiring mind and (say) a Macintosh, for instance? - Please bear in mind, though, that my instructions relate solely to how to get this going under a Microsoft Windows environment, and I have zero intention of trying to make them say otherwise. @@ -1583,7 +1611,6 @@ noticable difficulty.) You can get this from: http://www.activestate.com/Products/ActivePerl/Download.html - The link takes you to an initial page of System Requirements and Software Prerequisites. If you do not have it already installed, you can download and install the Windows Installer 2.0 for a Win98 @@ -1648,16 +1675,16 @@ - D:\ppm>ppm install Data-Dumper.ppd - Installing package 'Data-Dumper.ppd' - Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.bs - Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.dll - Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.exp - Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.lib - Installing D:\Perl\html\site\lib\auto\Data\Dumper\Dumper.html - Installing D:\Perl\site\lib\Data\Dumper\Dumper.pm - Writing D:\Perl\site\lib\auto\Data\Dumper\Dumper.packlist - D:\ppm> + D:\ppm>ppm install Data-Dumper.ppd + Installing package 'Data-Dumper.ppd' + Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.bs + Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.dll + Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.exp + Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.lib + Installing D:\Perl\html\site\lib\auto\Data\Dumper\Dumper.html + Installing D:\Perl\site\lib\Data\Dumper\Dumper.pm + Writing D:\Perl\site\lib\auto\Data\Dumper\Dumper.packlist + D:\ppm> @@ -1700,7 +1727,6 @@ unstable. Generally, there will be a note on the website if this is the case. - The only difference between "CVSlatest.tgz" and the latest "official" release version is that it is more up to date. [1mDo not confuse the[0m [1m"CVSlatest.tgz" file with "Downloading from Sourceforge with CVS" -[0m @@ -1763,6 +1789,7 @@ o $mycall - Should hold the callsign of your DX Cluster + o $myname - The SysOp's first name o $myalias - the SysOp's callsign. Cannot be the same as $mycall! @@ -1774,7 +1801,6 @@ o $mylongitude - The station longitude in degrees and decimal fractions - o $mylocator - The Maidenhead (or QRA) locator of the station You really also ought to update the $myqth and $myemail variables. And @@ -1828,7 +1854,6 @@ somesuch), then you need to have the machine listening at least to "127.0.0.1" ("0.0.0.0" means [1mall [22mIP addresses). - [1m6.2. The AGW packet engine[0m On the assumption that you'll be using the SV2AGW Packet Engine to @@ -1893,8 +1918,6 @@ cd \spider\perl perl create_sysop.pl - - If all goes according to plan, you will see no output from this program, and after a brief wait, your DOS prompt will be returned. @@ -1902,6 +1925,7 @@ following:- + perl cluster.pl @@ -1957,13 +1981,15 @@ - Menu->Start->Run - telnet localhost 7300 + Menu->Start->Run + telnet localhost 7300 On getting the [1mlogin: [22mprompt, enter your sysop callsign (the one you put in DXVars.pm as $myalias). + + I would recommend [1mstrongly [22mthat you obtain a better telnet client than that which comes with windows (I use PuTTY). @@ -2016,10 +2042,10 @@ - # check every 10 minutes to see if gb7xxx is connected and if not - # start a connect job going + # check every 10 minutes to see if gb7xxx is connected and if not + # start a connect job going - 0,10,20,30,40,50 * * * * start_connect('gb7xxx') unless connected('gb7xxx') + 0,10,20,30,40,50 * * * * start_connect('gb7xxx') unless connected('gb7xxx') @@ -2027,6 +2053,8 @@ going to connect to. This will now check every 10 minutes to see if gb7xxx is connected, if it is then nothing will be done. If it is not, then a connect attempt will be started. + + There are probably lots of other things you could use this crontab file for. If you want to know more about it, look at the DXSpider website at the cron page where it is explained more fully. diff --git a/txt/spiderFAQ_en.txt b/txt/spiderFAQ_en.txt index 84f5789b..30be83e0 100644 --- a/txt/spiderFAQ_en.txt +++ b/txt/spiderFAQ_en.txt @@ -24,7 +24,7 @@ 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 am updating from CVS and I get all sorts of errors when I restart + 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 @@ -121,10 +121,11 @@ All spots are checked that they are no more than 15 minutes in the - future and 60 minutes in the past. If your clock is not set to 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. + 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 @@ -174,7 +175,10 @@ 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. [1m2.7. I updated my Linux distribution and now Spider cannot read the[0m @@ -183,13 +187,11 @@ 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 cd /spider/data - o issue the command perl user_asc + o issue the command: perl user_asc o restart the cluster @@ -214,11 +216,11 @@ [4mdelete/expunge[24m to delete it immediately. - [1m2.10. I am updating from CVS and I get all sorts of errors when I[0m + [1m2.10. I have updated from CVS and I get all sorts of errors when I[0m [1mrestart[0m - Firstly, whenever you update from CVS, a log is displayed. Next to - each file that is downloaded there is a letter, e.g.: + Whenever you update from CVS, a log is displayed. Next to each file + that is downloaded there is a letter, e.g.: @@ -238,19 +240,17 @@ - For normal CVS use you should only ever see the letter 'P'. This means - that the file has changed in CVS and is more recent than the one that - is currenly on your system. You may also possibly 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. + 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 @@ -258,8 +258,8 @@ 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 and - they will be things like:- + files that have the 'C' next to them that will show the errors that + you are complaining about and they will be things like:- @@ -269,7 +269,7 @@ - You will now necessarily see all of the errors shown but you will get + 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: @@ -303,8 +303,8 @@ - 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 + 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.