Virtual hosts assigned to a replica set
In contrast to standard junctions, virtual hosts can be individually assigned to different replica sets using the -z option of the pdadmin server task virtualhost create command.
When the distributed session cache is in operation, the -z option specifies the replica set that sessions on the virtual host junction are managed under. If WebSEAL is configured to use the distributed session cache, then the replica set for a virtual host junction can be specified with the -z option. Different virtual host junctions must be assigned to different replica sets. If the -z option is not used, then WebSEAL uses the virtual host name of the junction as the name of the replica set.
Additionally, the name of the replica set used by this virtual host must be defined by the replica-set stanza entry in the [replica-sets] stanza of the configuration file for the WebSEAL instance:
[replica-sets] replica-set = replica-set-name
Example conditions:
- Virtual host type: TCP
- Host name for the machine where the virtual host resides: abc.example.com
- Virtual host name: vh1.example.com
- Virtual host belongs to this replica set: vh1.example.com
- Virtual host junction label: vhost-vh1-http
Example virtual host create command (entered as one line):
pdadmin> server task default-webseald-webseal.example.com virtualhost create -t tcp -h abc.example.com -v vh1.example.com -z vh1.example.com vhost-vh1-http
Example WebSEAL configuration for replica sets:
[replica-sets] replica-set = vh1.example.com
Parent topic: Replica set configuration