Web Services Security Guides › CA SiteMinder® Web Services Security Upgrade Guide › Planning Migration and Upgrades › SiteMinder Documentation

SiteMinder Documentation

CA SiteMinder® documentation is available through a bookshelf. The CA SiteMinder® bookshelf lets you:

• Use a single console to view all documents that are published for CA SiteMinder®.
• Use a single alphabetical index to find a topic in any document.
• Search all documents for one or more words.

CA SiteMinder® product documentation continues to be available separately. This guide references other CA SiteMinder® guides. We recommend that you locate the documentation before beginning an upgrade.

More information:

Locate the Bookshelf

Component Versions in this Guide

This guide details the paths for upgrading a SOA Security Manager r12.1 SP3 environment to CA SiteMinder® Web Services Security 12.52.

The component versions in this guide include:

• CA SOA Security Manager Administrative UI upgrades from r12.1 SP3 to CA SiteMinder® Administrative UI 12.52.
• CA SOA Manager Security Policy Server and policy store upgrades from r12.1 SP3 to CA SiteMinder® Policy Server and policy store 12.52.
• SOA Agent upgrades from r12.1 SP3 to SiteMinder WSS Agents 12.52.

Policy Server and Policy Store Versions in this Guide

This guide details the considerations and migration paths for upgrading your CA SOA Security Manager Policy Server and policy store from CA SOA Security Manager r12.1 SP3 to CA SiteMinder® 12.52.

Note: The CA SiteMinder® Web Services Security r12.1 SP3 Policy Server is an extended version of the SiteMinder r12 SP3 Policy Server. The 6.0.6 CA SiteMinder® Policy Server includes the CA SiteMinder® Web Services Security extensions. Therefore, there is no CA SiteMinder® Web Services Security Policy Server in a CA SiteMinder® Web Services Security 12.52 environment — the CA SiteMinder® 12.52 Policy Server supports web service access control requests from SiteMinder WSS Agents (formerly SOA Agents).

Upgrade Paths

An upgrade consists of deploying 12.52 components to an existing CA SiteMinder® environment. Upgrading to 12.52 can be accomplished in two ways:

• Completing a migration.
• Configuring a parallel 12.52 environment next to an existing environment. Both environments use one or more key stores to maintain single sign–on.

Migration

A migration is the process of upgrading individual CA SOA Security Manager components until your environment is operating at CA SiteMinder® Web Services Security 12.52. Upgrading individual components consists of one or more steps during which you:

• Take a component offline.
• Upgrade the component.
• Bring the component online.

You upgrade individual components over an extended period to maintain system availability. A key to maintaining system availability is the order in which you upgrade components. During a migration, specific components that have been upgraded can continue to communicate with prior versions. This type of communication is known as mixed-mode support.

The following illustrates the concept of a migration:

Parallel Upgrade

A parallel upgrade is the process of configuring a CA SiteMinder® Web Services Security 12.52 environment beside an existing r12.1 SP3 environment. Configuring a parallel upgrade consists of multiple steps during which you:

• Leave the existing environment unchanged
• Configure a 12.52 environment
• Use a common key store or multiple key stores to enable single sign–on between both environments

The following illustrates the concept of a parallel upgrade.