Chetan Gaonker | 7f4bf74 | 2016-05-04 15:56:08 -0700 | [diff] [blame] | 1 | # Replicate packet(s) to a home server. |
| 2 | # |
| 3 | # This module will open a new socket for each packet, and "clone" |
| 4 | # the incoming packet to the destination realm (i.e. home server). |
| 5 | # |
| 6 | # Use it by setting "Replicate-To-Realm = name" in the control list, |
| 7 | # just like Proxy-To-Realm. The configurations for the two attributes |
| 8 | # are identical. The realm must exist, the home_server_pool must exist, |
| 9 | # and the home_server must exist. |
| 10 | # |
| 11 | # The only difference is that the "replicate" module sends requests |
| 12 | # and does not expect a reply. Any reply is ignored. |
| 13 | # |
| 14 | # Both Replicate-To-Realm and Proxy-To-Realm can be used at the same time. |
| 15 | # |
| 16 | # To use this module, list "replicate" in the "authorize" or |
| 17 | # "accounting" section. Then, ensure that Replicate-To-Realm is set. |
| 18 | # The contents of the "packet" attribute list will be sent to the |
| 19 | # home server. The usual load-balancing, etc. features of the home |
| 20 | # server will be used. |
| 21 | # |
| 22 | # "radmin" can be used to mark home servers alive/dead, in order to |
| 23 | # enable/disable replication to specific servers. |
| 24 | # |
| 25 | # Packets can be replicated to multiple destinations. Just set |
| 26 | # Replicate-To-Realm multiple times. One packet will be sent for |
| 27 | # each of the Replicate-To-Realm attribute in the "control" list. |
| 28 | # |
| 29 | # If no packets are sent, the module returns "noop". If at least one |
| 30 | # packet is sent, the module returns "ok". If an error occurs, the |
| 31 | # module returns "fail" |
| 32 | # |
| 33 | # Note that replication does NOT change any of the packet statistics. |
| 34 | # If you use "radmin" to look at the statistics for a home server, |
| 35 | # the replicated packets will cause NO counters to increment. This |
| 36 | # is not a bug, this is how replication works. |
| 37 | # |
| 38 | replicate { |
| 39 | |
| 40 | } |