Chapter 6 Uninstalling Policy Agent 2.2 for Application Server 8.2/9.0/9.1

To uninstall the Application Server 8.2/9.0/9.1 agent, use the agentadmin program with the --uninstall option. This chapter includes:

• Preparing to Uninstall the Application Server 8.2/9.0/9.1 Agent

• Uninstalling the Application Server 8.2/9.0/9.1 Agent

For more information about the agentadmin program, see Key Features and Tasks Performed With the J2EE agentadmin Program.

Preparing to Uninstall the Application Server 8.2/9.0/9.1 Agent

To Prepare to Uninstall Application Server 8.2/9.0/9.1 Agent

1. Undeploy any protected applications from Application Server 8.2/9.0/9.1.

   Refer to the Application Server 8.2/9.0/9.1 documentation for more information.

2. Restore the deployment descriptors of these applications to their original deployment descriptors.

3. Before you uninstall the agent for Application Server 8.2/9.0/9.1, ensure that the following servers are shut down:

   • Domain Administration Server (DAS)

   • Application Server 8.2/9.0/9.1 instance protected by the agent

4. (Conditional) If you are permanently removing the agent for Application Server 8.2/9.0/9.1, undeploy the agent application.

   If you are permanently removing this agent, you must first undeploy the agent application from Application Server 8.2/9.0/9.1 before the agent is uninstalled. If you plan to re-install this agent , you are not required to undeploy the agent application.

   The agent application was installed during the post-installation steps. For more information about the installation of this application see Chapter 3, Installing the Policy Agent for Application Server 8.2/9.0/9.1.

Uninstalling the Application Server 8.2/9.0/9.1 Agent

To Uninstall the Application Server 8.2/9.0/9.1 Agent

1. Change to the following directory:

   PolicyAgent-base/bin

   This directory contains the agentadmin program, which is used for uninstalling a J2EE agent and for performing other tasks. For more information on the agentadmin program, see Key Features and Tasks Performed With the J2EE agentadmin Program.

2. Issue one of the following commands:

   ./agentadmin --uninstall

   or

   ./agentadmin --uninstallAll

   The --uninstall removes only one instance of the agent, while the --uninstallAll option removes all configured instances of the agent.

   The following example shows the

3. The uninstall program launches and prompts you for the following information:

   • Application Server Config directory path

     Default: /var/opt/SUNWappserver/domains/domain1/config

   • Application Server instance name

     Enter the appropriate values or accept the default values.

4. The uninstall program displays your choices and then asks if you want to continue:

   To continue with the uninstallation, select 1 (the default).

Example 6–1 Uninstallation Sample for the Application Server 8.2/9.0/9.1 Agent

************************************************************************
Welcome to the Access Manager Policy Agent for Sun Java(TM) System
Application Server 8.1/8.2/9.0/9.1. 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 Application Server
to store its configuration Files. This directory uniquely identifies the
Application Server instance that will be secured by this Agent.
[ ? : Help, ! : Exit ]
Enter the Application Server Config Directory Path
[/var/opt/SUNWappserver/domains/domain1/config]:
Enter the name of the Application Server instance that will be secured by this
Agent.
[ ? : Help, < : Back, ! : Exit ]
Enter the Application Server Instance name [server]:

*********************************************************
SUMMARY OR YOUR RESPONSES
*********************************************************

Application Server Config Directory :
/var/opt/SUNWappserver/domains/domain1/config
 Application Server Instance name : server

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]: