test

Sun Java System Access Manager Policy Agent 2.2 Guide for Apache HTTP Server 2.0.54

Chapter 7 Uninstalling Policy Agent 2.2 for Apache HTTP Server

This chapter first presents you with a method for disabling a web agent. The task is the same for all web agents on all platforms. Then the chapter leads you through the uninstallation process on the available platforms as follows:

All Systems: Disabling a Web Agent in Policy Agent 2.2

In certain situations, you might want to disable a web agent temporarily. You can disable any web agent by resetting the property that controls the not-enforced URI list in the web agent AMAgent.properties configuration file.

ProcedureTo Disable a Web Agent in Policy Agent 2.2

This task requires that you reset the following property:


com.sun.am.policy.agents.config.notenforced_list

  1. Reset the value of this property to the asterisk, “*,” as follows:

    com.sun.am.policy.agents.config.notenforced_list = *

  2. Restart Apache HTTP Server.

Solaris Systems: Agent Uninstallation for Apache HTTP Server

You can uninstall a web agent on a Solaris system using a graphical user interface (GUI) or using the command line. However, if you are going to uninstall the deployment container, make sure that you uninstall the web agent before you uninstall the deployment container.

GUI Uninstallation of Agent for Apache HTTP Server on Solaris Systems

To uninstall a web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Apache HTTP Server on Solaris Systems Using the GUI

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:


    # ./uninstall_agent

  2. Click Next on Welcome panel.

  3. Click Uninstall Now on Ready to Uninstall panel.

  4. Click Close after uninstallation is complete.

  5. Restart the Apache HTTP Server instance from which you just uninstalled the agent.

Command-Line Uninstallation of Agent for Apache HTTP Server on Solaris Systems

To uninstall an agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Apache HTTP Server on Solaris Systems Using the Command Line

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:

    # ./uninstall_agent -nodisplay

    The uninstallation program detects the agent that was previously installed using the setup program and displays the following text:


    Ready to Uninstall

1. Uninstall Now
2. Start Over
3. Exit Uninstallation

  2. Enter 1 to uninstall the agent.

  3. When prompted, What next? enter 1 to begin uninstallation.

    The uninstallation program displays the following text:


    Product                                              Result     More Information
1.  Sun Java(tm) System Access Manager Policy Agent  Full       Available
2.  Done

  4. To see log information, enter 1. To exit the uninstallation program, enter 2.

  5. When the uninstallation is complete, restart the Apache HTTP Server instance from which you just uninstalled the agent.

AIX Systems: Agent Uninstallation for Apache HTTP Server

You can uninstall a web agent on a AIX system using the command line. Keep the following in mind:

Command-Line Uninstallation of Agent for Apache HTTP Server on AIX Systems

To uninstall this web agent using the command line, you must run the uninstallation program as explained in the following task description.

ProcedureTo Uninstall Agent for Apache HTTP Server on AIX Systems Using the Command Line

  1. Using the command line, change directories to the home directory.

  2. Issue the following command:


    java -cp . uninstall_Sun_Java_tm_System_Access_Manager_Policy_Agent -nodisplay

Linux Systems: Agent Uninstallation for Apache HTTP Server

You can uninstall a web agent on a Linux system using a graphical user interface (GUI) or using the command line.

GUI Uninstallation of Agent for Apache HTTP Server on Linux Systems

To uninstall a web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Apache HTTP Server on Linux Systems Using the GUI

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:


    # ./uninstall_linux_agent_apache

  2. Click Next on Welcome panel.

  3. Click Uninstall Now.

  4. Click Close after uninstallation is complete.

  5. Restart the Apache HTTP Server instance from which you just uninstalled the agent.

Next Steps

A post-uninstallation task is required when Agent for Apache HTTP Server is used on SUSE Linux. See Agent for Apache HTTP Server on SUSE Linux: Removing the common-2.2 Package.

Command-Line Uninstallation of Agent for Apache HTTP Server on Linux Systems

To uninstall a web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Apache HTTP Server on Linux Systems Using the Command Line

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:


    # ./uninstall_linux_agent_apache -nodisplay

    The uninstallation program displays the following text:


    Ready to Uninstall

1. Uninstall Now
2. Start Over
3. Exit Uninstallation

  2. Enter 1, to remove the product.

  3. When prompted, What next? enter 1 to begin uninstallation.

    The uninstallation program displays the following text:


    Product                                              Result     More Information
1.  Sun Java(tm) System Access Manager Policy Agent  Full       Available
2.  Done

  4. To see log information on the agent, enter 1. To exit the uninstallation program, enter 2.

  5. Restart the Apache HTTP Server instance from which you just uninstalled the agent.

Next Steps

A post-uninstallation task is required when Agent for Apache HTTP Server is used on SUSE Linux. See the following task.

Agent for Apache HTTP Server on SUSE Linux: Removing the common-2.2 Package

The common-2.2 package was installed as a post-installation step as described in Agent for Apache HTTP Server on SUSE Linux: Obtaining the Required Libraries. If you uninstall the agent, remove the package as described in the following task.

ProcedureTo Remove the common-2.2 Package

  1. Issue the following command:


    rpm -e common-2.2

Windows Systems: Agent Uninstallation for Apache HTTP Server

This the section 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 section is organized as follows:

Unconfiguring Agent for Apache HTTP Server on Windows Systems

If you no longer require Agent for Apache HTTP Server 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.

Perform the following steps to unconfigure Agent for Apache HTTP Server 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 Apache HTTP Server on Windows Systems

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

  2. Change to the directory PolicyAgent-base\apache\bin

  3. Run the following VB script to unconfigure the agent:

    cscript.exe ApacheAdmin.vbs -unconfig defaultConfig

    ApacheAdmin.vbs

    is a VB script that uses the output of the ApacheCreateConfig.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 Windows Systems: To Create Configuration Files, Agent for Apache HTTP Server.

    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 [ApacheResource.en]:

Removing the agent configuration directory

Restoring the original httpd.conf

Completed Unconfiguring the Agent for Apache 2.0.x. Re-start your server instance

    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 Apache HTTP Server.

Uninstallation of Agent for Apache HTTP Server on Windows Systems

Before running the uninstallation program, ensure that you have already unconfigured the agent from all the web sites for which it was configured as described in Unconfiguring Agent for Apache HTTP Server on Windows Systems. Perform the following steps to uninstall the agent.

ProcedureTo Uninstall Agent for Apache HTTP Server

  1. Change to the following directory:

    PolicyAgent-base\

  2. Run the following command to uninstall the agent:

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