Make changes to the installation manual to show making the client before
authorg0vgs <g0vgs>
Mon, 26 Nov 2001 20:30:00 +0000 (20:30 +0000)
committerg0vgs <g0vgs>
Mon, 26 Nov 2001 20:30:00 +0000 (20:30 +0000)
actually trying to use it!  Thanks to oz1lqh.  Also add a line for SuSE
distros on useradd.

Changes
html/installation-1.html
html/installation-2.html
html/installation-3.html
html/installation-4.html
html/installation-5.html
html/installation-6.html
html/installation.html
sgml/installation.sgml
txt/installation.txt

diff --git a/Changes b/Changes
index 69e98ec5635faf3deb0adef5696f6802fec83c72..986b2d04fe9c80d404bc00ce4f98ba4d37596d79 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,3 +1,7 @@
+26Nov01=======================================================================
+1. Make changes to the installation manual to show making the client before
+actually trying to use it!  Thanks to oz1lqh.  Also add a line for SuSE
+distros on useradd.
 22Nov01=======================================================================
 1. finally fix DELETE = ^H = Backspace in console.pl
 21Nov01=======================================================================
index 300ad0521be21d6a6b5e05bf9b24cbffc2ba77f5..a781b1e24f053f44bef34daea13737ed041e59e2 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48: Linux Installation </TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49: Linux Installation </TITLE>
  <LINK HREF="installation-2.html" REL=next>
 
  <LINK HREF="installation.html#toc1" REL=contents>
@@ -118,13 +118,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>
-<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>
@@ -240,7 +247,19 @@ $ ./create_sysop.pl
 </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!  
@@ -292,17 +311,6 @@ shutdown
 <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>
index 31718650ee76af7c008de4390135fb50ada7b5cd..5ccaefefe09af03062b39096b88dba1b7f16ada8 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48: Linux quick installation guide</TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49: Linux quick installation guide</TITLE>
  <LINK HREF="installation-3.html" REL=next>
  <LINK HREF="installation-1.html" REL=previous>
  <LINK HREF="installation.html#toc2" REL=contents>
index 165d01c209d69439c972f77126fc4ecb407f71c2..8484effcc54a4538910c259150d3be0da9b003bc 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48: Configuration</TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49: Configuration</TITLE>
  <LINK HREF="installation-4.html" REL=next>
  <LINK HREF="installation-2.html" REL=previous>
  <LINK HREF="installation.html#toc3" REL=contents>
index f74b989f6ab92bcd384682df7aa285c33f8bcc8c..d17f1305cbc5fc8425497b0ba945bdd3afbde3df 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48: Microsoft Windows Installation</TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49: Microsoft Windows Installation</TITLE>
  <LINK HREF="installation-5.html" REL=next>
  <LINK HREF="installation-3.html" REL=previous>
  <LINK HREF="installation.html#toc4" REL=contents>
index 1ce906cca9daa5d92015f1cc60a5c1387ffdbac6..f9354ad10d526c762ec5bc2de6776638935101b9 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48: Installing the software</TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49: Installing the software</TITLE>
  <LINK HREF="installation-6.html" REL=next>
  <LINK HREF="installation-4.html" REL=previous>
  <LINK HREF="installation.html#toc5" REL=contents>
index f0228118991c2543ac7e612d1de16712f822d362..d47532aabe2a480c253019664d6a8a0fc5f58078 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48: General Information</TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49: General Information</TITLE>
  <LINK HREF="installation-5.html" REL=previous>
  <LINK HREF="installation.html#toc6" REL=contents>
 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
index 8546fe90bc011408fefa6d997ed33fad9b119830..4cf6c7b44a02b3c188baea48546971450f56c8a0 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation Manual v1.48</TITLE>
+ <TITLE>The DXSpider Installation Manual v1.49</TITLE>
  <LINK HREF="installation-1.html" REL=next>
 
 
 Previous
 Contents
 <HR>
-<H1>The DXSpider Installation Manual v1.48</H1>
+<H1>The DXSpider Installation Manual v1.49</H1>
 
 <H2>Iain Philipps, G0RDI (g0rdi@77hz.com) and
-Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>Version 1.48, September 2001 revision 1.0
+Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>November 2001 revision 1.0
 <P><HR>
 <EM>A reference for SysOps of the DXSpider DXCluster program.</EM>
 <HR>
@@ -28,8 +28,8 @@ Ian Maude, G0VGS, (ianmaude@btinternet.com)</H2>Version 1.48, September 2001 rev
 <LI><A HREF="installation-1.html#ss1.2">1.2 Preparation</A>
 <LI><A HREF="installation-1.html#ss1.3">1.3 Installing the software</A>
 <LI><A HREF="installation-1.html#ss1.4">1.4 Setting callsigns etc</A>
-<LI><A HREF="installation-1.html#ss1.5">1.5 Starting up for the first time</A>
-<LI><A HREF="installation-1.html#ss1.6">1.6 The Client program</A>
+<LI><A HREF="installation-1.html#ss1.5">1.5 The client program</A>
+<LI><A HREF="installation-1.html#ss1.6">1.6 Starting up for the first time</A>
 </UL>
 <P>
 <H2><A NAME="toc2">2.</A> <A HREF="installation-2.html">Linux quick installation guide</A></H2>
