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:
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 and Outlook Web Access: 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.
From the Microsoft Windows Start menu, choose Programs > Administrative Tools > Internet Information Services Manager.
Right click the web site protected by the agent.
Open the Properties tab.
Click Home Directory.
Click Configuration.
Click PolicyAgent-base\iis6\bin\amiis6.dll
Click Remove.
Click Yes at the popup “Remove the selected Script Mapping(s)?.”
Click OK.
Restart the application pool to which the web site belongs.
Restart the web site.
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 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.
Stop the web site for which you have configured the agent.
Stop the application pool to which the web site belongs.
Change to the directory PolicyAgent-base\iis6\bin
Run the following VB script to unconfigure the agent (be aware that the command is case sensitive):
cscript.exe IIS6admin.vbs -unconfig defaultConfig
is a VB script that uses the output of the IIS6CreateConfig.vbs script. The output was saved to a configuration file, which for this example is represented by defaultConfig.
is the option that allows the output to be used to unconfigure the web site.
represents 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.
Accept the default when presented with the following prompt:
Enter the Agent Resource File Name [IIS6Resource.en]:
Restart the application pool to which the web site belongs.
Restart the web site.
Before running the uninstallation program, ensure that you have already unconfigured the agent as follows:
unconfigure the agent from all the web sites for which it was configured as described in Agent Unconfiguration for Microsoft IIS 6.0.
unconfigure the agent from Microsoft Office SharePoint and Outlook Web Access as described in Microsoft Office SharePoint and Outlook Web Access: Unconfiguring the Agent
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.