Sun OpenSSO Enterprise Policy Agent 3.0 Guide for Apache Tomcat 6.0

Uninstalling the Tomcat 6.0 Version 3.0 Agent

Preparing to Uninstall the Tomcat 6.0 Version 3.0 Agent

ProcedureTo 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

ProcedureTo Uninstall the Tomcat 6.0 Version 3.0 Agent

  1. Change to the following directory:


  2. Issue one of the following commands:

    # ./agentadmin --uninstall


    # ./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
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
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/ 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:
Thank you for using OpenSSO Policy Agent

After You Finish the Uninstall