Installation and Upgrade Guides › Web Agent Installation Guide for Apache-based servers › Uninstall a Web Agent

Uninstall a Web Agent

This section contains the following topics:

Notes About Uninstalling Web Agents

Uninstall a Web Agent from a Windows Operating Environment

Uninstall a Web Agent from a UNIX System

Uninstall a CA SiteMinder® Agent from a z/OS 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.

Uninstall a Web Agent from a Windows Operating Environment

Before you un–install the CA 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 CA SiteMinder® Web Agent version_number.
5. Click Uninstall/Change.

   The uninstallation wizard appears.

6. Review the information in the Uninstall CA 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 CA SiteMinder® Agent is installed on your web server.

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

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

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA 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

Uninstall a Web Agent from a UNIX System

These instructions are for GUI and Console Mode removal.

Note: Removing a Web Agent from a 64-bit SuSE Linux 10 system requires additional preparations.

The steps for the two modes are the same, with these exceptions for Console Mode:

• Select the option that you want by entering a corresponding number.

Press Enter after each step to proceed through the process instead of "clicking Next," as stated in the following procedure.

Note: Before you uninstall, we recommend copying your agent configuration settings to have as a backup.

1. Stop the web server.
2. Log in to the UNIX system.
3. Navigate to the directory where the Web Agent is installed:

   web_agent_home/install_config_info/ca-wa-uninstall
   

4. If necessary, verify that you have execute permissions on the uninstallation program by entering chmod +x uninstall.
5. From a console window, enter one of the following commands:
   • GUI mode: ./uninstall
   • Console mode: ./uninstall -i console

   The uninstallation program starts.

6. Read the information in the dialog to confirm the removal of the Web Agent, then click Uninstall. The Web Agent is removed from the system.
7. Click Done to exit the uninstallation program.
8. (Optional) For Apache-based agents, remove the lines from the httpd.conf file that the Configuration Wizard added.
9. Change to your home directory (the current directory has been deleted).
10. Restart the web servers.

Uninstall a CA SiteMinder® Agent from a z/OS System

These instructions are for GUI and Console Mode removal. The steps for the two modes are the same, with these exceptions for Console Mode:

• Select the option that you want by entering a corresponding number.
• Press Enter after each step to proceed through the process instead of "clicking Next," as stated in the following procedure.

Note: Before you uninstall, we recommend copying your agent configuration settings to have as a backup.

Follow these steps:

1. Log in as a root user.
2. Stop the web server.
3. Open a shell and navigate to the directory where the CA SiteMinder® agent is installed:

   web_agent_home/install_config_info/ca-wa-uninstall
   

4. If necessary, verify that you have execute permissions on the uninstallation program by entering the following command:

   chmod +x installation_media
   

   installation_media

   Specifies the Policy Server installer executable.

5. Perform one of the following procedures:
   • If you installed the agent using GUI mode, enter the following command from a console window:

     ./ca-wa-uninstall.sh
     

     The uninstallation program starts.

   • If you installed the agent using console mode, use the Configuration Wizard to unconfigure the agent and then delete the web_agent_home directory manually.
6. Read the information in the dialog to confirm the removal of the CA SiteMinder® agent, then click Uninstall. The CA SiteMinder® agent is removed from the system.
7. Click Done to exit the uninstallation program.
8. (Optional) Remove the lines from the httpd.conf file that the Configuration Wizard added.
9. Change to your home directory (the current directory has been deleted).
10. Restart the web servers.