---
title: Remove Java Agent
description: Shut down the server where the agent is installed.
component: java-agents
version: 2025.11
page_id: java-agents:installation-guide:uninstallation
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/installation-guide/uninstallation.html
section_ids:
  uninstall-tomcat-agent: Remove Tomcat Java Agent
  uninstall-jboss7-agent: Remove JBoss Java Agent
  uninstall-jetty-agent: Remove Jetty Java Agent
  uninstall-weblogic-agent: Remove WebLogic Java Agent
---

# Remove Java Agent

## Remove Tomcat Java Agent

1. Shut down the server where the agent is installed.

2. Run the `agentadmin` command with the `--listAgents` option list installed agent instances:

   ```bash
   $ agentadmin --listAgents
   The following agents are configured on this Application Server.
   ...
   The following are the details for agent Agent_001 :-
   ...
   ```

3. Note the configuration information of the agent instance you want to remove.

4. Run the `agentadmin` command with the `--uninstall` option.

   ```bash
   $ agentadmin --uninstall
   ```

5. Enter the path of the Tomcat installation directory:

   ```bash
   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/conf]: /path/to/apache-tomcat/conf
   ```

6. Review a summary of your responses and select how to continue:

   ```bash
   -----------------------------------------------
   SUMMARY OF YOUR RESPONSES
   -----------------------------------------------
   ...
   Verify your settings above and decide from the choices below.
   1. Continue with Uninstall
   2. Back to the last interaction
   3. Start Over
   4. Exit
   Please make your selection [1]: **1**
   ...
   ```

## Remove JBoss Java Agent

1. Shut down the server where the agent is installed.

2. Run the `agentadmin` command with the `--listAgents` option list installed agent instances:

   ```bash
   $ agentadmin --listAgents
   The following agents are configured on this Application Server.
   ...
   The following are the details for agent Agent_001 :-
   ...
   ```

3. Note the configuration information of the agent instance you want to remove.

4. Run the `agentadmin` command with the `--uninstall` option.

   ```bash
   $ agentadmin --uninstall
   ```

5. Enter the path to the JBoss installation directory:

   ```bash
   Enter the complete path to the home directory of the JBoss instance.
   [ ? : Help, ! : Exit ]
   Enter the path to the JBoss installation: /path/to/jboss
   ```

6. Enter `domain` or `standalone`, for the deployment mode of the JBoss installation to uninstall:

   ```bash
   Enter the name of the deployment mode of the JBoss installation that you wish
   to use with this agent. Supported values are: domain, standalone.
   [ ? : Help, < : Back, ! : Exit ]
   Enter the deployment mode of JBoss [standalone]: standalone
   ```

7. Review a summary of your responses and select how to continue:

   ```none
   -----------------------------------------------
   SUMMARY OF YOUR RESPONSES
   -----------------------------------------------
   ...
   Verify your settings above and decide from the choices below.
   1. Continue with Uninstall
   2. Back to the last interaction
   3. Start Over
   4. Exit
   Please make your selection [1]: **1**
   ...
   ```

## Remove Jetty Java Agent

1. Shut down the server where the agent is installed.

2. Run the `agentadmin` command with the `--listAgents` option list installed agent instances:

   ```bash
   $ agentadmin --listAgents
   The following agents are configured on this Application Server.
   ...
   The following are the details for agent Agent_001 :-
   ...
   ```

3. Note the configuration information of the agent instance you want to remove.

4. Run the `agentadmin` command with the `--uninstall` option.

   ```bash
   $ agentadmin --uninstall
   ```

5. Enter the path of the Jetty configuration directory:

   ```bash
   Enter the complete path to the directory which is used by Jetty Server to store
   its configuration Files. This directory uniquely identifies the Jetty
   Server instance that is secured by this Agent.
   [ ? : Help, ! : Exit ]
   Enter the Jetty Server Config Directory Path [/opt/jetty/etc]: /path/to/jetty/etc
   ```

6. Review a summary of your responses and select how to continue:

   ```bash
   -----------------------------------------------
   SUMMARY OF YOUR RESPONSES
   -----------------------------------------------
   ...
   Verify your settings above and decide from the choices below.
   1. Continue with Uninstall
   2. Back to the last interaction
   3. Start Over
   4. Exit
   Please make your selection [1]: 1
   ...
   ```

## Remove WebLogic Java Agent

1. Shut down the server where the agent is installed.

2. If there are no other agent instances installed on the WebLogic domain, remove the agent sourcing as follows:

   1. Remove the `. /path/to/setAgentEnv_AdminServer.sh` line from the `startWebLogic.sh` script if it was added.

   2. (Optional) Delete the `/path/to/setAgentEnv_AdminServer.sh` file.

3. Run the `agentadmin` command with the `--listAgents` option list installed agent instances:

   ```bash
   $ agentadmin --listAgents
   The following agents are configured on this Application Server.
   ...
   The following are the details for agent Agent_001 :-
   ...
   ```

4. Note the configuration information of the agent instance you want to remove.

5. Run the `agentadmin` command with the `--uninstall` option.

   ```bash
   $ agentadmin --uninstall
   ```

6. Enter the path to the `startWebLogic.sh` file of the WebLogic domain where you want to uninstall the agent:

   ```bash
   Enter the path to the location of the script used to start the WebLogic domain.
   Please ensure that the agent is first installed on the admin server instance
   before installing on any managed server instance.
   [ ? : Help, ! : Exit ]
   Enter the Startup script location
   [/usr/local/bea/user_projects/domains/base_domain/startWebLogic.sh]: /Oracle_Home/user_projects/domains/base_domain/startWebLogic.sh
   ```

7. Enter the name of the WebLogic instance:

   ```bash
   Enter the name of the WebLogic Server instance secured by the agent.
   [ ? : Help, < : Back, ! : Exit ]
   Enter the WebLogic Server instance name [AdminServer]: AdminServer
   ```

8. Review a summary of your responses and select how to continue:

   ```bash
   -----------------------------------------------
   SUMMARY OF YOUR RESPONSES
   -----------------------------------------------
   ...
   Verify your settings above and decide from the choices below.
   1. Continue with Uninstall
   2. Back to the last interaction
   3. Start Over
   4. Exit
   Please make your selection [1]: 1
   ...
   ```