Deploy a web application (deploy)

Purpose

Deploy an ABL web application (.war file) to a Progress Application Server for OpenEdge (PAS for OpenEdge) instance, online (when the server is running) or offline (when the server is not running). The TCMAN utility copies the web application to the server’s web application directory.

Syntax

tcman.sh deploy [general_options] [-l] [-u user_id:password] [-a app_name] war_file_path [abl_app_name]

Parameters

general_options

Specify one or more of the general TCMAN options. To view which general options are appropriate, run tcman.sh help deploy.

-l

Deploy an ABL web application online without restarting the instance. This option loads the context required for a successful online deployment.

Note: The Tomcat manager (manager.war) must already be deployed for the -l switch to work. In the PAS for OpenEdge development server, the Tomcat manager is by default deployed in the default instance, oepas1. For all new instances in both the development and the production servers, you have to deploy the Tomcat manager first before you can use this switch. Also note that the -l switch can be used only in conjunction with the -u parameter.

-u user_id:password

Specify a valid user name and password for HTTP Basic access authentication.

Note: This parameter is required if the server is online. It is not required if the server is offline.

-a app_name

Specify a name for the web application. If you do not use this option, the application name will be the same as the .war file name.

war_file_path

Specify the location of the web application .war file that you want to deploy.

abl_app_name

It is the name of the ABL application under which you want to deploy your ABL web application.

An ABL application is a logical grouping of ABL web applications. It consists of a session manager, one or more multi-session agents, and one or more deployed ABL web applications.

An instance can contain more than one ABL application. You can deploy an ABL web application to either the default ABL application, which is named after the instance, or to a new ABL application. If you want to deploy an ABL web application under a new ABL application, then specify a name for the ABL application here.

Example

Deploy and rename oeabl.war (a web application that implements OpenEdge adapters) to the acme1 instance of the PAS for OpenEdge server online:

/psc/acme1/bin/tcman.sh deploy -l -u user_id:password] -a oeadapters $DLC/servers/pasoe/extras/oeabl.war
OK - deployed $DLC/servers/pasoe/extras/oeabl.war to local directory <instance-path>/webapps