Chapter 5. Using Jsvc to Start Tomcat

Jsvc is a set of libraries and applications that facilitates running Java applications on Linux, UNIX, and similar operating systems. Using Jsvc with JBoss Web Server allows Tomcat to switch identities. Using Jsvc, Tomcat can perform root-level operations and then revert to a non-privileged user. Jsvc is primarily used for running Tomcat as a service.

Jsvc files are available at the following locations:

  • For Red Hat Enterprise Linux:

    • JWS_HOME/extras/jsvc
    • JWS_HOME/tomcat<VERSION>/bin/jsvc

      Note

      JWS_HOME/tomcat<VERSION>/bin/jsvc is a symlink to JWS_HOME/extras/jsvc.

  • For Solaris:

    • JWS_HOME/sbin/jsvc
    • JWS_HOME/share/apache-tomcat-<VERSION>/bin/jsvc

      Note

      JWS_HOME/share/apache-tomcat-<VERSION>/bin/jsvc is a symlink to JWS_HOME/sbin/jsvc.

5.1. Starting Tomcat Using Jsvc

Start Tomcat Using Jsvc on Red Hat Enterprise Linux

Run the following command to start Tomcat using Jsvc on Red Hat Enterprise Linux:

JWS_HOME/tomcat<VERSION>/bin/daemon.sh start

Start Tomcat Using Jsvc on Solaris

Run the following command to start Tomcat using Jsvc on Solaris:

JWS_HOME/share/tomcat<VERSION>/bin/daemon.sh start

5.2. Stopping Tomcat Using Jsvc

Stop Tomcat Using Jsvc on Red Hat Enterprise Linux

Run the following command to stop Tomcat that was started using Jsvc on Red Hat Enterprise Linux:

JWS_HOME/tomcat<VERSION>/bin/daemon.sh stop

Stop Tomcat Using Jsvc on Solaris

Run the following command to stop Tomcat that was started using Jsvc on Solaris:

JWS_HOME/share/tomcat<VERSION>/bin/daemon.sh stop

5.3. Jsvc Parameters

The following parameters can be configured when running the daemon.sh script:

Table 5.1. daemon.sh Startup Parameters

Parameter NameEnvironment VariableDefault ValueDescription

--java-home

JAVA_HOME

Based on the value of the PATH variable.

The Java home directory location.

--catalina-home

CATALINA_HOME

Determined by the location of the script.

The Tomcat installation directory location.

--catalina-base

CATALINA_BASE

Based on the value of the PATH variable.

The directory that contains the specific configuration and setup information if multiple servers are using the same installation.

--catalina-pid

-

$CATALINA_BASE/logs/catalina-daemon.pid

The file where the process ID (PID) for the running instance of Tomcat is stored.

--tomcat-user

-

tomcat

The user Tomcat uses.

--service-start-wait-time

-

 

This is a wrapper to the --wait parameter. The --wait parameter accepts values in seconds.