projects / spider.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
add gb7djk's home page
[spider.git] / html / installation-1.html
diff --git a/html/installation-1.html b/html/installation-1.html
index a22d7b69c81abe1902a81366639ba322fc8742d9..2b4af659431b9069d1e13b780ced5b6759cb847b 100644 (file)
--- a/html/installation-1.html
+++ b/html/installation-1.html
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.47: Linux Installation </TITLE>
+ <TITLE>The DXSpider Installation Manual v1.50: Linux Installation </TITLE>
  <LINK HREF="installation-2.html" REL=next>
 
  <LINK HREF="installation.html#toc1" REL=contents>
  <LINK HREF="installation-2.html" REL=next>
 
  <LINK HREF="installation.html#toc1" REL=contents>
@@ -18,12 +18,9 @@ Previous
 <H2><A NAME="ss1.1">1.1 Introduction</A>
 </H2>
 
 <H2><A NAME="ss1.1">1.1 Introduction</A>
 </H2>
 
-<P>This section describes the installation of DX Spider v1.47 on a 
+<P>This section describes the installation of DX Spider v1.50 on a 
 <A HREF="http://www.redhat.com">RedHat</A> Linux Distribution.
 Wherever possible I will try to include differences for other distributions.  
 <A HREF="http://www.redhat.com">RedHat</A> 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.
 <P>
 <P>I am assuming a general knowledge of Linux and its commands.  You should 
 know how to use <EM>tar</EM> and how to edit files using your favourite editor.
 <P>
 <P>I am assuming a general knowledge of Linux and its commands.  You should 
 know how to use <EM>tar</EM> and how to edit files using your favourite editor.
@@ -36,27 +33,96 @@ in the development of Spider.
 <P>
 <P>In addition to the standard Red Hat distribution you will require the 
 following modules from 
 <P>
 <P>In addition to the standard Red Hat distribution you will require the 
 following modules from 
-<A HREF="http://www.cpan.org/CPAN.html">http://www.cpan.org/CPAN.html</A> ...
+<A HREF="http://www.cpan.org/modules/by-module/">http://www.cpan.org/modules/by-module/</A> , 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.
 <P>
 <P>
 <UL>
 <P>
 <P>
 <UL>
-<LI>            Data-Dumper-2.101.tar.gz</LI>
-<LI>            TimeDate-1.10.tar.gz</LI>
-<LI>            IO-1.20.tar.gz (for perl 5.00403 and lower)</LI>
-<LI>            Net-Telnet-3.02.tar.gz</LI>
-<LI>            Curses-1.05.tar.gz</LI>
-<LI>            Time-HiRes-01.20.tar.gz</LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Data/Data-Dumper-2.10.tar.gz">Data-Dumper-2.10.tar.gz</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Date/TimeDate-1.10.tar.gz">TimeDate-1.10.tar.gz</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz">IO-1.20.tar.gz (for perl 5.00403 and lower)</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Net/Net-Telnet-3.02.tar.gz">Net-Telnet-3.02.tar.gz</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Curses/Curses-1.06.tar.gz">Curses-1.06.tar.gz</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz">Time-HiRes-01.20.tar.gz</A></LI>
+<LI> 
+<A HREF="http://www.cpan.org/modules/by-module/Digest/Digest-SHA1-2.01.tar.gz">Digest-SHA1-2.01.tar.gz</A></LI>
 </UL>
 <P>
 </UL>
 <P>
-<P><EM>Do</EM> get the latest versions of these packages and install them 
-but use the above list as the earliest versions usable.
+<P>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.
+<P>
+<P>Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
+<P>
+<PRE>
+# 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 ..
+#
+# tar xvfz /usr/local/packages/Digest-SHA1-2.01.tar.gz
+# cd Digest-SHA1-2.01
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+</PRE>
+<P>
+<P>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 <EM>IO</EM>, above.
+<P>
 <P>
 <H2><A NAME="ss1.2">1.2 Preparation</A>
 </H2>
 
 <P>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 
 <P>
 <H2><A NAME="ss1.2">1.2 Preparation</A>
 </H2>
 
 <P>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.
 <P>
 <P>Login as root and create a user to run the cluster under.  <B><I>UNDER 
 NO CIRCUMSTANCES USE ROOT AS THIS USER!</I></B>.  I am going to use 
 <P>
 <P>Login as root and create a user to run the cluster under.  <B><I>UNDER 
 NO CIRCUMSTANCES USE ROOT AS THIS USER!</I></B>.  I am going to use 
@@ -64,13 +130,20 @@ the name <EM>sysop</EM>.  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.
 <P>
 on your security requirements you may wish to use an existing user, 
 however this is your own choice.
 <P>
