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.

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.