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