-<P>
 <BLOCKQUOTE><CODE>
 <PRE>
 # adduser -m sysop
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
 # adduser -m sysop
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
+<P>For SuSE distributions, the command would be ..
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+# useradd -m sysop
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
 <P>Now set a password for the user ...
 <P>
 <BLOCKQUOTE><CODE>
 <P>Now set a password for the user ...
 <P>
 <BLOCKQUOTE><CODE>
@@ -91,11 +164,12 @@ permissions.  Copy the tarball to /home/sysop and do the following.
 <BLOCKQUOTE><CODE>
 <PRE>
 # cd ~sysop
 <BLOCKQUOTE><CODE>
 <PRE>
 # 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)
 </PRE>
 </CODE></BLOCKQUOTE>
 # ln -s ~sysop/spider /spider
 # groupadd -g 251 spider       (or another number)
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>
 <P>If you do not have the command <EM>groupadd</EM> available to you simply 
 add a line in /etc/group by hand.
 <P>
 <P>If you do not have the command <EM>groupadd</EM> available to you simply 
 add a line in /etc/group by hand.
 <P>
@@ -104,6 +178,7 @@ add a line in /etc/group by hand.
 # vi /etc/group                (or your favorite editor)
 </PRE>
 </CODE></BLOCKQUOTE>
 # vi /etc/group                (or your favorite editor)
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>
 <P>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
 <P>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 +227,36 @@ $ vi DXVars.pm (or your favourite editor)
 </CODE></BLOCKQUOTE>
 <P>
 <P>Using the distributed DXVars.pm as a a template, set your cluster callsign, 
 </CODE></BLOCKQUOTE>
 <P>
 <P>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. 
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+$mycall = "GB7DJK";     
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
+<P>This is the call sign of your cluster.  If you use an SSID then include it here
+also.
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+$myalias = "G1TLH";
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
+<P>This is the sysop user callsign, normally your own.
+<P>
+<P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
+<P>
+<P>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 ....
 <P><CODE>$myemail = "ianmaude\@btinternet.com";</CODE>
 <P>
 <P>There appears to be an extra slash in there.  However this has to be there 
 for the file to work so leave it in.
 <P>
 <P><CODE>$myemail = "ianmaude\@btinternet.com";</CODE>
 <P>
 <P>There appears to be an extra slash in there.  However this has to be there 
 for the file to work so leave it in.
 <P>
-<P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
-<P>
 <P>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 
 <P>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 +279,19 @@ $ ./create_sysop.pl
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
-<H2><A NAME="ss1.5">1.5 Starting up for the first time</A>
+<H2><A NAME="ss1.5">1.5 The client program</A>
+</H2>
+
+<P>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
+<EM>incoming</EM> connects at the moment.  Before you can use it though it
+has to be "made".  CD to /spider/src and type <EM>make</EM>.  You
+should see the output on your screen and hopefully now have a small C program
+called <EM>client</EM>.  Leave it in this directory.
+<P>
+<P>
+<H2><A NAME="ss1.6">1.6 Starting up for the first time</A>
 </H2>
 
 <P>We can now bring spider up for the first time and see if all is well or not!  
 </H2>
 
 <P>We can now bring spider up for the first time and see if all is well or not!  
@@ -195,7 +300,7 @@ It should look something like this ...
 <BLOCKQUOTE><CODE>
 <PRE>
 $ ./cluster.pl
 <BLOCKQUOTE><CODE>
 <PRE>
 $ ./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 ...
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
@@ -226,6 +331,7 @@ was set as GB7MBC.  You should therefore see this when you login ....
 G0VGS de GB7MBC 19-Nov-1999 2150Z >
 </PRE>
 </CODE></BLOCKQUOTE>
 G0VGS de GB7MBC 19-Nov-1999 2150Z >
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>
 <P>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 ....
 <P>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 +344,6 @@ shutdown
 <P>
 <P>and both the cluster and the client should return to Linux prompts.
 <P>
 <P>
 <P>and both the cluster and the client should return to Linux prompts.
 <P>
-<H2><A NAME="ss1.6">1.6 The Client program</A>
-</H2>
-
-<P>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
-<EM>incoming</EM> connects at the moment.  Before you can use it though it 
-has to be "made".  CD to /spider/src and type <EM>make</EM>.  You 
-should see the output on your screen and hopefully now have a small C program 
-called <EM>client</EM>.  Leave it in this directory.
-<P>
 <P>
 <HR>
 <A HREF="installation-2.html">Next</A>
 <P>
 <HR>
 <A HREF="installation-2.html">Next</A>
The DXSpider Git Repository