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:
Solaris Systems: Agent Uninstallation for Apache HTTP Server
Agent for Apache HTTP Server on SUSE Linux: Removing the common-2.2 Package
Windows Systems: Agent Uninstallation for Apache HTTP Server
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.
This task requires that you reset the following property:
com.sun.am.policy.agents.config.notenforced_list |
Reset the value of this property to the asterisk, “*,” as follows:
com.sun.am.policy.agents.config.notenforced_list = *
Restart 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.
To uninstall a web agent, you must run the uninstallation program.
In the Policy Agent base directory (PolicyAgent-base), enter the following command:
# ./uninstall_agent |
Click Next on Welcome panel.
Click Uninstall Now on Ready to Uninstall panel.
Click Close after uninstallation is complete.
Restart the Apache HTTP Server instance from which you just uninstalled the agent.
To uninstall an agent, you must run the uninstallation program.
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 |
Enter 1 to uninstall the agent.
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 |
To see log information, enter 1. To exit the uninstallation program, enter 2.
When the uninstallation is complete, restart the Apache HTTP Server instance from which you just uninstalled the agent.
You can uninstall a web agent on a AIX system using the command line. Keep the following in mind:
If you want to uninstall the deployment container, make sure that you uninstall the web agent before you uninstall the deployment container.
Set LIBPATH to include the libpasswd.so file.
For more information about setting LIBPATH, see Installation 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.
Using the command line, change directories to the home directory.
Issue the following command:
java -cp . uninstall_Sun_Java_tm_System_Access_Manager_Policy_Agent -nodisplay |
You can uninstall a web agent on a Linux system using a graphical user interface (GUI) or using the command line.
To uninstall a web agent, you must run the uninstallation program.
In the Policy Agent base directory (PolicyAgent-base), enter the following command:
# ./uninstall_linux_agent_apache |
Click Next on Welcome panel.
Click Uninstall Now.
Click Close after uninstallation is complete.
Restart the Apache HTTP Server instance from which you just uninstalled the agent.
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.
To uninstall a web agent, you must run the uninstallation program.
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 |
Enter 1, to remove the product.
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 |
To see log information on the agent, enter 1. To exit the uninstallation program, enter 2.
Restart the Apache HTTP Server instance from which you just uninstalled the agent.
A post-uninstallation task is required when Agent for Apache HTTP Server is used on SUSE Linux. See the following task.
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.
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:
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.
Stop the web site for which you have configured the agent.
Change to the directory PolicyAgent-base\apache\bin
Run the following VB script to unconfigure the agent:
cscript.exe ApacheAdmin.vbs -unconfig defaultConfig
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.
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 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.
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.