Upgrade an r12.x Web Agent

Installation and Upgrade Guides › SiteMinder Upgrade Guide › Upgrading from CA SiteMinder® r12.x › How to Migrate from r12.x › Upgrade an r12.x Web Agent

Upgrade an r12.x Web Agent

Upgrading Web Agents is the second step in the migration process.

CA SiteMinder® r12.x Web Agents can communicate with an 12.51 Policy Server. Therefore, upgrade a Policy Server to r12.5 before upgrading a Web Agent to 12.51.

Before You Upgrade an r12.x Web Agent

Before you upgrade Web Agents:

(UNIX) Be sure that you upgrade the Web Agent with the same account that was used to install it. If you use a different account, the upgrade can fail.
Be sure that the Policy Server is configured.
Identify the required administrator and Policy Server object names.
Identify the Web Agent requirements.

Ensure the Policy Server is Configured

Before you upgrade the Web Agent:

Be sure that the Policy Server can connect to the Web Agent host system.
Be sure that the Policy Server is running before registering trusted hosts. You start the Policy Server on the Status tab of the Policy Server Management Console.

Identify the Required Administrator and Policy Server Object Names

Before upgrading the Web Agent, you need the following information from the Policy Server administrator.

Name of the CA SiteMinder® Administrator allowed to register hosts.
Name of the Host Configuration Object.
Name of the Agent Configuration Object.

Identify the Web Agent Requirements

For more information about patches and other Web Agent requirements, see the Web Agent Installation Guide.

Upgrade an r12.x Web Agent

Use the 12.51 web agent installer to upgrade a web agent.

Agents that require option pack functionality must be upgraded to 12.51 before installing the 12.51 Web Agent Option Pack.
Note: For more information about upgrading a web agent, see the Web Agent Installation Guide. For more information about installing the 12.51 Web Agent Option Pack, see the Web Agent Option Pack Guide.
If you have deployed Advanced Password Services, a web agent upgrade retains all LANG (translation) and CFG (configuration) files. The default 12.51 versions of the files are installed to agent_home\samples.

agent_home

Specifies the web agent installation path.

Custom Agent Requirements

To determine if you are required to recompile your custom agent, use the following table:

Agent Type	Required?
CA SiteMinder® agent	Operating system–specific. If the agent operating system has reached end–of–life, you must recompile the custom agent. Upgrade the CA SiteMinder® SDK and recompile the agent on a supported operating system.
Third–party agent	Vendor–specific. Contact your third–party vendor to determine whether the agent is supported.

Agent Type

Required?

CA SiteMinder® agent

Operating system–specific.

If the agent operating system has reached end–of–life, you must recompile the custom agent.

Upgrade the CA SiteMinder® SDK and recompile the agent on a supported operating system.

Third–party agent

Vendor–specific.

Contact your third–party vendor to determine whether the agent is supported.