#!/bin/sh
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the “License”); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an “AS IS” BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# —————————————————————————–
# Control Script for the CATALINA Server
#
# Environment Variable Prerequisites
#
# Do not set the variables in this script. Instead put them into a script
# setenv.sh in CATALINA_BASE/bin to keep your customizations separate.
#
# CATALINA_HOME May point at your Catalina “build” directory.
#
# CATALINA_BASE (Optional) Base directory for resolving dynamic portions
# of a Catalina installation. If not present, resolves to
# the same directory that CATALINA_HOME points to.
#
# CATALINA_OUT (Optional) Full path to a file where stdout and stderr
# will be redirected.
# Default is $CATALINA_BASE/logs/catalina.out
#
# CATALINA_OPTS (Optional) Java runtime options used when the “start”,
# “run” or “debug” command is executed.
# Include here and not in JAVA_OPTS all options, that should
# only be used by Tomcat itself, not by the stop process,
# the version command etc.
# Examples are heap size, GC logging, JMX ports etc.
#
# CATALINA_TMPDIR (Optional) Directory path location of temporary directory
# the JVM should use (java.io.tmpdir). Defaults to
# $CATALINA_BASE/temp.
#
# JAVA_HOME Must point at your Java Development Kit installation.
# Required to run the with the “debug” argument.
#
# JRE_HOME Must point at your Java Runtime installation.
# Defaults to JAVA_HOME if empty. If JRE_HOME and JAVA_HOME
# are both set, JRE_HOME is used.
#
# JAVA_OPTS (Optional) Java runtime options used when any command
# is executed.
# Include here and not in CATALINA_OPTS all options, that
# should be used by Tomcat and also by the stop process,
# the version command etc.
# Most options should go into CATALINA_OPTS.
#
# JAVA_ENDORSED_DIRS (Optional) Lists of of colon separated directories
# containing some jars in order to allow replacement of APIs
# created outside of the JCP (i.e. DOM and SAX from W3C).
# It can also be used to update the XML parser implementation.
# Defaults to $CATALINA_HOME/endorsed.
#
# JPDA_TRANSPORT (Optional) JPDA transport used when the “jpda start”
# command is executed. The default is “dt_socket”.
#
# JPDA_ADDRESS (Optional) Java runtime options used when the “jpda start”
# command is executed. The default is localhost:8000.
#
# JPDA_SUSPEND (Optional) Java runtime options used when the “jpda start”
# command is executed. Specifies whether JVM should suspend
# execution immediately after startup. Default is “n”.
#
# JPDA_OPTS (Optional) Java runtime options used when the “jpda start”
# command is executed. If used, JPDA_TRANSPORT, JPDA_ADDRESS,
# and JPDA_SUSPEND are ignored. Thus, all required jpda
# options MUST be specified. The default is:
#
# -agentlib:jdwp=transport=$JPDA_TRANSPORT,
# address=$JPDA_ADDRESS,server=y,suspend=$JPDA_SUSPEND
#
# JSSE_OPTS (Optional) Java runtime options used to control the TLS
# implementation when JSSE is used. Default is:
# “-Djdk.tls.ephemeralDHKeySize=2048”
#
# CATALINA_PID (Optional) Path of the file which should contains the pid
# of the catalina startup java process, when start (fork) is
# used
#
# LOGGING_CONFIG (Optional) Override Tomcats logging config file
# Example (all one line)
# LOGGING_CONFIG=”-Djava.util.logging.config.file=$CATALINA_BASE/conf/logging.properties”
#
# LOGGING_MANAGER (Optional) Override Tomcats logging manager
# Example (all one line)
# LOGGING_MANAGER=”-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager”
#
# USE_NOHUP (Optional) If set to the string true the start command will
# use nohup so that the Tomcat process will ignore any hangup
# signals. Default is “false” unless running on HP-UX in which
# case the default is “true”
# —————————————————————————–
# OS specific support. $var _must_ be set to either true or false.
cygwin=false
darwin=false
os400=false
hpux=false
case “`uname`” in
CYGWIN*) cygwin=true;;
Darwin*) darwin=true;;
OS400*) os400=true;;
HP-UX*) hpux=true;;
esac
# resolve links – $0 may be a softlink
PRG=”$0″
while [ -h “$PRG” ]; do
ls=`ls -ld “$PRG”`
link=`expr “$ls” : .*-> \(.*\)$`
if expr “$link” : /.* > /dev/null; then
PRG=”$link”
else
PRG=`dirname “$PRG”`/”$link”
fi
done
# Get standard environment variables
PRGDIR=`dirname “$PRG”`
# Only set CATALINA_HOME if not already set
[ -z “$CATALINA_HOME” ] && CATALINA_HOME=`cd “$PRGDIR/..” >/dev/null; pwd`
# Copy CATALINA_BASE from CATALINA_HOME if not already set
[ -z “$CATALINA_BASE” ] && CATALINA_BASE=”$CATALINA_HOME”
# Ensure that any user defined CLASSPATH variables are not used on startup,
# but allow them to be specified in setenv.sh, in rare case when it is needed.
CLASSPATH=
if [ -r “$CATALINA_BASE/bin/setenv.sh” ]; then
. “$CATALINA_BASE/bin/setenv.sh”
elif [ -r “$CATALINA_HOME/bin/setenv.sh” ]; then
. “$CATALINA_HOME/bin/setenv.sh”
fi
# For Cygwin, ensure paths are in UNIX format before anything is touched
if $cygwin; then
[ -n “$JAVA_HOME” ] && JAVA_HOME=`cygpath –unix “$JAVA_HOME”`
[ -n “$JRE_HOME” ] && JRE_HOME=`cygpath –unix “$JRE_HOME”`
[ -n “$CATALINA_HOME” ] && CATALINA_HOME=`cygpath –unix “$CATALINA_HOME”`
[ -n “$CATALINA_BASE” ] && CATALINA_BASE=`cygpath –unix “$CATALINA_BASE”`
[ -n “$CLASSPATH” ] && CLASSPATH=`cygpath –path –unix “$CLASSPATH”`
fi
# Ensure that neither CATALINA_HOME nor CATALINA_BASE contains a colon
# as this is used as the separator in the classpath and Java provides no
# mechanism for escaping if the same character appears in the path.
case $CATALINA_HOME in
*:*) echo “Using CATALINA_HOME: $CATALINA_HOME”;
echo “Unable to start as CATALINA_HOME contains a colon (:) character”;
exit 1;
esac
case $CATALINA_BASE in
*:*) echo “Using CATALINA_BASE: $CATALINA_BASE”;
echo “Unable to start as CATALINA_BASE contains a colon (:) character”;
exit 1;
esac
# For OS400
if $os400; then
# Set job priority to standard for interactive (interactive – 6) by using
# the interactive priority – 6, the helper threads that respond to requests
# will be running at the same priority as interactive jobs.
COMMAND=chgjob job($JOBNAME) runpty(6)
system $COMMAND
# Enable multi threading
export QIBM_MULTI_THREADED=Y
fi
# Get standard Java environment variables
if $os400; then
# -r will Only work on the os400 if the files are:
# 1. owned by the user
# 2. owned by the PRIMARY group of the user
# this will not work if the user belongs in secondary groups
. “$CATALINA_HOME”/bin/setclasspath.sh
else
if [ -r “$CATALINA_HOME”/bin/setclasspath.sh ]; then
. “$CATALINA_HOME”/bin/setclasspath.sh
else
echo “Cannot find $CATALINA_HOME/bin/setclasspath.sh”
echo “This file is needed to run this program”
exit 1
fi
fi
# Add on extra jar files to CLASSPATH
if [ ! -z “$CLASSPATH” ] ; then
CLASSPATH=”$CLASSPATH”:
fi
CLASSPATH=”$CLASSPATH””$CATALINA_HOME”/bin/bootstrap.jar
if [ -z “$CATALINA_OUT” ] ; then
CATALINA_OUT=”$CATALINA_BASE”/logs/catalina.out
fi
if [ -z “$CATALINA_TMPDIR” ] ; then
# Define the java.io.tmpdir to use for Catalina
CATALINA_TMPDIR=”$CATALINA_BASE”/temp
fi
# Add tomcat-juli.jar to classpath
# tomcat-juli.jar can be over-ridden per instance
if [ -r “$CATALINA_BASE/bin/tomcat-juli.jar” ] ; then
CLASSPATH=$CLASSPATH:$CATALINA_BASE/bin/tomcat-juli.jar
else
CLASSPATH=$CLASSPATH:$CATALINA_HOME/bin/tomcat-juli.jar
fi
# Bugzilla 37848: When no TTY is available, dont output to console
have_tty=0
if [ “`tty`” != “not a tty” ]; then
have_tty=1
fi
# For Cygwin, switch paths to Windows format before running java
if $cygwin; then
JAVA_HOME=`cygpath –absolute –windows “$JAVA_HOME”`
JRE_HOME=`cygpath –absolute –windows “$JRE_HOME”`
CATALINA_HOME=`cygpath –absolute –windows “$CATALINA_HOME”`
CATALINA_BASE=`cygpath –absolute –windows “$CATALINA_BASE”`
CATALINA_TMPDIR=`cygpath –absolute –windows “$CATALINA_TMPDIR”`
CLASSPATH=`cygpath –path –windows “$CLASSPATH”`
JAVA_ENDORSED_DIRS=`cygpath –path –windows “$JAVA_ENDORSED_DIRS”`
fi
if [ -z “$JSSE_OPTS” ] ; then
JSSE_OPTS=”-Djdk.tls.ephemeralDHKeySize=2048″
fi
JAVA_OPTS=”$JAVA_OPTS $JSSE_OPTS”
# Register custom URL handlers
# Do this here so custom URL handles (specifically war:…) can be used in the security policy
JAVA_OPTS=”$JAVA_OPTS -Djava.protocol.handler.pkgs=org.apache.catalina.webresources”
# Set juli LogManager config file if it is present and an override has not been issued
if [ -z “$LOGGING_CONFIG” ]; then
if [ -r “$CATALINA_BASE”/conf/logging.properties ]; then
LOGGING_CONFIG=”-Djava.util.logging.config.file=$CATALINA_BASE/conf/logging.properties”
else
# Bugzilla 45585
LOGGING_CONFIG=”-Dnop”
fi
fi
if [ -z “$LOGGING_MANAGER” ]; then
LOGGING_MANAGER=”-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager”
fi
# Uncomment the following line to make the umask available when using the
# org.apache.catalina.security.SecurityListener
#JAVA_OPTS=”$JAVA_OPTS -Dorg.apache.catalina.security.SecurityListener.UMASK=`umask`”
if [ -z “$USE_NOHUP” ]; then
if $hpux; then
USE_NOHUP=”true”
else
USE_NOHUP=”false”
fi
fi
unset _NOHUP
if [ “$USE_NOHUP” = “true” ]; then
_NOHUP=nohup
fi
# —– Execute The Requested Command —————————————–
# Bugzilla 37848: only output this if we have a TTY
if [ $have_tty -eq 1 ]; then
echo “Using CATALINA_BASE: $CATALINA_BASE”
echo “Using CATALINA_HOME: $CATALINA_HOME”
echo “Using CATALINA_TMPDIR: $CATALINA_TMPDIR”
if [ “$1” = “debug” ] ; then
echo “Using JAVA_HOME: $JAVA_HOME”
else
echo “Using JRE_HOME: $JRE_HOME”
fi
echo “Using CLASSPATH: $CLASSPATH”
if [ ! -z “$CATALINA_PID” ]; then
echo “Using CATALINA_PID: $CATALINA_PID”
fi
fi
if [ “$1” = “jpda” ] ; then
if [ -z “$JPDA_TRANSPORT” ]; then
JPDA_TRANSPORT=”dt_socket”
fi
if [ -z “$JPDA_ADDRESS” ]; then
JPDA_ADDRESS=”localhost:8000″
fi
if [ -z “$JPDA_SUSPEND” ]; then
JPDA_SUSPEND=”n”
fi
if [ -z “$JPDA_OPTS” ]; then
JPDA_OPTS=”-agentlib:jdwp=transport=$JPDA_TRANSPORT,address=$JPDA_ADDRESS,server=y,suspend=$JPDA_SUSPEND”
fi
CATALINA_OPTS=”$JPDA_OPTS $CATALINA_OPTS”
shift
fi
if [ “$1” = “debug” ] ; then
if $os400; then
echo “Debug command not available on OS400”
exit 1
else
shift
if [ “$1” = “-security” ] ; then
if [ $have_tty -eq 1 ]; then
echo “Using Security Manager”
fi
shift
exec “$_RUNJDB” “$LOGGING_CONFIG” $LOGGING_MANAGER $JAVA_OPTS $CATALINA_OPTS \
-Djava.endorsed.dirs=”$JAVA_ENDORSED_DIRS” -classpath “$CLASSPATH” \
-sourcepath “$CATALINA_HOME”/../../java \
-Djava.security.manager \
-Djava.security.policy==”$CATALINA_BASE”/conf/catalina.policy \
-Dcatalina.base=”$CATALINA_BASE” \
-Dcatalina.home=”$CATALINA_HOME” \
-Djava.io.tmpdir=”$CATALINA_TMPDIR” \
org.apache.catalina.startup.Bootstrap “$@” start
else
exec “$_RUNJDB” “$LOGGING_CONFIG” $LOGGING_MANAGER $JAVA_OPTS $CATALINA_OPTS \
-Djava.endorsed.dirs=”$JAVA_ENDORSED_DIRS” -classpath “$CLASSPATH” \
-sourcepath “$CATALINA_HOME”/../../java \
-Dcatalina.base=”$CATALINA_BASE” \
-Dcatalina.home=”$CATALINA_HOME” \
-Djava.io.tmpdir=”$CATALINA_TMPDIR” \
org.apache.catalina.startup.Bootstrap “$@” start
fi
fi
elif [ “$1” = “run” ]; then
shift
if [ “$1” = “-security” ] ; then
if [ $have_tty -eq 1 ]; then
echo “Using Security Manager”
fi
shift
eval exec “\”$_RUNJAVA\”” “\”$LOGGING_CONFIG\”” $LOGGING_MANAGER $JAVA_OPTS $CATALINA_OPTS \
-Djava.endorsed.dirs=”\”$JAVA_ENDORSED_DIRS\”” -classpath “\”$CLASSPATH\”” \
-Djava.security.manager \
-Djava.security.policy==”\”$CATALINA_BASE/conf/catalina.policy\”” \
-Dcatalina.base=”\”$CATALINA_BASE\”” \
-Dcatalina.home=”\”$CATALINA_HOME\”” \
-Djava.io.tmpdir=”\”$CATALINA_TMPDIR\”” \
org.apache.catalina.startup.Bootstrap “$@” start
else
eval exec “\”$_RUNJAVA\”” “\”$LOGGING_CONFIG\”” $LOGGING_MANAGER $JAVA_OPTS $CATALINA_OPTS \
-Djava.endorsed.dirs=”\”$JAVA_ENDORSED_DIRS\”” -classpath “\”$CLASSPATH\”” \
-Dcatalina.base=”\”$CATALINA_BASE\”” \
-Dcatalina.home=”\”$CATALINA_HOME\”” \
-Djava.io.tmpdir=”\”$CATALINA_TMPDIR\”” \
org.apache.catalina.startup.Bootstrap “$@” start \
>> “$CATALINA_OUT” 2>&1
fi
fi