new adminmanual
[spider.git] / html / adminmanual-4.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
5  <TITLE>The DXSpider Installation and Administration Manual : Hop control</TITLE>
6  <LINK HREF="adminmanual-5.html" REL=next>
7  <LINK HREF="adminmanual-3.html" REL=previous>
8  <LINK HREF="adminmanual.html#toc4" REL=contents>
9 </HEAD>
10 <BODY>
11 <A HREF="adminmanual-5.html">Next</A>
12 <A HREF="adminmanual-3.html">Previous</A>
13 <A HREF="adminmanual.html#toc4">Contents</A>
14 <HR>
15 <H2><A NAME="s4">4. Hop control</A></H2>
16
17 <P>Starting with version 1.13 there is simple hop control available on a per
18 node basis. Also it is possible to isolate a network completely so that you 
19 get all the benefits of being on that network, but can't pass on information
20 from it to any other networks you may be connected to (or vice versa).
21 <P>
22 <H2><A NAME="ss4.1">4.1 Basic hop control</A>
23 </H2>
24
25 <P>In /spider/data you will find a file called hop_table.pl.  This is the file 
26 that controls your hop count settings.  It has a set of default hops on the 
27 various PC frames and also a set for each node you want to alter the hops for.  
28 You may be happy with the default settings of course, but this powerful tool 
29 can help to protect and improve the network.  The file will look something 
30 like this ...
31 <P>
32 <BLOCKQUOTE><CODE>
33 <PRE>
34
35 # hop table construction
36
37
38 package DXProt;
39
40 # default hopcount to use
41 $def_hopcount = 5;
42
43 # some variable hop counts based on message type
44 %hopcount = 
45 (
46  11 => 10,
47  16 => 10,
48  17 => 10,
49  19 => 10,
50  21 => 10,
51 );
52
53
54 # the per node hop control thingy
55
56
57 %nodehops = 
58
59  GB7ADX => {            11 => 8,
60                         12 => 8,
61                         16 => 8,
62                         17 => 8,
63                         19 => 8,
64                         21 => 8,
65                    },
66
67  GB7UDX => {            11 => 8,
68                         12 => 8,
69                         16 => 8,
70                         17 => 8,
71                         19 => 8,
72                         21 => 8,
73                    },
74  GB7BAA => {
75                         11 => 5,
76                         12 => 8,
77                         16 => 8,
78                         17 => 8,
79                         19 => 8,
80                         21 => 8,
81                    },
82 };
83 </PRE>
84 </CODE></BLOCKQUOTE>
85 <P>
86 <P>Each set of hops is contained within a pair of curly braces and contains a 
87 series of PC frame types.  PC11 for example is a DX spot. The figures here 
88 are not exhaustive but should give you a good idea of how the file works.
89 <P>
90 <P>You can alter this file at any time, including whilst the cluster is running.  
91 If you alter the file during runtime, the command <EM>load/hops</EM> will 
92 bring your changes into effect.
93 <P>
94 <H2><A NAME="ss4.2">4.2 Isolating networks</A>
95 </H2>
96
97 <P>It is possible to isolate networks from each other on a "gateway" node using the
98 <EM>set/isolate &lt;node_call&gt;</EM> command.
99 <P>
100 <P>The effect of this is to partition an isolated network completely from another 
101 nodes connected to your node. Your node will appear on and otherwise behave 
102 normally on every network to which you are connected, but data from an isolated 
103 network will not cross onto any other network or vice versa. However all the 
104 spot, announce and WWV traffic and personal messages will still be handled 
105 locally (because you are a real node on all connected networks), that is locally
106 connected users will appear on all networks and will be able to access and 
107 receive information from all networks transparently.  All routed messages will 
108 be sent as normal, so if a user on one network knows that you are a gateway for 
109 another network, he can still still send a talk/announce etc message via your 
110 node and it will be routed across.
111 <P>
112 <P>The only limitation currently is that non-private messages cannot be passed down 
113 isolated links regardless of whether they are generated locally. This will change 
114 when the bulletin routing facility is added.
115 <P>
116 <P>If you use isolate on a node connection you will continue to receive all 
117 information from the isolated partner, however you will not pass any information 
118 back to the isolated node.  There are times when you would like to forward only 
119 spots across a link (maybe during a contest for example).  To do this, isolate 
120 the node in the normal way and put in a filter in the /spider/filter/spots 
121 directory to override the isolate.  This filter can be very simple and consists 
122 of just one line ....
123 <P>
124 <BLOCKQUOTE><CODE>
125 <PRE>
126 $in = [
127         [ 1, 0, 'd', 0, 3]      # The last figure (3) is the hop count
128 ];
129 </PRE>
130 </CODE></BLOCKQUOTE>
131 <P>
132 <P>There is a lot more on filtering in the next section.
133 <P>
134 <HR>
135 <A HREF="adminmanual-5.html">Next</A>
136 <A HREF="adminmanual-3.html">Previous</A>
137 <A HREF="adminmanual.html#toc4">Contents</A>
138 </BODY>
139 </HTML>