<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Administration Manual v1.48: Routing and Filtering</TITLE>
+ <TITLE>The DXSpider Administration Manual v1.49: Routing and Filtering</TITLE>
<LINK HREF="adminmanual-2.html" REL=next>
<LINK HREF="adminmanual.html#toc1" REL=contents>
of protection for these nodes.
<P>
<P>In fact DXSpider has had a simple system for some time which is called
-<I>isolation</I>. This is similar to what, in other systems such as
+<I>isolation</I>. This is similar to what in other systems such as
<B>clx</B>, is called <I>passive mode</I>. A more detailed explanation
of <I>isolation</I> is given further below. This system is still available
and, for simple networks, is probably all that you need.
<P>
-<P>The new functionality introduced in version 1.48 is filtering the node
+<P>The new functionality introduced in version 1.48 allows filtering the node
and user protocol frames on a "per interface" basis. We call this
<I>route filtering</I>. This is used <B>instead of</B>
<I>isolation</I>.
<P>
<P>What this really means is that you can control more or less completely
-which PC protocol frames, to do with user and node management, pass to
-each of your partner nodes. You can also limit what comes into your
-node from your partners. You can even control the settings that your
-partner node has for the routing information that it sends to you
+which user and node management PC protocol frames pass to each of your
+partner nodes. You can also limit what comes into your node from your
+partners. It is even possible to control the settings that your partner
+node has for the routing information that it sends to you
(using the <I>rcmd</I> command).
<P>
<H2><A NAME="ss1.2">1.2 Route Filters</A>
However using a default filter is an appropriate thing to do. How, is
explained further on.
<P>
-<P>The first thing that you must do is determine whether you need to do route filtering <B>at all</B>. If you are a "normal" node with two or three partners
-and you arranged in an "official" non-looping tree type network, then <B>you do
-not need to do route filtering</B> and you will feel a lot better for not
-getting involved. If you are successfully using <I>isolation</I> then you
-also probably don't need to use route filtering.
-<P>
-<P>You will only require this functionality if you are
-"well-connected". What that means is that you are connected to several
-different parts of (say) the EU cluster and, at the same time, also
-connected to two or three places in the US which, in turn are
-connected back to the EU. This is called a "loop" and if you are
-seriously looped then you need filtering.
+<P>The first thing that you must do is determine whether you need to use
+route filtering <B>at all</B>. If you are a "normal" node with two or
+three partners and you arranged in an "official" non-looping tree type
+network, then <B>you do not need to do route filtering</B> and you will
+feel a lot better for not getting involved. If you are successfully using
+<I>isolation</I> then you also probably don't need to use route filtering.
+<P>
+<P>To put it simply, you should not mix Isolation and Route Filtering. It
+will work, of sorts, but you will not get the expected results. If you
+are using Isolation sucessfully at the moment, do not get involved in
+Route Filtering unless you have a good supply of aspirin! Once you have
+started down the road of Route Filtering, do not use Isolation either.
+Use one or the other, not both.
+<P>
+<P>You will only require this functionality if you are "well-connected". What
+that means is that you are connected to several different parts of (say)
+the EU cluster and, at the same time, also connected to two or three places
+in the US which, in turn are connected back to the EU. This is called a
+"loop" and if you are seriously looped then you need filtering.
<P>
<P>I should at this stage give a little bit of background on filters. All
the filters in Spider work in basically the same way. You can either
</PRE>
</CODE></BLOCKQUOTE>
<P>Please be careful if you alter this setting, it will affect
-<B><I>ALL</I></B> your links!
+<B><I>ALL</I></B> your links! Remember, this is a <I>default</I>
+filter for node connections, not a <I>per link</I> default.
<P>
<P>For the default routing filter then you have two real choices: either
a "national" view or the "safe" option of only your own
by implication, any other node information (not from the UK and Eire)
is accepted.
<P>
-<P>As I imagine it will take a little while to get one's head around all of this you
-can study the effect of any rules that you try by watching the debug output
-after having done:-
+<P>As I imagine it will take a little while to get one's head around all of
+this you can study the effect of any rules that you try by watching the
+debug output after having done:-
<P>
<BLOCKQUOTE><CODE>
<PRE>
<P>
<BLOCKQUOTE><CODE>
<PRE>
-rej/route gb7djk call_dxcc 61,38 (everything except UK+EIRE nodes)
-rej/route all (equiv to [very] restricted mode)
+rej/route gb7djk call_dxcc 61,38 (send everything except UK+EIRE nodes)
+rej/route all (equiv to [very] restricted mode)
acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
acc/route gb7djk call gb7djk (equiv to SET/ISOLATE)
</PRE>
acc/route gb7baa input all
</PRE>
</CODE></BLOCKQUOTE>
-<P>or restricting it quite a lot, in fact making it very nearly like an <I>isolated</I> node, like this:-
+<P>or restricting it quite a lot, in fact making it very nearly like an
+<I>isolated</I> node, like this:-
<P>
<BLOCKQUOTE><CODE>
<PRE>
but only sends him my local configuration (just a PC19 for GB7DJK and
PC16s for my local users).
<P>
-<P>It is possible to do <B>much</B> more complex rules, there are up to 10
-accept/reject pairs per callsign per filter. For more information see the
-next section.
+<P>It is possible to write <B>much</B> more complex rules, there are up
+to 10 accept/reject pairs per callsign per filter. For more information
+see the next section.
<P>
<P>
<H2><A NAME="ss1.5">1.5 General filter rules</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.
<P>
+<P>SHould any of the nodecalls include an ssid, it is important to wrap the
+whole call in single quotes, like this ...
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+ 'DB0FHF-15' => {
+ 11 => 5,
+ 12 => 8,
+ 16 => 8,
+ 17 => 8,
+ 19 => 8,
+ 21 => 8,
+ },
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>If you do not do this, you will get errors and the file will not work as
+expected.
+<P>
<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.
<P>
-<H2><A NAME="ss1.11">1.11 Isolating networks</A>
+<H2><A NAME="ss1.11">1.11 Hop Control on Specific Nodes</A>
+</H2>
+
+<P>You can set a callsign specific hop count for any of the standard filter
+options so:-
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+set/hops gb7djk spot 4
+set/hops node_default route 10
+set/hops gb7baa wcy 5
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>all work on their specific area of the protocol.
+<P>
+<P>The <EM>set/hops</EM> command overrides any hops that you have set otherwise.
+<P>
+<P>You can set what hops have been set using the <EM>show/hops</EM> command.
+<P>
+<H2><A NAME="ss1.12">1.12 Isolating networks</A>
</H2>
<P>It is possible to isolate networks from each other on a "gateway" node using the
another network, he can still still send a talk/announce etc message via your
node and it will be routed across.
<P>
-<P>The only limitation currently is that non-private messages cannot be passed down
-isolated links regardless of whether they are generated locally. This will change
-when the bulletin routing facility is added.
-<P>
-<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 ....
-<P>
-<BLOCKQUOTE><CODE>
-<PRE>
-$in = [
- [ 1, 0, 'd', 0, 3] # The last figure (3) is the hop count
-];
-</PRE>
-</CODE></BLOCKQUOTE>
+<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 use
+an <EM>acc/spot >call< all</EM> filter to override the isolate.
<P>
<HR>
<A HREF="adminmanual-2.html">Next</A>