Chapter 8 Uninstalling Policy Agent 2.2 for Sun Java System Web Server 7.0

This chapter first presents you with a method for disabling a web agent. Then the chapter leads you through the uninstallation process as follows:

• Disabling a Web Agent in Policy Agent 2.2

• Uninstalling Agent for Sun Java System Web Server 7.0

For web agents developed in the OpenSSO project, the agentadmin program is used for initiating the installation and uninstallation programs. The installation program is started with the --install option while the uninstallation program is started with the --uninstall option. For more information about the agentadmin program, see Introduction of the agentadmin Program in Web Agents for Policy Agent 2.2. The uninstallation program is similar to the installation program in that it provides step by step explanations of the information you need to enter. However, the uninstallation program has fewer and simpler steps.

Uninstallation consists of two phases. The first phase of uninstallation is the launching of the uninstallation program. The second phase of uninstallation involves interacting with the uninstallation program. During this phase, the program prompts you to enter specific information while providing you with an explanation of that information.

You must access the PolicyAgent-base directory for uninstallation-related tasks. For more information about this directory, see Web Agent Directory Structure in Policy Agent 2.2.

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.

To 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 Sun Java System Web Server 7.0.

Uninstalling Agent for Sun Java System Web Server 7.0

This uninstallation process involves two phases as described in the following subsections.

Launching the Uninstallation Program of Agent for Sun Java System Web Server 7.0

Perform the steps outlined in this section to launch the uninstallation program of Policy Agent 2.2 for Sun Java System Web Server 7.0.

To Launch the Uninstallation Program of Agent for Sun Java System Web Server 7.0

To launch the uninstallation program, perform the following steps:

1. Change to the following directory:

   PolicyAgent-base/bin

   This directory contains the agentadmin program, which is used for uninstalling a web agent and for performing other tasks. For more information on the agentadmin program, see Introduction of the agentadmin Program in Web Agents for Policy Agent 2.2.

2. Issue one of the following commands:

   ./agentadmin --uninstall

   or

   ./agentadmin --uninstallAll

   These two commands are different in that the --uninstallAll option removes all configured instances of the agent.

   After you issue one of the preceding commands, the uninstallation program launches and presents you with the first prompt as illustrated in the following section.

Using the Uninstallation Program of Agent for Sun Java System Web Server 7.0

The steps in the uninstallation program are displayed in the following example. The interaction process of this uninstallation program is similar to that of the installation program. One difference is that the uninstallation program does not present a license agreement. For a more detailed explanation of the interaction process, see Using the Installation Program of Agent for Sun Java System Web Server 7.0.

Example of Uninstallation Program Interaction in Agent for Sun Java System Web Server 7.0

************************************************************************
Welcome to the Access Manager Policy Agent for Sun Java System Web Server If
the Policy Agent is used with Federation Manager services, User needs to
enter information relevant to Federation Manager.

************************************************************************
Enter the complete path to the directory which is used by Sun Java System Web
Server to store its configuration Files. This directory uniquely
identifies the Sun Java System Web Server instance that is secured by this
Agent.
[ ? : Help, ! : Exit ]
Enter the Sun Java System Web Server Config Directory Path
[/var/opt/SUNWwbsvr7/https-agentHost1/config]:

-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
Sun Java System Web Server Config Directory :
/var/opt/SUNWwbsvr7/https-agentHost1/config

Verify your settings above and decide from the choices below.
1. Continue with Uninstallation
2. Back to the last interaction
3. Start Over
4. Exit
Please make your selection [1]: