test

Sun Java System Access Manager Policy Agent 2.2 Guide for Microsoft Internet Information Services 6.0

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

Note –

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.

ProcedureTo 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\iis6\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.

Note –

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.

ProcedureTo 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\iis6\bin

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

    cscript.exe IIS6admin.vbs -unconfig defaultConfig

    IIS6admin.vbs

    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.

    -unconfig

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

    defaultConfig

    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.

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

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

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

  7. Restart the web site.

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

ProcedureTo Uninstall Agent for Microsoft IIS 6.0

  1. Change to the following directory:

    PolicyAgent-base\

  2. Run the following command to uninstall the agent:

    java uninstall_Sun_Java_tm_System_Access_Manager_Policy_Agent

  3. Click Next in the Welcome panel.

  4. Click Uninstall Now.

    The program uninstalls the agent.

  5. Restart the server.