Installation and Upgrade Guides › Web Agent Installation Guide for IIS › Uninstall a Web Agent › How to Migrate from an ISAPI-Only SiteMinder Web Agent on IIS 7.x to a SiteMinder r12.0 SP3 Web Agent for IIS 7.x

How to Migrate from an ISAPI-Only SiteMinder Web Agent on IIS 7.x to a SiteMinder r12.0 SP3 Web Agent for IIS 7.x

Web Agent versions older than SiteMinder r12.0 SP3 (such as r12.0 SP3 CR1 and earlier) offered only ISAPI-based protection for IIS web servers 7.0 and 7.5. These older Web Agents extended the IIS 6.0 behavior for Classic Mode IIS 7.x applications.

Upgrading from the previous ISAPI-only versions (which also supported IIS 6.0) is not supported.

To migrate from the ISAPI-only version to r12.0 SP3 of the Web Agent for IIS, use the following process:

1. Remove the ISAPI-only Web Agent for IIS from your web servers.
2. Install the SiteMinder Web Agent for IIS.
3. Configure your SiteMinder Web Agent.

Notes About Uninstalling Web Agents

Be aware of the following:

• All Web Agents for all installed web servers will be uninstalled.
• The Password Services and Forms directories, (pw_default, jpw_default, samples_default) will be removed. However, the non-default copies of these directories (pw, jpw, samples) are not removed because these directories may contain customized files.
• Make sure that the JRE is installed on the Web Agent system, as it is needed for uninstallation. For a supported version, see the SiteMinder r12.0 SP3 Platform Matrix at Technical Support.

Set JRE in PATH Variable Before Uninstalling the SiteMinder Agent

On Windows and UNIX systems, when you are uninstalling a SiteMinder Agent, make sure the JRE is in the PATH variable or the uninstallation program stops and issues one of the following error messages:

• “Could not find a valid Java virtual machine to load. You need to reinstall a supported Java virtual machine.”
• "No Java virtual machine could be found from your PATH environment variable. You must install a VM prior to running this program."

Follow these steps:

On Windows

1. Go to the Control Panel.
2. Double-click System.
3. In the Environment Variables dialog, add the location of the JRE to the PATH system variable.

   For example, C:\j2sdkversion_number\jre\bin

On UNIX

Run the following commands:

1. PATH=$PATH:JRE/bin

   JRE

   Specifies the location of your JRE.

   For example, /usr/bin/j2sdkversion_number/jre

2. export PATH

Uninstall a Web Agent from a Windows Operating Environment

Before you un–install the SiteMinder Web Agent from a Windows operating environment, consider making backup copies of your registry settings and Web Agent configuration settings.

Follow these steps:

1. Stop the web server.
2. Choose one of the following procedures:
   • To remove the Web Agent using the wizard, go to Step 3.
   • To remove the Web Agent using the console-based program, go to Step 8.
3. Click Start, Control Panel, Programs and Features.

   A list of installed programs appears.

4. Click CA SiteMinder Web Agent version_number.
5. Click Uninstall/Change.

   The uninstallation wizard appears.

6. Review the information in the Uninstall SiteMinder Web Agent dialog, then click Uninstall.

   The wizard removes the web agent.

7. Wait for the wizard to finish, then go to Step 12.
8. Open a command-line window.
9. Navigate to the following directory.

   web_agent_home
   

   web_agent_home

   Indicates the directory where the SiteMinder Agent is installed on your web server.

   Default (Windows 32-bit installations of SiteMinder IIS Web Agents only): C:\Program Files\CA\webagent

   Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

10. Run the following command:

    ca-wa-uninstall.cmd -i console
    

11. Wait for the un–installation program to finish, then go to Step 12.
12. Start the web server.

Important! Delete the ZeroG registry file from the following location after uninstalling the Web Agent: C:\Program Files\ZeroG Registry\com.zerog.registry.xml

Silently Remove a SiteMinder Web Agent from a Windows Operating Environment

The SiteMinder Web Agent supports an unattended or silent removal mode which uninstalls a SiteMinder Web Agent from a web server. This option does not require any interaction from the end user.

1. Log in to your web server.
2. Open a Command Prompt window with Administrative privileges.

   Important! Before running a SiteMinder utility or executable on Windows Server 2008, open the command line window with administrator permissions. Open the command line window this way, even if your account has administrator privileges.

3. Run the following command:

   web_agent_home\install_config_info\ca-wa-uninstall\uninstall.exe -f installvariables.properties -i silent
   

   Note: If the path contains spaces, surround it with quotes.

   web_agent_home

   Indicates the directory where the SiteMinder Agent is installed on your web server.

   Default (Windows 32-bit installations of SiteMinder IIS Web Agents only): C:\Program Files\CA\webagent

   Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

   The SiteMinder Web Agent is removed from the web server.

4. For IIS server farms, repeat Steps 1 though 3 for each web server in your farm.