Installation and Upgrade Guides › Web Agent Installation Guide › Upgrade a Web Agent to r12.0 SP3 › Upgrade a Web Agent to r12.0 SP3 on Windows Systems

Upgrade a Web Agent to r12.0 SP3 on Windows Systems

The executable on the SiteMinder media upgrades your existing SiteMinder Web Agents to r12.0 SP3, provided the web server version has not changed since the last installation of the Web Agent.

If you have upgraded the web server itself since you last installed the Web Agent, the Agent upgrade may not work. The upgrade is ensured only if the web server version has remained the same since the last Web Agent installation. However, you can upgrade if you have applied a hotfix.

Important! Remove any 5.x Web Agent Option Packs before upgrading to r12.0 SP3. 6.x Web Agent Option Packs do not need to be removed before upgrading to r12.0 SP3. For more information about removing and reinstalling Web Agent Option Packs, see the SiteMinder Web Agent Option Pack Guide.

Consider the following:

• If the installation program detects any locked Agent files, it prompts you to restart your system instead of reconfiguring it. Select whether to restart the system immediately or later.
• If you are installing an Agent on an Oracle iPlanet web server, you may see an error message stating that the httpd.exe service is unable to locate the smconapi.dll. If this message appears, reboot your system before launching the Web Agent Configuration Wizard.

To upgrade Web Agents on Windows

1. Exit all applications that are running and stop the web server.
2. Download the installation program from Technical Support.

   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 SiteMinder component.

3. Navigate to the win32 folder and double-click the ca-wa-version_number-win32.exe file.

   The Installation Wizard starts.

4. In the Introduction dialog box, read the information then click Next.
5. Read the License Agreement. Click the radio button to accept the terms of the license agreement, and then click Next.
6. Read the notes in the Important Information dialog box, then click Next.
7. Select the placement of the Agent Configuration Wizard shortcut in the Choose Shortcut Folder dialog box then click Next.

   To allow all users access to the Configuration Wizard via the shortcut, select the Create Icons for All Users check box. Otherwise, clear the check box.

   The upgrade program locates the existing Web Agent and displays the Confirm Upgrade dialog box.

8. In the Confirm Upgrade dialog box, select one of the following options, and then click Next:
   • Continue with the upgrade—upgrades the Web Agent to r12.0 SP3.
   • Abort the upgrade—exits the upgrade procedure without upgrading the Web Agent.
9. In the Pre-installation Summary dialog box, confirm that the installation settings are correct, then click Install.

   The new Web Agent files are copied to the specified location.

   Note: The installation program may detect that newer versions of certain system .dlls are installed on your system. If you are prompted to overwrite these newer files with older files, click No To All.

10. In the Install Complete dialog box, choose whether to restart your system immediately or later. Then click Done.
11. Re-configure your upgraded web agent with the Web Agent Configuration Wizard.

    Note: You do not need to re-register your trusted host.

    Note: If you have upgraded IIS Web Agent r6, add write permission to the NETWORK SERVICE account for SmHost.conf.