X-Git-Url: http://www.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=sgml%2Finstallation_en.sgml;fp=sgml%2Finstallation_en.sgml;h=0d314c39e43c8d73776d82872fcd9609274cf2c3;hb=4bcd914bdf99b8ab78c7d6c67264f71f0e04e20d;hp=5e8c3b6d66fec53c0cbe67b92f0ea138268ab3c4;hpb=4a988d6dfcb4f50b4dd5db916294cd5aa87d3d22;p=spider.git diff --git a/sgml/installation_en.sgml b/sgml/installation_en.sgml index 5e8c3b6d..0d314c39 100644 --- a/sgml/installation_en.sgml +++ b/sgml/installation_en.sgml @@ -49,14 +49,30 @@ perl distribution.

this is included in perl 5.6.1 and above - + (for perl 5.00403 and lower) - - + + (for perl versions lower than 5.8 ) +

+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:- + + +Mandrake: urpmi perl-TimeDate perl-Digest-SHA1 perl-Curses perl-Net-Telnet +Redhat/Fedora: up2date perl-TimeDate perl-Digest-SHA1 perl-Curses perl-Net-Telnet +SuSE: use yast +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 @@ -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: - -# 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 @@ -80,8 +96,8 @@ Log in as 'root', and make sure you're at '/root' before you continue. Here are # 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 @@ -103,7 +119,7 @@ Log in as 'root', and make sure you're at '/root' before you continue. Here are

-Only if you need to do these (because your perl is old):- +Only if you need to do these because your perl is old:- # @@ -893,11 +909,74 @@ netrom connections.

This is dealt with in the previous section -Allowing telnet connects from users +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 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:- + + +@listen = ( +# ["0.0.0.0", 7300], +); + + +Change it so that it looks like this:- + + +@listen = ( + ["0.0.0.0", 7300], +); + + +

+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:- + + +@listen = ( + ["gb7baa.dxcluster.net", 7300], + ["44.131.16.2", 6300], +); + + +

+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. + +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 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. -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:- - - -killall -HUP inetd - - -

-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:- - - -@listen = ( - ["0.0.0.0", 8000], -); - - -

-As standard, the listener will listen on all interfaces simultaneously. -If you require more control than this, you can specify each interface -individually:- - - -@listen = ( - ["gb7baa.dxcluster.net", 8000], - ["44.131.16.2", 6300], -); - - -

-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. Setting up for AGW Engine (1.47 onwards)