X-Git-Url: http://dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;ds=inline;f=html%2Finstallation-1.html;h=2b4af659431b9069d1e13b780ced5b6759cb847b;hb=1ddd21105b4fdf68756a8676a58105927254d386;hp=f0eb2a3785bcc2e80b48ae3fac88a551e06ea83a;hpb=47c7227bbec190df5f30c5bb64d7a78ed120b54b;p=spider.git diff --git a/html/installation-1.html b/html/installation-1.html index f0eb2a37..2b4af659 100644 --- a/html/installation-1.html +++ b/html/installation-1.html @@ -2,7 +2,7 @@
-This section describes the installation of DX Spider v1.47 on a +
This section describes the installation of DX Spider v1.50 on a RedHat Linux Distribution. Wherever possible I will try to include differences for other distributions. -I do not intend to try and cover the installation of Linux or the setup -of the AX25 utilities. If you need help on this then read Iains original -installation guide that comes with the Spider distribution.
I am assuming a general knowledge of Linux and its commands. You should know how to use tar and how to edit files using your favourite editor. @@ -36,7 +33,10 @@ in the development of Spider.
In addition to the standard Red Hat distribution you will require the following modules from -http://www.cpan.org/CPAN.html ... +http://www.cpan.org/modules/by-module/ , please note however that with later versions of perl, some of these +modules may be included with the distribution. Get the modules anyway and try +to install as below. If they complain, they are probably already a part of your +perl distribution.
-
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. +
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.
Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
@@ -87,8 +91,8 @@ following modules from # make install # cd .. # -# tar xvfz /usr/local/packages/Curses-1.05.tar.gz -# cd Curses-1.05 +# tar xvfz /usr/local/packages/Curses-1.06.tar.gz +# cd Curses-1.06 # perl Makefile.PL # make test # make install @@ -100,9 +104,17 @@ following modules from # make test # make install # cd .. +# +# tar xvfz /usr/local/packages/Digest-SHA1-2.01.tar.gz +# cd Digest-SHA1-2.01 +# perl Makefile.PL +# make test +# make install +# cd ..
-
Do not fall into the trap of thinking they're all the same, just because they nearly are! Pay particular attention to the instructions of IO, above. +
Do not fall into the trap of thinking they're all the same, just because they +nearly are! Pay particular attention to the instructions of IO, above.
I will assume that you have already downloaded the latest tarball of the DXSpider software and are ready to install it. I am assuming version -1.47 for this section but of course you would use the latest version. +1.50 for this section but of course you would use the latest version.
Login as root and create a user to run the cluster under. UNDER NO CIRCUMSTANCES USE ROOT AS THIS USER!. I am going to use @@ -118,13 +130,20 @@ the name sysop. You can call it anything you wish. Depending on your security requirements you may wish to use an existing user, however this is your own choice.
-
# adduser -m sysop
+
For SuSE distributions, the command would be .. +
+
+
+# useradd -m sysop
+
+
+
Now set a password for the user ...
@@ -145,11 +164,12 @@ permissions. Copy the tarball to /home/sysop and do the following.
# cd ~sysop
-# tar xvfz spider-1.47.tar.gz
+# tar xvfz spider-1.50.tar.gz
# ln -s ~sysop/spider /spider
# groupadd -g 251 spider (or another number)
+
If you do not have the command groupadd available to you simply
add a line in /etc/group by hand.
@@ -158,6 +178,7 @@ add a line in /etc/group by hand.
# vi /etc/group (or your favorite editor)
+
You also need to add some others to the group, including your own callsign (this will be used as an alias) and root. The finished line in /etc/group should look something like this @@ -206,18 +227,36 @@ $ vi DXVars.pm (or your favourite editor)
Using the distributed DXVars.pm as a a template, set your cluster callsign, -sysop callsign and other user info to suit your own environment. Note that -this a perl file which will be parsed and executed as part of the cluster. If -you get it wrong then perl will complain when you start the cluster process. -It is important only to alter the text of any section. Some of the lines look -a little odd. Take this line for example .... +sysop callsign and other user info to suit your own environment. +
+
+
+$mycall = "GB7DJK";
+
+
++
This is the call sign of your cluster. If you use an SSID then include it here +also. +
+
+
+$myalias = "G1TLH";
+
+
++
This is the sysop user callsign, normally your own. +
+
PLEASE USE CAPITAL LETTERS FOR CALLSIGNS +
+
Note that this a perl file which will be parsed and executed as part of the +cluster. If you get it wrong then perl will complain when you start the cluster +process. It is important only to alter the text of any section. Some of the +lines look a little odd. Take this line for example ....
$myemail = "ianmaude\@btinternet.com";
There appears to be an extra slash in there. However this has to be there for the file to work so leave it in.
-
PLEASE USE CAPITAL LETTERS FOR CALLSIGNS -
DON'T alter any file in /spider/perl, they are overwritten with every release. Any files or commands you place in /spider/local or /spider/local_cmd will automagically be used in preference to the ones in /spider/perl EVEN @@ -240,7 +279,19 @@ $ ./create_sysop.pl
-
In earlier versions of Spider, all the processes were Perl scripts. This +was fine but with a lot of users your computer memory would soon be used up. +To combat this a new client was written in "C". This client only works for +incoming connects at the moment. Before you can use it though it +has to be "made". CD to /spider/src and type make. You +should see the output on your screen and hopefully now have a small C program +called client. Leave it in this directory. +
+
+
We can now bring spider up for the first time and see if all is well or not! @@ -249,7 +300,7 @@ It should look something like this ...
$ ./cluster.pl
-DXSpider DX Cluster Version 1.47
+DXSpider DX Cluster Version 1.50
Copyright (c) 1998 Dirk Koopman G1TLH
loading prefixes ...
loading band data ...
@@ -280,6 +331,7 @@ was set as GB7MBC. You should therefore see this when you login ....
G0VGS de GB7MBC 19-Nov-1999 2150Z >
+
If you do, congratulations! If not, look over the instructions again, you have probably missed something out. You can shut spider down again with the command .... @@ -292,17 +344,6 @@ shutdown
and both the cluster and the client should return to Linux prompts.
-
In earlier versions of Spider, all the processes were Perl scripts. This -was fine but with a lot of users your computer memory would soon be used up. -To combat this a new client was written in "C". This client only works for -incoming connects at the moment. Before you can use it though it -has to be "made". CD to /spider/src and type make. You -should see the output on your screen and hopefully now have a small C program -called client. Leave it in this directory. -