Updates to Installation Manual

diff --git a/Changes b/Changes
index dadfdfad8aeb2e220516f7f37eae645b6d246670..95f3e6b48c51436445a94ba4756f24f3223be05f 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,3 +1,5 @@
+30Jul01=======================================================================
+1. changes to manuals to add links etc. (g0vgs)

 23Jul01=======================================================================
 1. made ann,dx spots,wwv,wcy,wx more 'object oriented'.
 2. allow for 'enhanced clients' and tell them what sort of thing is being 
 23Jul01=======================================================================
 1. made ann,dx spots,wwv,wcy,wx more 'object oriented'.
 2. allow for 'enhanced clients' and tell them what sort of thing is being 

diff --git a/html/installation-1.html b/html/installation-1.html
index 9179aa1a7d67d52bb10638840753459111bb0052..c9dcbc38cd3408f6e3e17207caed385f881e738a 100644 (file)
--- a/html/installation-1.html
+++ b/html/installation-1.html
@@ -54,8 +54,56 @@ following modules from
 <A HREF="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz">Time-HiRes-01.20.tar.gz</A></LI>
 </UL>
 <P>
 <A HREF="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz">Time-HiRes-01.20.tar.gz</A></LI>
 </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.05.tar.gz
+# cd Curses-1.05
+# 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 ..
+</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 IO, above.
+<P>

 <P>
 <H2><A NAME="ss1.2">1.2 Preparation</A>
 </H2>
 <P>
 <H2><A NAME="ss1.2">1.2 Preparation</A>
 </H2>

diff --git a/html/installation.html b/html/installation.html
index 54bb2afbe69a3b35c4267cfac68ca7139742f5f0..59bc158d75375bb88b2c4dd347f7c5fcdb643c77 100644 (file)
--- a/html/installation.html
+++ b/html/installation.html
@@ -16,7 +16,7 @@ Contents
 <H1>The DXSpider Installation Manual v1.48</H1>
 
 <H2>Iain Philipps, G0RDI (g0rdi@77hz.com) and
 <H1>The DXSpider Installation Manual v1.48</H1>
 
 <H2>Iain Philipps, G0RDI (g0rdi@77hz.com) and

-Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>Version 1.48, July 2001 revision 1.0
+Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>Version 1.48, July 2001 revision 1.1

 <P><HR>
 <EM>A reference for SysOps of the DXSpider DXCluster program.</EM>
 <HR>
 <P><HR>
 <EM>A reference for SysOps of the DXSpider DXCluster program.</EM>
 <HR>

diff --git a/sgml/installation.sgml b/sgml/installation.sgml
index 41ab79153222d548279e50b48a3c7af8b5578c30..280f4cdd977c0e23e47b11034f83b26bfadd407a 100644 (file)
--- a/sgml/installation.sgml
+++ b/sgml/installation.sgml
@@ -7,7 +7,7 @@
 <title>The DXSpider Installation Manual v1.48</title> 
 <author>Iain Philipps, G0RDI (g0rdi@77hz.com) and
 Ian Maude, G0VGS, (ianmaude@btinternet.com)</author>
 <title>The DXSpider Installation Manual v1.48</title> 
 <author>Iain Philipps, G0RDI (g0rdi@77hz.com) and
 Ian Maude, G0VGS, (ianmaude@btinternet.com)</author>

-<date>Version 1.48, July 2001 revision 1.0</date>
+<date>Version 1.48, July 2001 revision 1.1</date>

 
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
 
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.


@@ -55,8 +55,58 @@ following modules from <htmlurl url="http://www.cpan.org/CPAN.html" name="http:/
 </itemize>
 
 <P>
 </itemize>
 
 <P>

-<em>Do</em> 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.
+
+<P>
+Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
+
+<verb>
+# 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.05.tar.gz
+# cd Curses-1.05
+# 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 ..
+</verb>
+
+<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 IO, above.
+

 
 <sect1>Preparation
 
 
 <sect1>Preparation
 

diff --git a/txt/installation.txt b/txt/installation.txt
index 64b6d3972cf9bee408402380a77f8a5b0930b2ac..975e45b70116a8431cd9413756e86f7e9bbd09f6 100644 (file)
--- a/txt/installation.txt
+++ b/txt/installation.txt
@@ -1,7 +1,7 @@
   The DXSpider Installation Manual v1.48
   Iain Philipps, G0RDI (g0rdi@77hz.com) and Ian Maude, G0VGS,
   (ianmaude@btinternet.com)
   The DXSpider Installation Manual v1.48
   Iain Philipps, G0RDI (g0rdi@77hz.com) and Ian Maude, G0VGS,
   (ianmaude@btinternet.com)

-  Version 1.48, July 2001 revision 1.0
+  Version 1.48, July 2001 revision 1.1

 
   A reference for SysOps of the DXSpider DXCluster program.
   ______________________________________________________________________
 
   A reference for SysOps of the DXSpider DXCluster program.
   ______________________________________________________________________


@@ -96,8 +96,89 @@
   o  Time-HiRes-01.20.tar.gz
 
 
   o  Time-HiRes-01.20.tar.gz
 
 

-  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.05.tar.gz
+  # cd Curses-1.05
+  # 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
 
 
   1.2.  Preparation


@@ -115,8 +196,6 @@
   your own choice.
 
 
   your own choice.
 
 

-
-

        # adduser -m sysop
 
 
        # adduser -m sysop
 
 


@@ -127,13 +206,10 @@
 
 
 
 
 
 

