Agent Guides › SAML Affiliate Agent Guide › Upgrade to SAML Affiliate Agent v6.x QMR 6 › Upgrade a 5.x or 6.0 SAML Affiliate Agent to 6.x QMR 6

Upgrade a 5.x or 6.0 SAML Affiliate Agent to 6.x QMR 6

The following are Affiliate Agents you can upgrade:

• 4.x Affiliate Agent
• 5.5 SAML Affiliate Agent
• 5.5 QMR 1, QMR 2, QMR 3, QMR 4 SAML Affiliate Agent
• 6.0 SAML Affiliate Agent
• 6.x QMR 1, QMR 2, QMR 3, QMR 4, QMR 5 SAML Affiliate Agent

You can upgrade these releases even if you have applied a hotfix.

When you upgrade from a pre-6.x QMR 6 SAML Affiliate Agent, the program lays out the SAML Affiliate Agent files again without altering your existing configuration.

When the upgrade is complete, only one AffiliateConfig.xml file exists, located in the directory saml_affiliate_agent_home/config. The AffiliateConfig.xml file is a shared configuration file for all web servers on the system. The SAML Affiliate Agent can operate with this one file; however, to establish independent AffiliateConfig.xml files for different web servers, run the Configuration Wizard. The Configuration Wizard enables you to modify the configuration and generate a configuration file on a per-web server basis.

To upgrade the SAML Affiliate Agent, the Agent must be compatible with the Policy Server and Web Agent at the producer site. The 6.x SAML Affiliate Agent is compatible with the 6.x Policy Server and 6.x Web Agent. Therefore, an upgrade from a 5.x SAML Affiliate Agent to 6.x also requires an upgrade of the 5.x Policy Server and Web Agent to 6.x.

Note: SAML Affiliate Agent v6.x QMR 6 is not compatible with a SiteMinder 5.x producer.

The following are the main steps for upgrading any 5.5, 5.x QMR x, and r6.x SAML Affiliate Agent to a r6.x QMR 6 SAML Affiliate Agent:

1. Plan a recovery strategy.
2. Uninstall the 5.x/6.x SAML Affiliate Agent.
3. Upgrade to the 6.x QMR 6 SAML Affiliate Agent.
4. Modify the configuration of the upgraded Agent.

These procedures refer to the latest versions of SiteMinder products. For other compatible versions, go to Technical Support and search for SiteMinder Platform Matrix.

Complete the following prerequisites for upgrading a 5.x/6.x SAML Affiliate Agent to 6.x QMR 6.

• On the system that you are upgrading, prepare two web server instances:
  • one non-SSL server
  • one SSL server (for back channel communication)

  Note: Instead of using two server instances, you can use one server instance with two ports (non-SSL and SSL). IIS and Sun ONE 6.0 servers support this type of configuration.

• Verify that a JRE is installed. To verify the supported version, go to Technical Support and search for SiteMinder Platform Matrix.
• Be sure that you have access to the 6.x SiteMinder documentation. You can refer to these guides for additional information.
• Make copies of the AffiliateConfig.xml file, the affiliateserverconf.properties file, and the AM.keystore. Information from these files can be used to configure the upgraded SAML Affiliate Agent.
• As part of the upgrade procedure, supply URL and domain values for the producer and consumer. Use the values from the existing AffiliateConfig.xml file to respond to these prompts. The following information is required:
  • Affiliate Cookie Domain—domain at the consumer for the local server where the SAML Affiliate Agent is installed.
  • SSL Interceptor Root URL—consumer-site URL that enables the SAML Affiliate Agent to receive the SAML artifact. This URL is the secure web server at the consumer site where the SAML Affiliate Agent is installed.
  • Federation Web Services Root URL—secure URL to the producer web server where the Web Agent Option Pack is installed.

  Note: You are prompted for two producer-side URLs, but you are not required to change the configuration at the producer when performing the upgrade.