Installation and Upgrade Guides › Agent for IIS Installation Guide › Upgrade a Web Agent to 12.51 › How to Prepare for a CA SiteMinder® Agent Upgrade

How to Prepare for a CA SiteMinder® Agent Upgrade

Upgrading a CA SiteMinder® agent involves several separate procedures. To prepare for an upgrade of your agent, follow these steps:

1. Create backup copies of any customized CA SiteMinder® files on your web server. Examples of files you could have customized after installing or configuring your agent include the following files:
   • LocalConfig.conf
   • WebAgent.conf
2. Gather information for the following CA SiteMinder® programs.
   • Agent installation wizard.
   • Agent configuration wizard.
3. Do one of the following tasks:
   • If you are upgrading from version 12.0.3 or higher to 12.51, go to Step 4.
   • If you are upgrading from version 12.0.2 or older, continue with this procedure instead.
4. Run the installation wizard to upgrade your Agent for IIS.
5. Run the configuration wizard to configure the upgraded Agent for IIS.

Run the Installation Wizard to Upgrade your Agent for IIS

The installation program for the agent installs the agent on one computer at a time using the Windows operating environment. This installation program can be run in wizard or console modes. The wizard and console-based installation programs also create a .properties file for subsequent installations and configurations using the unattended or silent method with the same settings.

For example, suppose the Agents in your environment use the same web server version, installation directory, Agent Configuration Object and Policy Servers. Use the installation wizard or console-based installation program for your first installation. Afterwards, you could create your own script to run the installation program with the .properties file the wizard or console-based installation program created.

Follow these steps:

1. Copy the Web Agent installation executable file to a temporary directory on your web server.
2. Do one of the following steps:
   • For wizard-based installations, right-click the installation executable file, and then select Run as Administrator.
   • For console-based installations, open a command line window and run the executable as shown in the following example:

     executable_file_name.exe -i console
     

3. Use the information that you gathered previously to complete the installation.

More information:

Multiple Agent for IIS Directory Structures

Run the Configuration Wizard on your Upgraded Agent for IIS

After gathering the information for your Agent Configuration worksheet, run the Agent Configuration wizard. The configuration wizard creates a runtime instance of the Agent for IIS on your IIS web server.

Running the configuration wizard once creates a properties file. Use the properties file to run unattended configurations on other computers with same operating environment and settings.

Note: The configuration wizard for this version of the Agent for IIS does not support console mode.

Follow these steps:

1. Click Start, All Programs, CA, CA SiteMinder®.

   A shortcut to the Web Agent Configuration wizard appears.

2. Right-click the shortcut, and then select Run as administrator.

   Important! If you are running this wizard on Windows Server 2008, run the executable file with administrator permissions. Use these permissions even if you are logged in to the system as an administrator. For more information, see the release notes for your CA SiteMinder® component.

   The Web Agent Configuration wizard starts.

3. Complete the wizard.