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