Skip to content

NovaStar Program Reference / Web / tomcat


Overview

The tomcat shell script program performs tasks related to the tomcat web server, such as starting and stopping the tomcat web server software. The /etc/init.d/tomcat8 (or other version) service script is called to perform actions for Debian Stretch and earlier. The systemctl command is used for Debian Buster and later.

Command Line Usage

The command line syntax is:

tomcat action [options...]

Actions are as follows:

tomcat Actions for Command Line Parameters

Action                         Description
disable Used in software development to disable the system tomcat so as to not interfere with development tomcat.
enable Used in software development to enable the system tomcat for testing.
force-reload Debian Stretch and older.
force-restart Debian Stretch and older: Will use start for systemd service.
force-start Debian Stretch and older: Will use restart for systemd service.
is-active Debian Buster and later: Determine if the Tomcat service is active (used with systemd).
is-enabled Debian Buster and later: Determine if the Tomcat service is enabled (used with systemd).
start Start the Tomcat web application server software.
stop Stop the Tomcat web application server software.
restart Restart the Tomcat web application server software.
reload Reload the Tomcat web application server software without a restart.
repair Reinstall tomcat8 tomcat8-common software package (or latest version used by NovaStar) to repair tomcat.
status Print the Tomcat web application server software status.
statusword Custom action to print the service status as one word:
  • running - service is active and running
  • stopped - service is not running
  • unknown - service status is unknown
uptime Custom action to print the service uptime:
  • number of seconds as integer - when statusword is running
  • 0 - when statusword is stopped or immediately after service is started
  • -1 - when statusword is unknown

Optional values are shown in square brackets. Command line parameters are as follows.

tomcat Command Line Parameters

Parameter Description Default
--debug Print additional debug messages to stderr.
-h
--help
Print program usage.
--quiet Do not prompt for root password, exit with status 1. Prompt for root password if necessary.
-v
--version
Print the program version (Tomcat major version).

Examples

The following prints the Tomcat server status:

tomcat status

The following restarts the Tomcat server:

sudo tomcat restart

Scheduling

Tomcat/Administrator URLs may be accessed in scheduled processes.

NovaStar Administrator Interface

Tomcat is the web application server for Administrator.

Apache serves the system index.html, which has a link to Administrator and other resources.

Troubleshooting

See the tomcat log files in /var/log/tomcat (will be the latest version).

Use the --debug command parameter to print more information.

See Also