-
-
-
-  # passwd sysop
-  # New UNIX password:
-  # Retype new UNIX password:
-  passwd: all authentication tokens updated successfully
+       # passwd sysop
+       # New UNIX password:
+       # Retype new UNIX password:
+       passwd: all authentication tokens updated successfully

 
 
 
 
 
 


@@ -195,9 +271,8 @@
 
 
 
 
 
 

-
-  # chown root ax25_call netrom_call
-  # chmod 4775 ax25_call netrom_call
+       # chown root ax25_call netrom_call
+       # chmod 4775 ax25_call netrom_call

 
 
 
 
 
 


@@ -253,16 +328,12 @@
        $ cd ../perl
 
 
        $ 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.
 
 
 

-
-  $ ./create_sysop.pl
+       $ ./create_sysop.pl

 
 
 
 
 
 


@@ -323,11 +394,9 @@
        shutdown
 
 
        shutdown
 
 

-
-
-

   and both the cluster and the client should return to Linux prompts.
 
   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.
   1.6.  The Client program
 
   In earlier versions of Spider, all the processes were Perl scripts.


@@ -390,6 +459,7 @@
 
   o  Login as root
 
 
   o  Login as root
 

+

   o  Enter the correct line in ax25d.conf (root)
 
   o  Enter the correct line in /etc/services (root)
   o  Enter the correct line in ax25d.conf (root)
 
   o  Enter the correct line in /etc/services (root)


@@ -455,8 +525,11 @@
 
 
 
 
 
 

-       GB7DJK-2  * * * * * *  - sysop /spider/src/client client gb7djk-2 ax25
-       default  * * * * * *  - sysop /spider/src/client client %u ax25
+
+  GB7DJK-2  * * * * * *  - sysop /spider/src/client client gb7djk-2 ax25
+  default  * * * * * *  - sysop /spider/src/client client %u ax25
+
+

 
 
 
 
 
 


@@ -519,7 +592,6 @@
   Assuming all is well, then try a telnet from your linux console ....
 
 
   Assuming all is well, then try a telnet from your linux console ....
 
 

-

        telnet localhost 8000
 
 
        telnet localhost 8000
 
 


@@ -651,6 +723,7 @@
   an AK1A type node.
 
 
   an AK1A type node.
 
 

+

   Start up the cluster as you did before and login as the sysop with
   client.  The cluster node I am wanting to make a connection to is
   GB7BAA but you would obviously use whatever callsign you required.  At
   Start up the cluster as you did before and login as the sysop with
   client.  The cluster node I am wanting to make a connection to is
   GB7BAA but you would obviously use whatever callsign you required.  At


@@ -658,7 +731,7 @@
 
 
 
 
 
 

-  set/node gb7baa
+       set/node gb7baa

 
 
 
 
 
 


@@ -716,6 +789,7 @@
   connections is therefore relatively simple.
 
 
   connections is therefore relatively simple.
 
 

+

   The connect scripts consist of lines which start with the following
   keywords or symbols:-
 
   The connect scripts consist of lines which start with the following
   keywords or symbols:-
 


@@ -724,6 +798,7 @@
      #  All lines starting with a # are ignored, as are completely blank
         lines.
 
      #  All lines starting with a # are ignored, as are completely blank
         lines.
 

+

      timeout
         timeout followed by a number is the number of seconds to wait
         for a command to complete. If there is no timeout specified in
      timeout
         timeout followed by a number is the number of seconds to wait
         for a command to complete. If there is no timeout specified in


@@ -775,15 +850,6 @@
 
 
 
 
 
 

-       timeout 60
-       abort (Busy|Sorry|Fail)
-       # don't forget to chmod 4775 netrom_call!
-       connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh
-       # you can leave this out if you call the script 'gb7dxm'
-       client gb7dxm ax25
-
-
-

 
 
 
 
 
 


@@ -792,9 +858,8 @@
 
   timeout 60
   abort (Busy|Sorry|Fail)
 
   timeout 60
   abort (Busy|Sorry|Fail)

-  # this does exactly the same as the previous example
-  # the '1' is the AGW port number to connect thru for g1tlh
-  connect agw 1 g1tlh
+  # don't forget to chmod 4775 netrom_call!
+  connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh

   # you can leave this out if you call the script 'gb7dxm'
   client gb7dxm ax25
 
   # you can leave this out if you call the script 'gb7dxm'
   client gb7dxm ax25
 


@@ -805,6 +870,21 @@
 
 
 
 
 
 

+       timeout 60
+       abort (Busy|Sorry|Fail)
+       # this does exactly the same as the previous example
+       # the '1' is the AGW port number to connect thru for g1tlh
+       connect agw 1 g1tlh
+       # you can leave this out if you call the script 'gb7dxm'
+       client gb7dxm ax25
+
+
+
+
+
+
+
+

        timeout 15
        connect telnet dirkl.tobit.co.uk
        # tell GB7DJK-1 that it is connected to GB7DJK
        timeout 15
        connect telnet dirkl.tobit.co.uk
        # tell GB7DJK-1 that it is connected to GB7DJK


@@ -842,20 +922,6 @@
 
 
 
 
 
 

-
-
-
-
-
-
-
-
-
-
-
-
-
-

   <- D G1TLH connect gb7djk-1
   -> D G1TLH connection to GB7DJK-1 started
   -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z >
   <- D G1TLH connect gb7djk-1
   -> D G1TLH connection to GB7DJK-1 started
   -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z >