deploy

Deploys a web application (WAR) to a running Tomcat server. The WAR can be produced from any Build operation.

Environment/Instance Properties

Property Name

Property Code

Required

Description

Tomcat Catalina Home

FDTOM_CATALINA_HOME

Yes

The CATALINA_HOME directory for the Tomcat installation.

Tomcat Catalina Base
FDTOM_CATALINA_BASE
NoThe CATALINA_BASE directory for the Tomcat server for Instance specific information like conf, bin, webapps etc. Defaults to Tomcat Catalina Home.
Tomcat Manager URL

FDTOM_MANAGER_URL

No

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.

Be aware that the manager app must be running on the endpoint that you are connecting to for the deploy operation.

Tomcat Username

FDTOM_USERNAME

No

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

No

The password for the FDTOM_USERNAME user.

Project Properties

Property Name

Property Code

Required

Description

Tomcat Context Root

FDTOM_CONTEXT_ROOT

No

The context root path for the application. Required if using the Tomcat Manager, otherwise war name will be context root.

Tomcat War Name

FDTOM_WAR_NAME

No

The name of the web application archive in the artifacts directory (e.g. sample.war). If a relative path is provided, it is assumed relative to the Host appBase directory. If not provided, then it will search for a single war file in the artifacts directory.

Inputs

Input Name

Input Code

Required

Description





Outputs

Output Name

Required

Description




Artifacts

This operation consumes a web application archive (WAR) artifact from the artifacts repository.

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.
  • The specified WAR file must exist in the artifact repository.