> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# stopApplication (Tomcat)

> Signals an existing application to make itself unavailable, but leave it deployed. Any request that comes in while an application is stopped will see

Signals an existing application to make itself unavailable, but leave it deployed. Any request that comes in while an application is stopped will see an HTTP error 404. This operation only works with Tomcat Manager.

# Target Properties

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Property Name**</th><th>**Property Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Tomcat Catalina Home</td><td>`FDTOM_CATALINA_HOME`</td><td>Yes</td><td>The CATALINA\_HOME directory for the Tomcat installation.</td></tr><tr><td>Tomcat Manager URL</td><td>`FDTOM_MANAGER_URL`</td><td>No</td><td>The url of the Manager web application within the Tomcat server. In Tomcat 6, the manager url is likely[[http://localhost:8080/manager](http://localhost:8080/manager)](http://localhost:8080/manager). In Tomcat 7+, the manager url is likely [[http://localhost:8080/manager/text](http://localhost:8080/manager/text)](http://localhost:8080/manager/text).</td></tr><tr><td>Tomcat Username</td><td>`FDTOM_USERNAME`</td><td>No</td><td>The name of the Tomcat user with which to connect to the Manager web application. This user must be configured with the manager-script role.</td></tr><tr><td>Tomcat Password</td><td>`FDTOM_PASSWORD`</td><td>No</td><td>The password for the `FDTOM_USERNAME` user.</td></tr></tbody></table>

# Project Properties

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Property Name**</th><th>**Property Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Tomcat Context Root</td><td>`FDTOM_CONTEXT_ROOT`</td><td>Yes</td><td>The context root to configure for the web application being deployed.</td></tr></tbody></table>

# Artifacts

This operation doesn't consume or produce any artifacts.

# Endpoint Selection

This operation delegates the selection to the workflow developer to determine.

# Endpoint Execution

This operation delegates the execution to the workflow developer to determine.

# Special Considerations

This plugin has the following pre-requisites:

* The `JAVA_HOME` environment variable must be set to a supported JDK for the version of Tomcat being used.

* The Tomcat user specified by property `FDTOM_USERNAME` must be granted the manager (Tomcat 6.0.x) or manager-script (Tomcat 7+) role.

* The target Tomcat server must be running prior to calling this operation.

* An application with the given `FDTOM_CONTEXT_ROOT` must be deployed.

The `stopApplication` operation will be ignored if the application is already in the stopped status.