Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Signals an existing application to shut itself down and reload. This can be useful when the web application context is not reloadable and you have updated classes or property files in the /WEB-INF/classes directory or when you have added or updated jar files in the /WEB-INF/lib directory.

Environment/Instance Properties

Property Name

Property Code

Required

Description

Tomcat Catalina Home

FDTOM_CATALINA_HOME

Yes

The pathname to the directory in which Tomcat has been installed.CATALINA_HOME directory for the Tomcat installation.

Tomcat Manager URL

FDTOM_MANAGER_URL

Yes

The url of the Manager web application within the Tomcat server. In Tomcat 6, the manager url is likely

http://localhost:8080/manager. In Tomcat 7+, the manager url is likely http://localhost:8080/manager/text.


Tomcat Username

FDTOM_USERNAME

Yes

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.

Tomcat Password

FDTOM_PASSWORD

Yes

The password for the the FDTOM_USERNAME user user.

Project Properties

Property Name

Property Code

Required

Description

Tomcat Context Root

FDTOM_CONTEXT_ROOT

Yes

The context root to configure for the web application being reloaded. The value must start with a forward slash deployed.

Tomcat War Name

FDTOM_WAR_NAME

Yes

The name of the web application archive in the artifacts directory (e.g. / sample.war) or directory containing the unpacked war contents. If a relative path is provided, it is assumed relative to the Host appBase directory.

Inputs

 

Input Name

Input Code

Required

Description

 

 





Outputs

 

Output Name

Required

Description

 

 




Artifacts

This operation doesn't consume or produce any artifacts.

...

  • 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 property FDTOM_USERNAME must  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 and be in the running state.
  • Application reloading (to pick up changes to the classes or web.xml file) is not supported when a web application is deployed directly from a WAR file. It only works when the web application is deployed from an unpacked directory. If you are using a WAR file, you should undeploy and then deploy again to pick up your changes.

...