Chapter 7 Uninstalling Policy Agent 2.2 for Microsoft IIS 6.0

This chapter first presents you with methods for disabling a web agent. Then the chapter leads you through the uninstallation process, which first requires you to unconfigure the agent from each web site for which it is currently configured. This chapter is organized as follows:

• Disabling a Web Agent in Policy Agent 2.2

• Agent Unconfiguration for Microsoft IIS 6.0

• Agent Uninstallation for Microsoft IIS 6.0

Disabling a Web Agent in Policy Agent 2.2

The task presented in this section does not apply to deployments where Agent for Microsoft IIS 6.0 protects Microsoft Office SharePoint or Outlook Web Access. To disable (or deactivate) the agent in such a scenario, see Microsoft Office SharePoint: To Deactivate the Access Manager Policy Filter.

In certain situations, you might want to disable a web agent temporarily. The task presented in this section requires you to remove the mapping. If you follow the instructions in this task, and you later want to enable the agent, you need to add the mapping again.

To Disable Agent for Microsoft IIS 6.0

1. From the Microsoft Windows Start menu, choose Programs > Administrative Tools > Internet Information Services Manager.

2. Right click the web site protected by the agent.

3. Open the Properties tab.

4. Click Home Directory.

5. Click Configuration.

6. Click PolicyAgent-base\bin\amiis6.dll

7. Click Remove.

8. Click Yes at the popup “Remove the selected Script Mapping(s)?”.

9. Click OK.

10. Restart the application pool to which the web site belongs.

11. Restart the web site.

Agent Unconfiguration for Microsoft IIS 6.0

If you no longer require Agent for Microsoft IIS 6.0 to protect a particular web site, you can unconfigure the agent from that web site. Furthermore, if you want to uninstall the agent, you must first unconfigure it from all the web sites for which it was configured.

This task does not apply to deployments where Agent for Microsoft IIS 6.0 protects Microsoft Office SharePoint or Outlook Web Access. For such instructions, see Microsoft Office SharePoint and Outlook Web Access: Unconfiguring and Uninstalling the Agent.

Perform the following steps to unconfigure the agent for Microsoft IIS 6.0 from a web site. Make sure that you use the agent configuration file specific to the web site you want to unconfigure. If you need to unconfigure the agent from multiple web sites, you must repeat these steps for each of the web sites.

To Unconfigure Agent for Microsoft IIS 6.0

1. Stop the web site for which you have configured the agent.

2. Stop the application pool to which the web site belongs.

3. Change to the directory PolicyAgent-base\bin

4. Run the following VB script to unconfigure the agent (be aware that the command is case sensitive):

   cscript IIS6admin.vbs -unconfig defaultConfig

   IIS6admin.vbs

   A VB script that uses the output of the IIS6CreateConfig.vbs script. The output was saved to a configuration file, which for this example labeled defaultConfig.

   -unconfig

   The option that allows the output to be used to unconfigure the web site.

   defaultConfig

   A place holder for the name of the agent configuration file created previously as described in To Create Configuration Files: Agent for Microsoft IIS 6.0.

   The script unconfigures the agent and displays the following message:

   Microsoft (R) Windows Script Host Version 5.6 Copyright (C) Microsoft Corporation 1996-2001. All rights reserved. Copyright c 2004 Sun Microsystems, Inc. All rights reserved Use is subject to license terms Enter the Agent Resource File Name [IIS6Resource.en] : Removing the Agent Config Directory Removing the entries from Windows Product Registry Unloading the IIS 6.0 Agent Completed Unconfiguring the IIS 6.0 Agent

   The unconfiguration does the following:

   • Removes the agent configuration directory (specific to a web site)

   • Removes the entries from Windows registry.

   • Removes the wild card application mappings in Microsoft IIS 6.0.

5. Accept the default when presented with the following prompt:

   Enter the Agent Resource File Name [IIS6Resource.en]:

Agent Uninstallation for Microsoft IIS 6.0

Before running the uninstallation program, ensure that you have already unconfigured the agent as follows:

If installed to protect web sites

unconfigure the agent from all the web sites for which it was configured as described in Agent Unconfiguration for Microsoft IIS 6.0.

If installed to protect Microsoft Office SharePoint and Outlook Web Access

unconfigure the agent from Microsoft Office SharePoint and Outlook Web Access as described in Microsoft Office SharePoint and Outlook Web Access: Unconfiguring and Uninstalling the Agent

Uninstallation of Agent for Microsoft IIS 6.0

This task applies to all deployments of Agent for Microsoft IIS 6.0, including deployments where the agent protects Microsoft Office SharePoint or Outlook Web Access.

Perform the following steps to uninstall the agent.

To Uninstall Agent for Microsoft IIS 6.0

1. Change to the following directory:

   C:\Agents\

2. Remove the following directory:

   iis_v6_x64_WINNT_agent

3. Restart the server.