The following macros are not currently supported in the header:
  • style

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 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 FDTOM_USERNAME 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 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 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.

Endpoint Execution

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

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.


The following macros are not currently supported in the footer:
  • style