X-Git-Url: http://scm.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Fadminmanual-1.html;h=a6f976752d03d33205eb415322861cac1002e523;hb=b85014c2efe367be21460ff3e72f4a0727e6c26c;hp=e85ba645a1aaeb762260e04b212c945c2c9dd20d;hpb=bff9ecf00b14e7d71d9504088a2fd7b9e5115fe1;p=spider.git diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html index e85ba645..a6f97675 100644 --- a/html/adminmanual-1.html +++ b/html/adminmanual-1.html @@ -2,10 +2,11 @@
-Last modified: November 1999 by Ian Maude, G0VGS +
Last modified: 13 January 2001 by Ian Maude, G0VGS
This section describes the installation of DX Spider v1.35 on a -RedHat Linux Distribution. 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 HOWTO on the -DXSpider website. +RedHat Linux Distribution. +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 +HOWTO on the +DXSpider +website.
-
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. +
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.
The crucial ingredient for all of this is -Perl 5.004.Now I know Perl 5.005 is out and this will almost certainly work with it, but -RedHat 5.1 comes with 5.004. Be Warned, earlier versions of -RedHat do not come with 5.004 as standard, you need to +Perl 5.004. Now I know Perl 5.005 +is out and this will almost certainly work with it, but +RedHat 5.1 comes with 5.004. +Be Warned, earlier versions of +RedHat do not come +with 5.004 as standard, you need to upgrade
-
In addition to the standard Red Hat distribution you will require the following +
In addition to the standard Red Hat distribution you will require the +following CPAN modules: -
@@ -38,22 +48,31 @@ Previous
-
Do get the latest versions of these packages and install them but use the above list as the earliest versions usable. +
Do get the latest versions of these packages and install them +but use the above list as the earliest versions usable.
I will assume that you have already downloaded the latest tarball of the DXSpider software and are ready to install it. +
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.35 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 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. +
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 +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.
@@ -76,7 +95,8 @@ passwd: all authentication tokens updated successfully
1.3 Installing the software
-Now to unpack the DX Spider distribution, set symbolic links and group permissions. This example assumes you are using version 1.35 but of course you would substitute the correct version number. Copy the tarball to /home/sysop and do the following.
+
Now to unpack the DX Spider distribution, set symbolic links and group
+permissions. Copy the tarball to /home/sysop and do the following.
@@ -86,14 +106,17 @@ passwd: all authentication tokens updated successfully
# 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.
+
If you do not have the command groupadd available to you simply
+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
+
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
spider:x:251:sysop,g0vgs,root
The next step is to set the permissions on the Spider directory tree and files ....
@@ -106,9 +129,13 @@ passwd: all authentication tokens updated successfully
-
This last step allows various users of the group spider to have write access to all the directories. This is not really needed just yet but will be useful when web interfaces start to appear. +
This last step allows various users of the group spider to have +write access to all the directories. This is not really needed just yet +but will be useful when web interfaces start to appear.
-
Finally, you need to fix the permissions on the ax25_call and netrom_call programs. Check where they are with the locate command and alter the permissions with the chmod command like this .. +
Finally, you need to fix the permissions on the ax25_call and netrom_call +programs. Check where they are with the locate command and alter +the permissions with the chmod command like this ..
@@ -120,27 +147,37 @@ passwd: all authentication tokens updated successfully
1.4 Setting callsigns etc
-Now login to your machine as the user you created earlier. In my case that user is called sysop. Once logged in, issue the following commands ....
+
Now login to your machine as the user you created earlier. In my case that
+user is called sysop. Once logged in, issue the following commands ....
$ cd /spider
$ mkdir local
$ mkdir local_cmd
-$ cp perl/DXVars.pm local
+$ cp perl/DXVars.pm.issue local/DXVars.pm
$ cd local
$ 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 ....
+
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 ....
$myemail = "ianmaude\@btinternet.com";
-
There appears to be an extraeneous slash in there. However this has to be there for the file to work so leave it in.
+
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 the DXVars.pm (or any other 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 whilst the cluster is running!
+
DON'T alter the DXVars.pm (or any other 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 while the cluster is running!
Save the new file and change directory to ../perl ....
@@ -150,7 +187,8 @@ $ cd ../perl
-
Now type the following command which creates the basic user file with you as the sysop. +
Now type the following command which creates the basic user file with you as +the sysop.
@@ -161,7 +199,8 @@ $ create_sysop.pl
1.5 Starting up for the first time
-We can now bring spider up for the first time and see if all is well or not! It should look something like this ...
+
We can now bring spider up for the first time and see if all is well or not!
+It should look something like this ...
@@ -178,7 +217,8 @@ orft we jolly well go ...
-
If all is well then login on another term or console as sysop and cd to /spider/perl. Now issue the following command ...
+
If all is well then login on another term or console as sysop and
+cd to /spider/perl. Now issue the following command ...
@@ -186,14 +226,19 @@ $ client.pl
-
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 this case we will assume that this was set as GB7MBC. You should therefore see this when you login ....
+
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 this case we will assume that this
+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 ....
+
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 ....