Chapter 6 Uninstalling Policy Agent 2.2 for Oracle Application Server 10g

The agentadmin program is used for initiating the installation and uninstallation programs of Policy Agent 2.2 for Oracle Application Server 10g. The difference is that 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 Key Features and Tasks Performed With the J2EE agentadmin Program. 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.

The uninstallation process follows a series of tasks similar to the installation process. First, perform the pre-uninstallation (preparation) steps. Then, perform the uninstallation, itself.

The uninstallation process differs depending upon the format of the deliverable files used during the initial installation of the agent: package formatted deliverable files or non-package formatted deliverable files.

If package formatted deliverables were used for installation of the agent, the uninstallation involves a single step.

If non-package formatted deliverables were used for installation, 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 step by step to enter specific information while providing you with explanations about that information.

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

Preparing to Uninstall Agent for Oracle Application Server 10g

Perform the pre-uninstallation (preparation) steps outlined in this section before uninstalling Policy Agent 2.2 for Oracle Application Server 10g.

To Prepare to Uninstall Agent for Oracle Application Server 10g

To prepare for the uninstallation of Policy Agent 2.2 for Oracle Application Server 10g, perform the following steps:

1. Undeploy any protected applications from Oracle Application Server 10g.

   Refer to the Oracle Application Server 10g documentation for more information.

2. Restore all the changes made as part of the post-installation process.

3. 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 Policy Agent 2.2 for Oracle Application Server 10g.

4. Ensure that the Oracle Application Server 10g instance from which you are about to uninstall the agent is not running.

Solaris Systems — Packages: Uninstalling Agent for Oracle Application Server 10g

This method of uninstalling Agent for Oracle Application Server 10g does not apply to all Solaris system uninstallations. This method only applies when the agent was originally installed using package formatted deliverables. Such deliverables are installed by issuing the following command:

# pkgadd -d

Package formatted deliverables have the string “_SUNWam” in the name of the compressed file used for delivering the Policy Agent 2.2 software. The following file name is an example of package formatted deliverable file used for Policy Agent 2.2 for Oracle Application Server 10g:

SJS_Oracle_1012_agent_2.2_SUNWamoc4j.tar.gz

For more information about package formatted deliverables for Solaris systems, see To Unpack Package Formatted Deliverables of a J2EE Agent in Policy Agent 2.2.

To uninstall this agent when the original deliverables were not in package format, regardless of the platform, see Launching the Uninstallation Program of Agent for Oracle Application Server 10g.

To Uninstall Agent for Oracle Application Server 10g on Solaris Systems — Packages

1. Issue the following command:

   # pkgrm SUNWamoc4j

   The preceding command removes the J2EE agent packages from the directory in which they were installed.

All Systems — Non-Packages: Uninstalling Agent for Oracle Application Server 10g

This method for uninstalling Agent for Oracle Application Server 10g applies when the agent was originally installed using non-package formatted deliverables. The term “non-package formatted deliverables” refers to the format of the compressed file used for delivering the Policy Agent 2.2 software. Package formatted deliverables have the string “_SUNWam” in the name of the compressed file. Therefore, non-package formatted deliverables do not have this string in the file name. The following two file names are examples of non-package formatted deliverable files used for Policy Agent 2.2 for Oracle Application Server 10g:

SJS_Oracle_1012_agent_2.2.tar.gz
SJS_Oracle_1012_agent_2.2.zip

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

Launching the Uninstallation Program of Agent for Oracle Application Server 10g

Perform the steps outlined in this section to launch the uninstallation program of Policy Agent 2.2 for Oracle Application Server 10g.

To Launch the Uninstallation Program of Agent for Oracle Application Server 10g

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

   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 Oracle Application Server 10g

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 Oracle Application Server 10g.

Example of Uninstallation Program Interaction in Agent for Oracle Application Server 10g

************************************************************************
Welcome to the Access Manager Policy Agent for Oracle10g 10.1.2. 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 Oracle10g OC4J to
store its configuration Files. This directory uniquely identifies the
Oracle10g OC4J instance that is secured by this Agent.
[ ? : Help, ! : Exit ]
Enter the Oracle10g OC4J Config Directory Path
[/opt/oracle/OraHome_1012/j2ee/home/config]: /opt/oracle/OraJ2EE_1012/j2ee/home/config


Enter the name of the global application.xml
[ ? : Help, < : Back, ! : Exit ]
Enter the name of the global application.xml [application.xml]:


-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
Oracle10g OC4J instance Config Directory :
/opt/oracle/OraJ2EE_1012/j2ee/home/config
Oracle10g OC4J instance-level application.xml : application.xml

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