index 1f4a86f525d6f16c51e17fcd773c299ae02effac..50e9e5c272613c76cf6f2bc541c510a70212f4c0 100644 (file)
@@ -4,10 +4,10 @@
 
 <!-- Title information -->
 
-<title>The DXSpider Installation Manual v1.48</title> 
+<title>The DXSpider Installation Manual v1.49</title> 
 <author>Iain Philipps, G0RDI (g0rdi@77hz.com) and
 Ian Maude, G0VGS, (ianmaude@btinternet.com)</author>
-<date>Version 1.48, September 2001 revision 1.0</date>
+<date>November 2001 revision 1.0</date>
 
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
@@ -122,11 +122,17 @@ 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>
 <tscreen><verb>
 # adduser -m sysop
 </verb></tscreen>
 
+<P>
+For SUSE distributions, the command would be ..
+
+<tscreen><verb>
+# useradd -m sysop
+</verb></tscreen>
+
 <P>
 Now set a password for the user ...
 
@@ -243,6 +249,18 @@ the sysop.
 $ ./create_sysop.pl
 </verb></tscreen>
 
+<sect1>The client program
+
+<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.
+
+
 <sect1>Starting up for the first time
 
 <P>
@@ -291,17 +309,6 @@ shutdown
 <P>
 and both the cluster and the client should return to Linux prompts.
 
-<sect1>The Client program
-
-<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.
-
 
 <sect>Linux quick installation guide
 
index 0c23cec97650ffdd628c2c00d0d2636b92a94dec..df4e0cdf3a988777ae6f17445d3c0e770d4dcd81 100644 (file)
@@ -1,7 +1,7 @@
-  The DXSpider Installation Manual v1.48
+  The DXSpider Installation Manual v1.49
   Iain Philipps, G0RDI (g0rdi@77hz.com) and Ian Maude, G0VGS,
   (ianmaude@btinternet.com)
-  Version 1.48, September 2001 revision 1.0
+  November 2001 revision 1.0
 
   A reference for SysOps of the DXSpider DXCluster program.
   ______________________________________________________________________
@@ -15,8 +15,8 @@
      1.2 Preparation
      1.3 Installing the software
      1.4 Setting callsigns etc
-     1.5 Starting up for the first time
-     1.6 The Client program
+     1.5 The client program
+     1.6 Starting up for the first time
 
   2. Linux quick installation guide
 
 
 
 
+  For SUSE distributions, the command would be ..
+
+
+
+       # useradd -m sysop
+
+
+
+
+
   Now set a password for the user ...
 
 
 
 
 
-       # chown -R sysop.spider spider
-       # find . -type d -exec chmod 2775 {} \;
-       # find . -type f -exec chmod 775 {} \;
+  # chown -R sysop.spider spider
+  # find . -type d -exec chmod 2775 {} \;
+  # find . -type f -exec chmod 775 {} \;
 
 
 
        $ cd ../perl
 
 
+
+
+
   Now type the following command which creates the basic user file with
   you as the sysop.
 
 
 
 
-  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!  It should look something like this ...
        $ ./client
 
 
-
-
-
   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
        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.
+  and both the cluster and the client should return to Linux prompts.
 
 
 
 
   o  cp perl/DXVars.pm.issue local/DXVars.pm (sysop)
 
+
   o  cd to /spider/local and edit DXVars to set your details (sysop)
 
   o  cd ../perl (sysop)
 
   o  Login as root
 
-
   o  Enter the correct line in ax25d.conf (root)
 
   o  Enter the correct line in /etc/services (root)
   ..
 
 
-
        default  * * * * * *  - sysop /spider/src/client client %s ax25
 
 
 
 
 
-
-  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
 
 
 
 
        ./client login telnet
 
-
-
-
   You should get a login prompt and on issuing a callsign, you will be
   given access to the cluster.  Note, you will not get a password login.
   There seems no good reason for a password prompt to be given so it is
   Assuming all is well, then try a telnet from your linux console ....
 
 
+
        telnet localhost 8000
 
 
 
 
 
-       @listen = (
-           ["gb7baa.dxcluster.net", 8000],
-           ["44.131.16.2", 6300],
-       );
+
+
+
+
+  @listen = (
+      ["gb7baa.dxcluster.net", 8000],
+      ["44.131.16.2", 6300],
+  );
 
 
 
 
 
 
-       set/node        (AK1A type)
-       set/spider
-       set/dxnet
-       set/clx
+  set/node        (AK1A type)
+  set/spider
+  set/dxnet
+  set/clx
 
 
 
   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
        unset/node gb7baa
 
 
-
-
-
   3.6.  Connection scripts
 
   Because DXSpider operates under Linux, connections can be made using
   connections is therefore relatively simple.
 
 
-
   The connect scripts consist of lines which start with the following
   keywords or symbols:-
 
   There are many possible ways to configure the script but here are
   three examples, one for a NETRom/AX25 connect, one for AGW engines and
   one for tcp/ip.
-
-
-
-
-
-
-
-
-
-  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
+       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