Sun Java System Access Manager Policy Agent 2.2 Guide for JBoss Application Server 4.0

All Systems — Non-Packages: Uninstalling Agent for JBoss Application Server 4.0

This method for uninstalling Agent for JBoss Application Server 4.0 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 JBoss Application Server 4.0:

SJS_JBoss_4.0_Server_agent_2.2.tar.gz
SJS_JBoss_4.0_Server_agent_2.2.zip

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

Launching the Uninstallation Program of Agent for JBoss Application Server 4.0

Perform the steps outlined in this section to launch the uninstallation program of Policy Agent 2.2 for JBoss Application Server 4.0.

ProcedureTo Launch the Uninstallation Program of Agent for JBoss Application Server 4.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 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 JBoss Application Server 4.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 JBoss Application Server 4.0.

Example of Uninstallation Program Interaction in Agent for JBoss Application Server 4.0


************************************************************************
Welcome to the Access Manager Policy Agent for JBoss Server 4.0. 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 JBoss Server to
store its configuration Files. This directory uniquely identifies the JBoss
Server instance that is secured by this Agent.
[ ? : Help, ! : Exit ]
Enter the JBoss Server Config Directory Path
[/opt/jboss-4.0.2/server/default/conf]:
-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
JBoss Server Config Directory : /opt/jboss-4.0.2/server/default/conf
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]:
Removing Agent parameters from
/opt/jboss-4.0.2/server/default/conf/jboss-service.xml file ...DONE.
Removing Agent parameters from
/opt/jboss-4.0.2/server/default/conf/server.policy file ...DONE.
Removing Agent parameters from am-login-config.xml file ...DONE.
Removing Agent parameters from
/opt/jboss-4.0.2/bin/setAgentClasspathdefault.sh file ...DONE.
Removing Agent parameters from agentapp.war file ...DONE.
Deleting the config directory
/opt/j2ee_agents/am_jboss_agent/agent_001/config ...DONE.
Uninstall log file location:
/opt/j2ee_agents/am_jboss_agent/logs/audit/uninstall.log
Thank you for using Access Manager Policy Agenta