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 Upgrade an Agent for IIS from Version 12.0.2 or Lower

How to Upgrade an Agent for IIS from Version 12.0.2 or Lower

Upgrading an agent for IIS to version 12.0.3 or higher requires removing the older version of the agent before installing the newer version. Some directory changes were introduced in 12.0.3 which also apply to the subsequent versions of the product. Running the new installation program without removing the previous version sometimes causes problems.

Follow these steps:

1. Remove the configuration of your existing agent from your web server.
2. Remove the existing agent software from your web server.
3. Install the new version of the agent on your web server.
4. Configure the new version of the agent on your web server.
5. (Optional) Review the directory structure of the new agent.

Remove the configuration of your existing agent from your web server

Before upgrading your agent to 12.0.3 or higher, remove the server configuration from the previous version of your agent using the configuration wizard. For example, if you are upgrading from 6.x to 12.51, remove the server configuration for the 6.x version of your agent using the configuration wizard.

Follow these steps:

1. Start the Web Agent Configuration Wizard.

   The default method is to select Start, Programs, CA SiteMinder®, Web Agent Configuration Wizard. If you have placed the Wizard shortcut in a non‑default location, the procedure differs slightly.

   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.

2. Skip to the next step. You do not need to register a trusted host.
3. Clear the check boxes of the web server instances from which you want to remove the configuration.
4. In the Agent Configuration Object field, enter the name of the Agent Configuration Object for this web server instance, then click Next.

   This name must match an Agent Configuration Object that already defined at the Policy Server.

5. In the Web Server Configuration Summary dialog, confirm that the configuration settings are correct, then click Install.

   The Web Agent files are installed.

6. Click Done when the installation is complete.
7. Reboot the computer.

Remove the existing agent software from your web server

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.

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.

Follow these steps:

1. Stop the web server.
2. Remove the configuration settings for the agents on your server with one of the following procedures:
   • To un-configure the agent with the wizard, go to Step 3.
   • To un-configure the agent with the console‑based program, go to Step 6.
3. Click Start, All Programs, CA, CA SiteMinder®.

   A shortcut to the Web Agent Configuration wizard appears.

4. 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.

5. Clear the check boxes from the agent instances configured on your web server, and complete the wizard.
6. Open a Command Prompt window with root privileges.
7. Navigate to the ca-wa-config.exe file, and then run it with the following switch:

   -i console
   

8. Un‑configure the agent instances configured on your web server. Wait for the configuration program to finish, then go to Step 9.
9. Choose one of the following procedures:
   • To remove the Web Agent using the wizard, go to Step 10.
   • To remove the Web Agent using the console-based program, go to Step 15.
10. Click Start, Control Panel, Programs and Features.

    A list of installed programs appears.

11. Click CA CA SiteMinder® Web Agent version_number.
12. Click Uninstall/Change.

    The uninstallation wizard appears.

13. Review the information in the Uninstall CA SiteMinder® Web Agent dialog, then click Uninstall.

    The wizard removes the web agent.

14. Wait for the wizard to finish, then go to Step 17.
15. Open a command-line window.
16. 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

17. Run the following command:

    ca-wa-uninstall.cmd -i console
    

18. Wait for the un–installation program to finish, then go to Step 19.
19. 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

Install the new version of the agent on your web server

After unconfiguring and removing the older version of your agent, install version 12.51 on your web server.

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
     

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

Configure the new version of the agent on your web server

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.

   Complete the wizard.

(Optional) Review the directory structure of the new agent

The directory structure added to your IIS web server for your Agent files varies according to the operating environment of your IIS web server. The following directory structures exist:

• CA SiteMinder® Agents for IIS use the directory structure shown in the following illustration:

  

• CA SiteMinder® Agents for IIS installed on 64-bit operating environments use the directory structure shown in the following illustration: