Web Services Security Guides › CA SiteMinder® Web Services Security Upgrade Guide › Upgrading from CA SOA Security Manager r12.1 SP3 › How to Migrate from SOA Security Manager r12.1 SP3 › Upgrade an r12.1 SP3 SOA Agent

Upgrade an r12.1 SP3 SOA Agent

Upgrading the r12.1 SP3 SOA Agents in the environment to 12.52 SP1 WSS Agents is the second step in the migration process. You can upgrade the SOA Agents in your environment in any order.

Note: CA SiteMinder® Web Services Security r12.1 SP3 SOA Agents can communicate with a 12.52 SP1 Policy Server. Therefore, you can upgrade your Policy Server to 12.52 SP1 before upgrading SOA agents while continuing to protect resources.

How to Prepare for a SOA Agent Upgrade

Prepare for upgrading a SOA Agent using the following process:

• (UNIX) Be sure that you upgrade the SOA Agent with the same account that was used to install it. If you use a different account, the upgrade can fail.
• Verify that the Policy Server is configured
• Identify the required administrator and Policy Server object names
• Identify SOA Agent requirements
• Back up customized files
• Replace existing read-only files during the upgrade (if prompted).

Verify the Policy Server is Configured

Before you upgrade the SOA Agent:

• Be sure that the Policy Server can connect to the SOA 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 SOA 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 WSS Agent Requirements

For more information about patches and other WSS Agent requirements, see the respective WSS Agent Guide.

Replace Existing Read-only Files

When you upgrade a SOA Agent, you may see messages asking whether you want to replace read-only files. Select Yes to all.

Upgrade the r12.1 SP3 SOA Agent

Use the 12.52 SP1 WSS Agent installer to upgrade a SOA Agent.

Note: For more information about upgrading a SOA agent, see the respective WSS Agent Guide.