X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Finstallation-1.html;h=28cb629eea7fec7cab8e37267829875edcabb413;hb=9cfd05889c539c625a4fb3ee9fdbc0fea847452c;hp=343f1b0365852e89ae6f398b648cf37d9a468400;hpb=b8ff94755eecda16276c449274c6a76c4f14a8d1;p=spider.git diff --git a/html/installation-1.html b/html/installation-1.html index 343f1b03..28cb629e 100644 --- a/html/installation-1.html +++ b/html/installation-1.html @@ -2,7 +2,7 @@ - The DXSpider Installation Manual v1.47: Linux Installation (Original version by Iain Philipps, G0RDI) + The DXSpider Installation Manual v1.49: Linux Installation @@ -13,7 +13,7 @@ Previous Contents
-

1. Linux Installation (Original version by Iain Philipps, G0RDI)

+

1. Linux Installation

1.1 Introduction

@@ -36,20 +36,80 @@ 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/CPAN.html , 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.

-

Do get the latest versions of these packages and install them -but use the above list as the earliest versions usable. +

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

+

+# tar xvfz /usr/local/packages/Data-Dumper-2.10.tar.gz
+# cd Data-Dumper-2.10
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+#
+# tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz
+# cd TimeDate-1.10
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+#
+# tar xvfz /usr/local/packages/IO-1.20.tar.gz
+# cd IO-1.20
+# perl Makefile.PL
+# make test
+# make install UNINST=1
+# cd ..
+#
+# tar xvfz /usr/local/packages/Net-Telnet-3.02.tar.gz
+# cd Net-Telnet-3.02
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+#
+# tar xvfz /usr/local/packages/Curses-1.06.tar.gz
+# cd Curses-1.06
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+#
+# tar xvfz /usr/local/packages/Time-HiRes-01.20.tar.gz 
+# cd Time-HiRes-01.20
+# 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. +

1.2 Preparation

@@ -64,13 +124,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 ...

@@ -96,6 +163,7 @@ permissions. Copy the tarball to /home/sysop and do the following. # 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.

@@ -104,6 +172,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 @@ -152,18 +221,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 @@ -186,7 +273,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! @@ -226,6 +325,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 .... @@ -238,17 +338,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