Add sh/c and sh/c/n and sh/connect to the user and admin manuals. Sort
[spider.git] / sgml / adminmanual.sgml
index 6f807633730f90a06f42da62daa854351afde06c..39ec64313b937908ad8d4ef2e42b24baf9191516 100644 (file)
@@ -6,7 +6,8 @@
 
 <title>The DXSpider Installation and Administration Manual</title> 
 <author>Ian Maude, G0VGS, (ianmaude@btinternet.com)</author>
-<date>$Date$ $Revision$</date>
+<date>Version 1.47 (Revision 1.30), April 2001</date>
+
 <abstract>
 A reference for SysOps of the DXSpider DXCluster program.
 </abstract>
@@ -254,7 +255,7 @@ 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>Quick installation guide
+<sect>Quick installation guide (Linux version)
 
 <P>
 This section is designed for experienced Spider sysops who want to install
@@ -328,10 +329,10 @@ or, if you wish your users to be able to use SSID's on their callsigns ..
 default  * * * * * *  - sysop /spider/src/client client %s ax25
 </verb></tscreen>
 
-For most purposes this is not desirable. The only time you probably will need this is
-when you need to allow other cluster nodes that are using SSID's in. In this case it
-owuld probably be better to use the first example and then add a specific line for that
-node like this:
+For most purposes this is not desirable. The only time you probably will 
+need this is when you need to allow other cluster nodes that are using SSID's
+in. In this case it would probably be better to use the first example and 
+then add a specific line for that node like this:
 
 <tscreen><verb>
 GB7DJK-2  * * * * * *  - sysop /spider/src/client client gb7djk-2 ax25
@@ -341,15 +342,16 @@ default  * * * * * *  - sysop /spider/src/client client %u ax25
 <sect1>Allowing telnet connects from users 
 
 <P> 
-From version 1.47 there is a new (more efficient) way of doing this (see next section) but, 
-if you prefer, the method of doing it described here will continue to work just fine.
+From version 1.47 there is a new (more efficient) way of doing this
+(see next section) but, if you prefer, the method of doing it described 
+here will continue to work just fine.
  
 <P>
 Allowing telnet connections is quite simple.  Firstly you need to add a line 
 in /etc/services to allow connections to a port number, like this ....
 
 <tscreen><verb>
-spdlogin   7300/tcp     # spider anonymous login port
+spdlogin   8000/tcp     # spider anonymous login port
 </verb></tscreen>
 
 Then add a line in /etc/inetd.conf like this ....
@@ -381,7 +383,7 @@ no good reason for a password prompt to be given so it is not asked for.
 Assuming all is well, then try a telnet from your linux console ....
 
 <tscreen><verb>
-telnet localhost 7300
+telnet localhost 8000
 </verb></tscreen>
 
 <P>
@@ -390,8 +392,8 @@ You should now get the login prompt and be able to login as before.
 <sect1>Setting up telnet connects (from 1.47 onwards)
 
 <P>
-From version 1.47 you can chose to allow the perl cluster.pl program to 
-allow connections direct (i.e. not via the <tt>/spider/src/client</tt>
+From version 1.47 you can choose to allow the perl cluster.pl program to 
+allow connections directly (i.e. not via the <tt>/spider/src/client</tt>
 interface program). If you are using Windows then this is the only method
 available of allowing incoming telnet connections.
 
@@ -403,51 +405,57 @@ up in /etc/inetd.conf. Remember to:-
 killall -HUP inetd
 </verb></tscreen>
 
-<p>
+<P>
 to make the change happen...
 
-<p>
-Having done that then you need to copy the file 
-<tt>/spider/perl/Listeners.pm</tt> to <tt>/spider/local</tt> and 
+<P>
+Having done that, you need to copy the file 
+<em>/spider/perl/Listeners.pm</em> to <em>/spider/local</em> and 
 then edit it. You will need to uncomment the line containing &dquot;0.0.0.0&dquot; 
 and select the correct port to listen on. So that it looks like this:-
 
 <tscreen><verb>
 @listen = (
-    ["0.0.0.0", 7300],
+    ["0.0.0.0", 8000],
 );
 </verb></tscreen>
 
-<p>As standard, the listener will listen on all interfaces simultaniously. If you require more
-control than this, you can specify each interface individually:-
+<P>
+As standard, the listener will listen on all interfaces simultaneously. 
+If you require more control than this, you can specify each interface 
+individually:-
 
 <tscreen><verb>
 @listen = (
-    ["gb7baa.dxcluster.net", 7300],
+    ["gb7baa.dxcluster.net", 8000],
     ["44.131.16.2", 6300],
 );
 </verb></tscreen>
 
-<p>This will only be successful if the IP addresses on each interface are static. 
-If you are using some kind of dynamic IP addressing then the 'default' method is the
-only one which will work.
+<P>
+This will only be successful if the IP addresses on each interface are static. 
+If you are using some kind of dynamic IP addressing then the 'default' method 
+is the only one that will work.
 
 <P>
 Restart the cluster.pl program to enable the listener.
 
 <P>
-One important difference with the internal listener is that no echoing is done by the
-cluster program. Users will need to set 'local-echo' on in their telnet clients if 
-it isn't set automatically (as per the standards). Needless to say this will probably
-only apply to Windows users. 
+One important difference with the internal listener is that no echoing 
+is done by the cluster program. Users will need to set 'local-echo' on in 
+their telnet clients if it isn't set automatically (as per the standards). 
+Needless to say this will probably only apply to Windows users. 
 
 <sect1>Setting up for AGW Engine (1.47 onwards)
 
-<p>AGW Engine is a Windows based ax25 stack. You can connect to an AGW engine from Linux
-as well as Windows based machines.
+<P>
+AGW Engine is a Windows based ax25 stack. You can connect to an AGW engine 
+from Linux as well as Windows based machines.
 
-<p>In order to enable access to an AGW Engine you need to copy <tt>/spider/perl/AGWConnect.pm</tt>
-to <tt>/spider/local</tt> and edit it. Specifically you must:-
+<P>
+In order to enable access to an AGW Engine you need to copy 
+<em>/spider/perl/AGWConnect.pm</em> to <em>/spider/local</em> and edit it. 
+Specifically you must:-
 
 <itemize>
 <item> set <tt>$enable</tt> to 1.
@@ -4172,6 +4180,43 @@ for more information.
 Display all the bad spotter's callsigns in the system, see SET/BADSPOTTER
 for more information.
 
+<sect1>show/configuration (0)
+
+<P>
+<tt>
+<bf>show/configuration &lsqb;&lt;node&gt;&rsqb;</bf> Show all visible nodes and their users
+</tt>
+
+<P>
+This command allows you to see all the users that can be seen
+and the nodes to which they are connected.  With the optional <em>node</em>,
+you can specify a particular node to look at.
+
+This command is normally abbreviated to: sh/c
+
+BE WARNED: the list that is returned can be VERY long
+
+<sect1>show/configuration/node (0)
+
+<P>
+<tt>
+<bf>show/configuration/node</bf> Show all the nodes connected
+</tt>
+
+<P>
+Show all the nodes connected locally and the nodes they have connected.
+
+<sect1>show/connect (1)
+
+<P>
+<tt>
+<bf>show/connect</bf> Show all the active connections
+</tt>
+
+<P>
+This command shows information on all the active connections known to
+the node. This command gives slightly more information than WHO.
+
 <sect1>show/date (0)
 
 <P>