added client file
[spider.git] / html / hops.html
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2 <html>
3   <head>
4     <title>Hops, Network Isolation and other matters...</title>
5         <meta name="Keywords" content="DX Cluster, DXSpider, Spider, Packet Cluster, DXCluster, Pavillion Software, AK1A, AX25, AX.25, WWV, Packet Radio, Amateur Radio, Propagation, DX, DXing, G1TLH, GB7TLH, Dirk Koopman, Mailing list, Linux, RedHat, PERL">
6         <meta name="Description" content="Software and systems for realtime digital communications between amateur radio stations for the provision of information on propagation conditions and stations operating">
7         <meta name="Author" content="Dirk Koopman G1TLH">
8   </head>
9
10   <body TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#FFFFFF">
11         <FONT COLOR="#606060"> 
12           <hr>
13           <h2>Hops, Network Isolation and other matters...</h2>
14           <hr>
15         </font>
16         
17         
18         <address><a href="mailto:djk@tobit.co.uk">Dirk Koopman G1TLH</a></address>
19         <p>
20           <!-- Created: Sun Dec 13 20:25:14 GMT 1998 -->
21           <!-- hhmts start -->
22 Last modified: Mon Dec 21 11:57:54 GMT 1998
23 <!-- hhmts end -->
24
25         <h4>Introduction</h4>
26         
27         Starting with version 1.13 there is simple hop control available on a per
28         node basis. Also it is possible to isolate a network completely so that you 
29         get all the benefits of being on that network, but can't pass on information
30         from it to
31         to any other networks you may be connected to (or vice versa).
32         
33         <h4>Basic Hop Control</h4>
34
35         The number of hops that are set for all PC protocol messages (that require them)
36         are specified in <tt>/spider/perl/DXProtVars.pm</tt>. 
37
38         <p>In versions prior to 1.13 you would move this file to
39         <tt>/spider/local/</tt> and modify the perl variables:
40         <tt>$def_hopcount</tt> and <tt>%hopcount</tt> to some reasonable
41         values.
42
43         <p>From version 1.13 onwards a new mechanism has been introduced
44         which uses a file called <tt>/spider/data/hop_count.pl</tt>. The
45         prefered way of doing basic hop control is now to create this file
46         and modify it as you wish. Eventually this file will contain all
47         the hop control and related information. An example of the
48         <tt>hop_count.pl</tt> file can be found in the
49         <tt>/spider/examples</tt> directory.
50
51         <p>You can change this file at any time, including when the
52         cluster is running. If you do this then the changes only take
53         effect after you have run the <tt>load/hops</tt> command on a
54         client console with full sysop privileges.
55
56         <h4>Per Node Hop Control</h4>
57
58         From version 1.13 it is possible to control the number of hops to each
59         node. This is done by adding information to the <tt>%nodehops</tt> perl
60         variable in the <tt>hop_count.pl</tt> file (as described above). This
61         variable is a perl "hash of hashes", which means that you create an 
62         entry for every callsign you wish to control and then one line for
63         every PC protocol message that you wish to alter. 
64
65         <p>You can also have a entry called <tt>default</tt> for every callsign 
66           so you can set the hops as a whole for all PC messages to just that
67           callsign. This is overridden by any specific hop counts you may have.
68
69         <h4>Example <tt>hop_count.pl</tt> File</h4>
70
71         An example for you:-
72
73         <p><pre>
74 #
75 # hop table construction
76 #
77
78 package DXProt;
79
80 # default hopcount to use
81 $def_hopcount = 15;
82
83 # some variable hop counts based on message type
84 %hopcount =
85 (
86     11 => 10,
87     16 => 10,
88     17 => 10,
89     19 => 10,
90     21 => 10,
91 );
92
93 #
94 # the per node hop control thingy
95 #
96  
97 %nodehops =
98 (
99     GB7DJK-1 => 
100     {
101          11 => 5,
102          16 => 23,
103          17 => 23,
104          default => 50,
105     },
106
107     GB7TLH => 
108     {
109          19 => 45,
110          21 => 45,
111          16 => 45,
112          17 => 45,
113          default => 15, 
114     },
115 );                              
116         </pre>
117
118         <p>The figures chosen are not necessarily what I use. What I would say is that
119           until you are certain that you know what you are doing (and that the software
120           is working at least as well as advertised) you should keep the default hop 
121           counts down to the sort of levels shown above.
122  
123         <h4><a name="isolate"></a>Isolated Networks</h4>
124
125         It is possible to isolate networks from each other on a "gateway" node using
126         the <tt>set/isolate &lt;node call></tt> command.
127         
128         <p>The effect of this is to partition an isolated network
129         completely from another nodes connected to your node. Your node
130         will appear on and otherwise behave normally on every network to
131         which you are connected, but data from isolated network will not
132         cross onto any other network or vice versa.
133
134         <P>However all the spot, announce and WWV traffic and personal
135         messages will still be handled locally (because you are a real
136         node on all connected networks), that is locally connected users
137         will appear on all networks and will be able to access and receive
138         information from all networks transparently.
139
140         <p>All routed messages will be sent as normal, so if a user on one
141           network knows that you are a gateway for another network, he can still
142           still send a talk/announce etc message via your node and it will 
143           be routed across.
144
145         <p>The only limitation currently is that non-private messages
146         cannot be passed down isolated links regardless of whether they
147         are generated locally. This will change when the bulletin routing
148         facility is added.
149
150 <!-- Standard Footer!! -->
151         <p>&nbsp;</p>
152         <p>
153           <FONT COLOR="#606060"><hr></font>
154         <font color="#FF0000" size=-2>
155           Copyright &copy; 1998 by Dirk Koopman G1TLH. All Rights Reserved<br>
156         </font>
157         <font color="#000000" size=-2>$Id$</font>
158   </body>
159 </html>