Web Services Security Guides › CA SiteMinder® Web Services Security Agent Guide for IIS Web Servers › Upgrade a SOA Agent to a 12.52 WSS Agent

Upgrade a SOA Agent to a 12.52 WSS Agent

This section contains the following topics:

How to Upgrade a SOA Agent

How to Upgrade a SOA Agent

Upgrading a SOA Agent to a 12.52 WSS Agent involves several separate procedures. To upgrade your agent, Follow these steps::

1. Verify that you are in the proper step of the upgrade process for an agent upgrade. You upgrade to 12.52 from r12.1 SP3 at stage two of the CA SiteMinder® Web Services Security upgrade process, as shown in the following illustration:

   

2. Create backup copies of any customized agent-related 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
3. Gather information for the following CA SiteMinder® programs.
   • Agent installation wizard.
   • Agent configuration wizard.
4. Run the installation wizard to upgrade your agent.
5. Run the configuration wizard to configure the upgraded agent.

Run the Installation Wizard to Upgrade your Agent for Web Servers

The installation program for the SiteMinder WSS 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 SiteMinder WSS 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
     

     Important! If you are running this wizard on Windows Server 2008, run the executable file with Administrator permissions, even if you are logged into the system as an Administrator. For more information, see the CA SiteMinder® Web Services Security Release Notes.

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

Note: The software upgrade occurs in the installed location of the existing SOA Agent.

More information:

Multiple Agent for IIS Directory Structures According to Operating Environment

Run the Configuration Wizard on your Upgraded SiteMinder WSS Agent

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 Web Servers on your 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. Open the following directory on your web server:

   WSS_Home\install_config_info
   

   WSS_Home

   Specifies the path to where CA SiteMinder® Web Services Security is installed.

   Default: C:\Program Files\CA\Web Services Security

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, even if you are logged into the system as an Administrator. For more information, see the CA SiteMinder® Web Services Security Release Notes.

   The agent configuration wizard starts.

3. Complete the wizard.