Previous Topic: Clustered Components for ScaleNext Topic: Capacity Planning


Agent to Policy Server Communication

When you configure a SiteMinder Agent, a Host configuration file (named SmHost.conf by default), is created on the host server. The Agent uses the connection information in this Host configuration file to create an initial connection with a Policy Server.

After the initial connection is established, the Agent obtains subsequent Policy Server connection information from the Host Configuration Object (HCO) on the Policy Server. You can configure the HCO to include multiple Policy Servers and specify how the Agent is to distribute requests among multiple Policy Servers.

A SiteMinder Agent can distribute requests among multiple Policy Servers in the following ways:

More information:

SiteMinder Agents

Install a Web Agent on a Windows System

Install a Web Agent on a UNIX System

Failover

Failover is the default HCO setting. In failover mode, a SiteMinder Agent delivers all requests to the first Policy Server that the HCO lists and proceeds as follows:

  1. If the first Policy Server does not respond, the Agent deems it unavailable and redirects the request, and all subsequent requests, to the next Policy Server that the HCO lists.
  2. If the first two Policy Servers do not respond, the Agent deems both of them unavailable and redirects the request, and all subsequent requests, to the next Policy Server that the HCO lists.

Note: For more information about configuring an HCO with multiple Policy Servers, see the Policy Server Configuration Guide.

If an unresponsive Policy Server recovers, which the Agent determines through periodic polling, the Policy Server is automatically returned to its original place in the HCO list and begins receiving all Agent requests.

The following diagram illustrates the Agent failover process:

Illustration showing a SiteMinder Web Agent communicating in failover mode

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Round Robin Load Balancing

Round robin load balancing is an optional HCO setting. Round robin load balancing distributes requests evenly over a set of Policy Servers, which:

Note: For more information about configuring an HCO for round robin load balancing, see the Policy Server Configuration Guide.

In round robin mode, an Agent distributes requests across all Policy Servers that the HCO lists. An Agent:

  1. Sends a request to the first Policy Server that the HCO lists.
  2. Sends a request to the second Policy Server that the HCO lists.
  3. Sends a request to the third Policy Server that the HCO lists.
  4. Continues sending requests in this way, until the Agent has sent requests to all available Policy Servers. After sending requests to all available Policy Servers, the Agent returns to the first Policy Server and the cycle begins again.

If a Policy Server does not respond, the Agent redirects the request to the next Policy Server that the HCO lists. If the unresponsive Policy Server recovers, which the Agent determines through periodic polling, the Policy Server is automatically restored to its original place in the HCO list.

The following diagram illustrates the round robin process:

Graphic showing a SiteMinder Agent distributing requests in round robin mode.

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Policy Server Clusters

Round robin load balancing evenly distributes SiteMinder Agent requests to all Policy Servers that the HCO lists. Although an efficient method to improve system availability and response times, consider that:

A Policy Server cluster is a group of Policy Servers to which Agents can distribute requests. Policy Server clusters provide the following benefits over round robin load balancing:

Note: For more information about configuring a Policy Server cluster, see the Policy Server Administration Guide.

The following diagram illustrates two Policy Server clusters. Each cluster is geographical separated to avoid the network overhead that can be associated with round robin load balancing.

Graphic showing Web Agent load balancing and failover between Policy Server clusters

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Policy Server to User Store Communication

The Policy Server can distribute queries over multiple LDAP or ODBC user stores to enable the following:

Note: For more information about configuring user store connections, see the Policy Server Configuration Guide.

More information:

User Store

Failover

Failover is an optional setting in the SiteMinder user store object. In failover mode, a Policy Server distributes all requests to the primary user store and proceeds as follows:

  1. If the primary user store does not respond, the Policy Server deems it unavailable and redirects the request, and all subsequent requests, to the next user store that the SiteMinder user store object lists.
  2. If the first and second user stores do not respond, the Policy Server deems them both unavailable and redirects the request, and all subsequent requests to the next user store that the SiteMinder user store object lists.

Note: For more information about configuring user store failover, see the Policy Server Configuration Guide.

If an unresponsive user store recovers, the user store is automatically returned to its original place in the failover list and begins receiving all Policy Server requests.

The following diagram illustrates the user store failover process:

Graphic showing a Policy Server communicating with user stores in failover mode

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Round Robin Load Balancing

Round robin load balancing is an optional SiteMinder user store object setting. Round robin load balancing distributes requests evenly over a set of user stores, which:

Note: Consider the following:

In round robin mode, a Policy Server distributes requests across all user stores that the SiteMinder user store object lists. A Policy Server:

  1. Sends a request to the first user store that the user store object lists.
  2. Sends a request to the second user store that the user store object lists.
  3. Sends a request to the third user store that the user store object lists.
  4. Continues sending requests in this way, until the Policy Server has sent requests to all available user stores. After sending requests to all available user stores, the Policy Server returns to the first user store and the cycle begins again.

Note: Configure load balancing with failover to add the benefit of redundancy in the event of a user store failure. For more information about configuring load balancing and failover, see the Policy Server Configuration Guide.

The following diagram illustrates the user store round robin process:

Graphic showing a Policy Server communicating with user stores in load balancing mode

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Policy Server to Policy Store Communication

All Policy Servers must connect to the same policy store for a common view of policy information. However, we recommend that the deployment includes multiple "hot" policy stores to which Policy Servers can failover.

The following are policy store failover scenarios:

More information:

Policy Store

Master Policy Store

Deploying a master policy store with replicated versions is a way to achieve policy store redundancy. A single master policy store lets each Policy Server communicate with the closest replicated version. This method of communication:

Note: For more information about configuring replication, see your vendor–specific documentation. For more information about configuring policy store failover, see the Policy Server Administration Guide.

The following diagram illustrates a single master policy store environment:

Graphic showing the use of a single master policy store to achieve policy store redundancy

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Multi–Mastered Policy Stores

Deploying LDAP directories using multi–master technology is a way to achieve policy store redundancy. A multi–master policy store lets each Policy Server communicate with the closest replicated version. This method of communication:

The following configuration is recommended when configuring an LDAP policy store in multi-master mode:

Due to possible synchronization issues, other configurations may cause inconsistent results, such as policy store corruption or Agent keys that are out of sync.

Contact SiteMinder Support for assistance with other configurations.

The following diagram illustrates a multi–master policy store environment:

Graphic showing the use of a multi-master policy store to achieve policy store redundancy

More information:

Multiple Components for Operational Continuity

Clustered Components for Scale

Policy Server to Audit Store Communication

By default, each Policy Server stores its own audit information to a text file. This text file is known as the Policy Server log. You can configure a Policy Server to log audit data directly to a database.

SiteMinder audit logs are typically used for audit and compliance purposes. Consider the following:

More information:

SiteMinder Audit Database

Policy Server to Session Store Communication

If you deploy a session store, all Policy Servers in the environment must use the same session store database.

Deploying a master session store is a way to achieve session store redundancy. A master session store lets each Policy Server communicate with the closest replicated version. This method of communication:

Note: For more information about configuring replication, see your vendor–specific documentation. For more information about configuring session store failover, see the Policy Server Administration Guide.

The following diagram illustrates all Policy Servers sharing a common view into a session store.

Graphic showing the use of a master session store to achieve session store redundancy

More information:

Session Store

Multiple Components for Operational Continuity

Clustered Components for Scale