X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=sgml%2Fadminmanual.sgml;h=d91dab680b17f3f7de83b9d1201f4e6f61e257b0;hb=71ce25e28013877858408ae610c9eaf6d1fb001c;hp=cc6ba498f7cdbbc2030356d223cf5dcfbc2eb031;hpb=6be3e1147b774c96b9d35c4c835f913e9c5e0ffc;p=spider.git diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml index cc6ba498..d91dab68 100644 --- a/sgml/adminmanual.sgml +++ b/sgml/adminmanual.sgml @@ -36,31 +36,49 @@ handle loops well at all. It is therefore necessary to have some form of protection for these nodes.
-This is achieved by using filtering on a route basis. There is a
-default setting to help to protect the network, especially useful for new
-and inexperienced SysOps. The idea is simple. When Spider is started
-for the first time and a connection is made to or from another node,
-the default is to only send the nodes you already have that are in your
-own zone. For example, in the UK the default setting would be to send
-only UK nodes to any connection. This can be filtered further (down to
-a single node if needed) or expanded as required.
-
+In fact DXSpider has had a simple system for some time which is called
+
+The new functionality introduced in version 1.48 is filtering the node
+and user protocol frames on a "per interface" basis. We call this
+
+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
+(using the
-As mentioned in the introduction, a default setting exists. If this is
-all you want to use then that is fine, you have nothing else to do.
-However, if you want to make any alterations then you need to know
-a bit about filters.
-
-
-It is possible to reset the default setting for node connections should
-you wish to do so, however this can be dangerous to the network unless
-you have some experience in how all this works.... be careful! It is
-also possible to change settings for one connection only. You can,
-therefore, have many different filters set dependent on the amount of
-node links you have.
+
+Initially when route filters were being tested we generated a
+"default" filter. Unfortunately it quickly became apparent that this
+might suit the UK cluster network but didn't really fit anybody else.
+However using a default filter is an appropriate thing to do. How, is
+explained further on.
+
+
+The first thing that you must do is determine whether you need to do route filtering
+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.
I should at this stage give a little bit of background on filters. All
@@ -69,22 +87,30 @@ accept or reject various options in order to create the filter rules
you wish to achieve. Some filters are user settable, others can only
be altered by the sysop. Route filtering can only be done by the sysop.
-
+Anyway, without further discouragement, let me start the process
+of explanation.
+
+
-As discussed previously, a default setting exists that only sends nodes
-from your own zone. This can be overridden by using the default_node
-filter option like this ...
+All normal systems should have a default routing filter and it should
+usually be set to send only the normal, unlooped, view of your
+"national" network. Here in the UK that means nodes from the UK and
+Eire, in EU it is more complex as the networks there grew up in a more
+intertwined way.
+
+
+The generic commands are:-
where filter_option is one of the following ...
Please be careful if you alter this setting, it will affect
+For the default routing filter then you have two real choices: either
+a "national" view or the "safe" option of only your own
+callsign. Examples of each (for my node: GB7DJK) are:-
+
+
+The example filters shown control
+It is also possible to control the
+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:-
+
+
@@ -116,20 +192,6 @@ or
accept/route <node_call> <filter_option>
-
-where filter_option is one of the following ...
-
-
Here are some examples of route filters ...
@@ -140,6 +202,31 @@ acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
acc/route gb7djk call gb7djk (equiv to SET/ISOLATE)
+In practice you will either be opening the default filter out for a
+partner by defining a specific filter for that callsign:-
+
+
+It is possible to do
@@ -156,7 +243,7 @@ generally at filtering. There are a number of things you can filter in the
DXSpider system. They all use the same general mechanism.
-In general terms you can create a 'reject' or an 'accept' filter which can have
+In general terms you can create a "reject" or an "accept" filter which can have
up to 10 lines in it. You do this using, for example ...