tomcat.exe: Tomcat Service and Java Applications on Domains

The tomcat.exe utility is used to manage the Tomcat service and the Java-based Web applications on domains. Using this utility, you can perform the following tasks:

  • installing Java Web applications on a domain
  • changing status of the Tomcat service on a domain
  • changing statuses of Java-based Web applications on a domain

Location

%plesk_cli%

Usage
tomcat.exe <command> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]

Example

The following command installs a new Java-based Web application from file E:\siteapps\storefront.war on the domain example.com:

tomcat.exe --install E:\siteapps\storefront.war -domain example.com

Commands
Command Parameter Description Example

--install or -i

<file name>

Installs a Java-based Web application on a domain.

Requires the -domain option.

To install the web application from the file E:\siteapps\storefront.war on the domain example.com:

tomcat.exe --install E:\siteapps\storefront.war -domain example.com

or

tomcat.exe -i E:\siteapps\storefront.war -domain example.com

--remove or -r

<application name>

Deletes a Java-based web application from a domain.

Requires the -domain option.

To delete web application storefront from the domain example.com:

tomcat.exe --remove storefront -domain example.com

or

tomcat.exe -r storefront -domain example.com

--update-service

<domain name>

Updates a domain's Tomcat service status.

To enable Tomcat service on the domain example.com:

tomcat.exe --update-service example.com -status enabled

--update

<application name>

Updates a Java-based web application status.

Requires the -domain option.

To start web application storefront on the domain example.com:

tomcat.exe --update storefront -domain example.com -status enabled

--help or -h

 

Displays help on the use of the utility.

To view help on the use of the utility:

tomcat.exe --help

or

tomcat.exe -h

Options
Option Parameter Description Example

-domain

<domain ame>

Specifies a domain on which a Java application is to be installed or updated.

To install the web application from the file E:\siteapps\storefront.war on the domain example.com:

tomcat.exe -i E:\siteapps\storefront.war -domain example.com

-no-restart

 

Prohibits restarting Tomcat service.

Used with --update-service and --install.

To install the web application from the file E:\siteapps\storefront.war on the domain example.com and to prohibit restart Tomcat service after installation:

tomcat.exe --install E:\siteapps\storefront.war -domain example.com -no-restart

-status

enabled|disabled|admin,domadm,parent,client

Enables/Disables Tomcat service or a Java application on a domain (the enabled or disabled parameters, respectively).

Disables Tomcat service or a Java application and sets the Tomcat service or a Java application status to "disabled by administrator" (admin) or "disabled by client" (client).

Sets the Tomcat service or a Java application status to the status of the domain (parent).

The use of the domadm parameter is restricted; the parameter should not be used for changing the service or application status.

To enable the web application storefront on domain example.com:

tomcat.exe --update storefront -status enabled -domain example.com

 

To set the status of the Tomcat service on the domain example.com to the status of the domain:

tomcat.exe --update-service example.com -status parent