X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Finstallation-1.html;h=2b4af659431b9069d1e13b780ced5b6759cb847b;hb=8b89a9f5ce05bee89e83d68a75da9e73f560ee67;hp=c9dcbc38cd3408f6e3e17207caed385f881e738a;hpb=6624dcdf07d628e8d6a16fc6549edf40be25b7b2;p=spider.git diff --git a/html/installation-1.html b/html/installation-1.html index c9dcbc38..2b4af659 100644 --- a/html/installation-1.html +++ b/html/installation-1.html @@ -2,7 +2,7 @@ - The DXSpider Installation Manual v1.48: Linux Installation + The DXSpider Installation Manual v1.50: Linux Installation @@ -18,12 +18,9 @@ Previous

1.1 Introduction

-

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.

1.2 Preparation @@ -110,7 +122,7 @@ following modules from

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

-

1.5 Starting up for the first time +

1.5 The client program +

+ +

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. +

+

+

1.6 Starting up for the first time

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.

-

1.6 The Client program -

- -

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. -


Next