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