projects / spider.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
update html docs
[spider.git] / html / adminmanual-1.html
diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html
index a6f976752d03d33205eb415322861cac1002e523..94118af929cf5aa40d58a372f4b64a8d40a2544c 100644 (file)
--- a/html/adminmanual-1.html
+++ b/html/adminmanual-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 and Administration Manual : Installation (Original version by Iain Phillips, G0RDI)</TITLE>
+ <TITLE>The DXSpider Installation and Administration Manual: Installation (Original version by Iain Philipps, G0RDI)</TITLE>
  <LINK HREF="adminmanual-2.html" REL=next>
 
  <LINK HREF="adminmanual.html#toc1" REL=contents>
  <LINK HREF="adminmanual-2.html" REL=next>
 
  <LINK HREF="adminmanual.html#toc1" REL=contents>
@@ -13,44 +13,36 @@
 Previous
 <A HREF="adminmanual.html#toc1">Contents</A>
 <HR>
 Previous
 <A HREF="adminmanual.html#toc1">Contents</A>
 <HR>
-<H2><A NAME="s1">1. Installation (Original version by Iain Phillips, G0RDI)</A></H2>
+<H2><A NAME="s1">1. Installation (Original version by Iain Philipps, G0RDI)</A></H2>
 
 
-<P>Last modified: 13 January 2001 by Ian Maude, G0VGS
-<P>
 <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.35 on a 
-<A HREF="http://www.redhat.com">RedHat</A> Linux Distribution.  
+<P>This section describes the installation of DX Spider v1.46 on a 
+<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 
 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 
-<A HREF="http://www.dxcluster.org">DXSpider</A> 
-website.
+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>The crucial ingredient for all of this is 
 <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>The crucial ingredient for all of this is 
-<A HREF="http://www.perl.org">Perl 5.004</A>.  Now I know Perl 5.005 
-is out and this will almost certainly work with it, but 
-<A HREF="http://www.redhat.com">RedHat 5.1</A> comes with 5.004. 
-<EM>Be Warned</EM>, earlier versions of 
-<A HREF="http://www.redhat.com">RedHat</A> <B>do not</B> come 
-with 5.004 as standard, you need to 
-<A HREF="ftp://upgrade.redhat.com">upgrade</A><P>
+<A HREF="http://www.perl.org">Perl</A>.  Earlier versions of
+Spider required perl 5.004, however it is now <I>STRONGLY</I> recommended
+that you use at least version 5.005_03 as this is the version being used
+in the development of Spider.
+<P>
 <P>In addition to the standard Red Hat distribution you will require the 
 <P>In addition to the standard Red Hat distribution you will require the 
-following 
-<A HREF="http://www.cpan.org/CPAN.html">CPAN</A> modules: -
+following modules from 
+<A HREF="http://www.cpan.org/CPAN.html">http://www.cpan.org/CPAN.html</A> ...
 <P>
 <P>
 <UL>
 <P>
 <P>
 <UL>
-<LI>            MD5-1.7.tar.gz</LI>
-<LI>            Data-Dumper-2.10.tar.gz</LI>
-<LI>            FreezeThaw-0.3.tar.gz</LI>
-<LI>            MLDBM-2.00.tar.gz</LI>
-<LI>            TimeDate-1.08.tar.gz</LI>
-<LI>            IO-1.20.tar.gz</LI>
+<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>            Net-Telnet-3.02.tar.gz</LI>
 <LI>            Curses-1.05.tar.gz</LI>
 <LI>            Time-HiRes-01.20.tar.gz
@@ -66,7 +58,7 @@ but use the above list as the earliest versions usable.
 
 <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>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.
+1.46 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 
@@ -101,7 +93,7 @@ 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.35.tar.gz
+# tar xvfz spider-1.46.tar.gz
 # ln -s ~sysop/spider /spider
 # groupadd -g 251 spider       (or another number)
 </PRE>
 # ln -s ~sysop/spider /spider
 # groupadd -g 251 spider       (or another number)
 </PRE>
@@ -174,10 +166,10 @@ for the file to work so leave it in.
 <P>
 <P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
 <P>
 <P>
 <P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B>
 <P>
-<P>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!
+<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 
+while the cluster is running!
 <P>
 <P>Save the new file and change directory to ../perl ....
 <P>
 <P>
 <P>Save the new file and change directory to ../perl ....
 <P>
@@ -192,7 +184,7 @@ the sysop.
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-$ create_sysop.pl
+$ ./create_sysop.pl
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
@@ -204,8 +196,8 @@ It should look something like this ...
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-$ cluster.pl
-DXSpider DX Cluster Version 1.35
+$ ./cluster.pl
+DXSpider DX Cluster Version 1.46
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
 Copyright (c) 1998 Dirk Koopman G1TLH
 loading prefixes ...
 loading band data ...
@@ -218,11 +210,11 @@ orft we jolly well go ...
 </CODE></BLOCKQUOTE>
 <P>
 <P>If all is well then login on another term or console as <EM>sysop</EM> and 
 </CODE></BLOCKQUOTE>
 <P>
 <P>If all is well then login on another term or console as <EM>sysop</EM> and 
-cd to /spider/perl.  Now issue the following command ...
+cd to /spider/src.  Now issue the following command ...
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-$ client.pl
+$ ./client
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
@@ -248,6 +240,18 @@ 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="adminmanual-2.html">Next</A>
 Previous
 <HR>
 <A HREF="adminmanual-2.html">Next</A>
 Previous
The DXSpider Git Repository