Previous Topic: How to Prepare for a SiteMinder Web Agent or SiteMinder Agent for IIS Installation on an IIS Web ServerNext Topic: How to Verify that your Windows Operating Environment Meets the Prerequisites for Password Services

Installation and Upgrade Guides › Web Agent Installation Guide for IIS › Preparation › How to Prepare for a SiteMinder Web Agent or SiteMinder Agent for IIS Installation on an IIS Web Server › Review the Policy Server Prerequisites for Agent for IIS Installations

Review the Policy Server Prerequisites for Agent for IIS Installations

Your SiteMinder Agent for IIS needs the following information about the Policy Servers to which it connects:

The Administrative UI creates these SiteMinder objects in the Policy Server. We recommend creating them before installing your agent to avoid going between your web server and the Administrative UI interfaces later.

SiteMinder Agents for IIS require the names of the following SiteMinder objects stored the Policy Server:

Host Configuration Object

Contains the settings that the agent uses for subsequent connections to a Policy Server following the initial connection that the agent made.

Admin User Name

Identifies the name of a SiteMinder user with the following privileges:

Admin Password

Identifies a password that is associated with the Admin User Name in the SiteMinder Policy Server.

Agent Configuration Object

Specifies the name of an Agent Configuration object containing the parameter settings that your Web Agent uses. Agent configuration objects need values in at least one of the following parameters operate:

AgentName

Defines the identity of the Web Agent. This identity establishes a mapping between the name and the IP address of each web server instance hosting an Agent.

When no matching value exists, the agent uses the value of from the DefaultAgentName parameter instead.

Note: This parameter can have more than one value. Use the multivalue option when setting this parameter in an Agent Configuration Object. For local configuration files, add the parameter name and a value to separate lines in the file.

Default: No default

Limits: Must contain 7-bit ASCII characters in the range of 32-127, and include one or more printable characters. Cannot contain the ampersand (&) and asterisk (*) characters. Not case-sensitive. For example, the names MyAgent and myagent are treated the same.

Example: myagent1,192.168.0.0 (IPV4)

Example: myagent2, 2001:DB8::/32 (IPV6)

Example: myagent, www.example.com

DefaultAgentName

Defines a name that the agent uses when no agent name exists in the value of the AgentName parameter.

Using a DefaultAgentName instead of defining a separate Web Agent for each web server helps you set up your SiteMinder environment quickly.

Note: If you do not specify a value for the DefaultAgentName parameter, specify every agent identity in the AgentName parameter. Otherwise, the Policy Server cannot associate policies with the Web Agent.

Default: No default

Limits: Single-value only. Must contain 7-bit ASCII characters in the range of 32-127, and include one or more printable characters. Cannot contain the ampersand (&) and asterisk (*) characters. Not case-sensitive. For example, the names MyAgent and myagent are treated the same.

Review the Web Agent Release Notes for Known Issues

The most-recent versions of the Web Agent Release notes are available from the CA Support website. We recommend reviewing them before installing or configuring a SiteMinder agent.

Follow these steps:

  1. Open a web browser and navigate to the Technical Support website.
  2. Click Enterprise/Small and Medium Business.

    The Support for Businesses and Partners page appears.

  3. Under the Get Support tab, click Product Documentation.

    The documentation page appears.

  4. Click the field under Select a Bookshelf.
  5. Type siteminder.

    A list of SiteMinder bookshelves appears.

  6. Click the bookshelf that you want from the list, and then click Go.

    The bookshelf opens (in a new window or tab, depending on your browser settings).

  7. Click Release Notes.

    A list of release notes appears.

  8. Click one of the following links to display the Release Notes in format you want:

    Note: You need the Adobe Reader software to view PDF documents. Click the Download Adobe Reader link in the bookshelf.