Previous Topic: Step 4: Modify the Configuration of the Upgraded Agent

Next Topic: Plan a Recovery Strategy

Upgrade a 4.51/4.61 Affiliate Agent to a 6.x SAML Affiliate Agent

Migrating a 4.51/4.61 federated environment to a 6.x environment involves tasks at the producer site, where the Policy Server and Web Agent reside, and at the consumer site, where the SAML Affiliate Agent resides.

No script automatically upgrades a 4.51/4.61 Affiliate Agent to the 6.x QMR 6 SAML Affiliate Agent—you must follow the upgrade procedure.

Note: You can only upgrade a 4.51/4.61 Affiliate Agent to a SAML Affiliate Agent on web server platforms that support the SAML Affiliate Agent. For example, if the 4.x Affiliate Agent is installed on an iPlanet 4.1 server running Solaris, it cannot be upgraded to a SAML Affiliate Agent on that same platform.

The following illustration shows the upgrade tasks required at the producer site:

upgrade_4xaff_producer_side

The following upgrade tasks are required at the consumer site:

  1. Copy the 4.x Affiliate.conf file.
  2. Install the SAML Affiliate Agent v6.x QMR x.
  3. Transfer the 4.x affiliate configuration to the SAML Affiliate Agent.
  4. Enable the SAML Affiliate Agent.

During an upgrade you must take each component offline, perform the upgrade, then bring it back online. Each component is unavailable to the others during the migration.

When the upgrade is complete, the components of the federated network are similar to the following illustration.

upgrade_completed

Important! We strongly recommend reading through the entire upgrade procedure before you upgrade.