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.

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

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 consumes a web application archive (WAR) artifact from the artifacts repository.


Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.

@Since 5.1.0.1 This operation delegates the selection to the workflow developer to determine.


Endpoint Execution

This operation will randomly execute on one of the endpoints identified during selection.

@Since 5.1.0.1 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.