Uninstalling the Tomcat 6.0 Version 3.0 Agent

• Preparing to Uninstall the Tomcat 6.0 Version 3.0 Agent

• Uninstalling the Tomcat 6.0 Version 3.0 Agent Using the agentadmin Program

Preparing to Uninstall the Tomcat 6.0 Version 3.0 Agent

To Prepare to Uninstall Tomcat 6.0 Version 3.0 Agent

1. Undeploy any applications protected by the Tomcat 6.0 version 3.0 agent.

2. Restore the deployment descriptors of these applications to their original deployment descriptors. (Backup files are useful here if you have them.)

3. Conditionally, if you are permanently removing the Tomcat 6.0 version 3.0 agent, undeploy the agent application.

   However, if you plan to re-install this agent , you don't need to undeploy the agent application.

4. Ensure that the Tomcat 6.0 instance that is being protected by the agent is stopped.

Uninstalling the Tomcat 6.0 Version 3.0 Agent Using the agentadmin Program

To Uninstall the Tomcat 6.0 Version 3.0 Agent

1. Change to the following directory:

   PolicyAgent-base/bin

2. Issue one of the following commands:

   # ./agentadmin --uninstall

   or

   # ./agentadmin --uninstallAll

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

3. The uninstall program prompts you for the configuration directory path of the Tomcat 6.0 instance.

4. The uninstall program displays a summary of your responses and then asks if you want to continue:

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

Example 2 Uninstallation Sample for the Tomcat 6.0 Version 3.0 Agent

************************************************************************
Welcome to the OpenSSO Policy Agent for Apache Tomcat 6.0 Servlet/JSP
Container
************************************************************************
Enter the complete path to the directory which is used by Tomcat Server to
store its configuration Files. This directory uniquely identifies the
Tomcat Server instance that is secured by this Agent.
[ ? : Help, ! : Exit ]
Enter the Tomcat Server Config Directory Path
[/opt/apache-tomcat-6.0.18/conf]: 
-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
Tomcat Server Config Directory : /opt/apache-tomcat-6.0.18/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 the agent classpath from
/opt/apache-tomcat-6.0.18/bin/setclasspath.sh script ...DONE.
Deleting the config directory
/opt/agents/j2ee_agents/tomcat_v6_agent/Agent_001/config ...DONE.
Removing OpenSSO Tomcat Agent Realm from Server XML file :
/opt/apache-tomcat-6.0.18/conf/server.xml ...DONE.
Removing filter from Global deployment descriptor file :
/opt/apache-tomcat-6.0.18/conf/web.xml ...DONE.
Removing OpenSSO Tomcat Agent Filter and Form login authentication from Web
applications ...DONE.

Uninstall log file location:
/opt/agents/j2ee_agents/tomcat_v6_agent/installer-logs/audit/uninstall.log
Thank you for using OpenSSO Policy Agent

After You Finish the Uninstall

• The /config directory is removed from the agent instance directory, but the /installer-logs directory still exists.

• The uninstall program creates an uninstall log file in the PolicyAgent-base/installer-logs/audit directory.

• The agent instance directory is not automatically removed. For example, if you uninstall the agent for Agent_001, a subsequent agent installation creates the Agent_002 instance directory. To remove an agent instance directory, you must manually remove the directory.