Installation and Upgrade Guides › Web Agent Installation Guide › Uninstall a Web Agent

Uninstall a Web Agent

This section contains the following topics:

Notes About Uninstalling Web Agents

Set JRE in PATH Variable Before Uninstalling the SiteMinder Agent

Uninstall a Web Agent from a Windows Operating Environment

Uninstall a Web Agent from a UNIX System

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