rlm_replicate

Synopsis

The replicate modul replicates packets to one or more home servers.

This module will open a new socket for each packet, copy the packet, and send the copy to a home server. Set control:Replicate-To-Realm = name, just as with Proxy-To-Realm. The realm must exist, the home_server_pool must exist, and the home_server must exist. The module will then replicate the packet to the realm(s) specified by the Replicate-To-Realm attribute(s). Each attribute can contain only one realm.

When packets are replicated, the module does not expect a reply. Any reply is ignored. Both Replicate-To-Realm and Proxy-To-Realm can be used at the same time.

To use this module, list replicate in the authorize or accounting section. Then, ensure that Replicate-To-Realm is set. The contents of the packet attribute list will be sent to the home server. The usual load-balancing, etc. features of the home server will be used.

radmin can be used to mark home servers alive/dead. Home servers are marked alive/dead in order to enable/disable replication to specific servers.

Packets can be replicated to multiple destinations. Just set Replicate-To-Realm multiple times. One packet will be sent for each of the Replicate-To-Realm attributes in the control list.

Note	replication does not change any of the packet statistics. If you use `radmin` to look at the statistics for a home server, the replicated packets will cause no counters to increment. This is not a bug, this is how replication works.

Default configuration

Processing Sections

authorize

When listed in the authorize section, the replicate module will replicate Access-Request packets to the realm(s).

Return codes: noop No control:Replicate-To-Realm attribute was found.
: fail The module was unable to replicate the packet.
: ok The module replicated the packet to one or more destination realms.

preacct

When listed in the preacct section, the replicate module will replicate Accounting-Request packets to the realm(s).

Return codes: See authorize, above.

pre-proxy

When listed in the pre-proxy section, the replicate module will replicate proxy request packets to the realm(s).

Return codes: See authorize, above.

recv-coa

When listed in the recv-coa section, the replicate module will replicate request packets to the realm(s).

Return codes: See authorize, above.

Expansions

None.

Directives

None.