Quick Eclipse Jetty Integration (Linux / UNIX)

Eclipse Jetty 12.x.x-Integration

Dieser Abschnitt beschreibt die Schritte zur schnellen Einrichtung von Eclipse Jetty 12.0.36 oder 12.1.10. Andere Versionen der Jetty-12-Serie sollten auf ähnliche Weise funktionieren.

Jetty herunterladen

Laden Sie Jetty als tar.gz-Datei von den Jetty-Downloads herunter. Bestimmte Versionen können auch aus dem Maven-Repository heruntergeladen werden. Wir werden mit jetty-home-12.1.10.tar.gz arbeiten.

Entpacken Sie das Archiv, um ein Verzeichnis jetty-home-12.1.10 zu erhalten, und benennen Sie es optional nach Ihren Wünschen um.

Jetty 12 möchte nichts im Home-Verzeichnis ändern. Erstellen Sie ein paralleles Verzeichnis jetty-base-12, wechseln Sie in dieses Verzeichnis und führen Sie den folgenden Befehl aus, um das Verzeichnis zu initialisieren:

java -jar ../jetty-home-12.0.36/start.jar --add-modules=server,http,ee10-deploy

Wrapper herunterladen

Die folgenden Schritte sind für die Version 3.7.4 des Java Service Wrappers ausgelegt. Die Verwendung früherer Versionen ist möglich, erfordert jedoch wahrscheinlich einige Anpassungen.

Entscheiden Sie, welche Edition Sie verwenden möchten (Professional, Standard oder Community), und wählen Sie die Zielplattform, Bittiefe und Architektur. Laden Sie anschließend das Installationsprogramm oder Archiv herunter und installieren bzw. entpacken Sie es. Wir gehen davon aus, dass Sie die Professional 64-Bit-Edition unter Linux x86 verwenden.

Wrapper-Integration

Um die Platzierung der erforderlichen Wrapper-Dateien zu erleichtern, erstellen Sie das folgende Shell-Skript in Ihrem Verzeichnis jetty-base-12 als updateWrapper.sh. Aktualisieren Sie den Speicherort, an dem Sie den Wrapper oben installiert oder entpackt haben. Vergessen Sie nicht, es ausführbar zu machen.

#!/bin/sh
WRAPPER_HOME=../wrapper-linux-x86-64-3.7.4-pro
JETTY_BASE=.
WRAPPER_SCRIPT=service.sh

mkdir -p ${JETTY_BASE}/bin
mkdir -p ${JETTY_BASE}/lib
if [ -d ${WRAPPER_HOME}/lang ]
then
    mkdir -p ${JETTY_BASE}/lang
    cp -n ${WRAPPER_HOME}/lang/wrapper_*.mo ${JETTY_BASE}/lang/.
    cp -n ${WRAPPER_HOME}/lang/wrapperjni_*.mo ${JETTY_BASE}/lang/.
fi
mkdir -p ${JETTY_BASE}/conf
if [ -f ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ]
then
    cp -n ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ${JETTY_BASE}/conf/wrapper-license.conf
fi
mkdir -p ${JETTY_BASE}/logs
mkdir -p ${JETTY_BASE}/tmp

cp ${WRAPPER_HOME}/bin/wrapper ${JETTY_BASE}/bin/.
cp ${WRAPPER_HOME}/lib/wrapper.jar ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/lib/libwrapper.* ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/src/bin/App.sh.in ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

sed -i '' -e 's/@app\.name@/jetty/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
sed -i '' -e 's/@app\.long\.name@/Jetty Server/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
chmod +x ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

Führen Sie das Skript aus:

./updateWrapper.sh

Die Konfiguration verwendet Integrationsmethode 1.

Der Klassenpfad, die Hauptklasse der Anwendung und die Anwendungsparameter werden dynamisch mithilfe eines Skripts erzeugt, das nach der Wrapper-Konfigurationsdatei bereitgestellt wird.

NOTE

Die Variable JAVA_HOME muss gesetzt sein, verwendet jedoch standardmäßig die Systemumgebung, falls sie dort definiert ist. Für Jetty 12 muss mindestens Java 17 angegeben werden.

Erstellen Sie die Wrapper-Konfigurationsdatei als conf/wrapper.conf mit folgendem Inhalt:

@encoding=UTF-8
# The configuration file must begin with a line declaring its encoding.

# Default mode for file inclusions
@include.default_mode=required

# Include file problems can be debugged by removing '#' at the beginning
#  of the following line:
#@include.debug

#********************************************************************
# Wrapper License Properties (Ignored by Community Edition)
#********************************************************************
# Professional and Standard Editions of the Wrapper require a valid
#  License Key to start.  Licenses can be purchased or a trial license
#  requested on the following pages:
# https://wrapper.tanukisoftware.com/purchase
# https://wrapper.tanukisoftware.com/trial

# The Wrapper will look for either of the following optional files for a
#  valid License Key.  License Key properties can optionally be included
#  directly in this configuration file.
@include.optional %WRAPPER_CONF_DIR%/wrapper-license.conf
@include.optional %WRAPPER_CONF_DIR%/wrapper-license-%WRAPPER_HOST_NAME%.conf

# The following property will output information about which License Key(s)
#  are being found, and can aid in resolving any licensing problems.
#wrapper.license.debug=TRUE

#********************************************************************
# Environment
#********************************************************************
set.default.JAVA_HOME=(SetMe)

# JETTY_BASE and JETTY_HOME are set in wrapper-generated.conf
@include %WRAPPER_BIN_DIR%/../conf/wrapper-generated.conf

# Change the working dir used by java so Jetty is in its expected location.
#  Setting JETTY_BASE relative to the fixed WRAPPER_BIN_DIR location helps make their meaning clear and avoid confusion when changing the working dir.
wrapper.working.dir=%JETTY_BASE%

#********************************************************************
# Wrapper Localization
#********************************************************************
# Specify the language and locale which the Wrapper should use.
#wrapper.lang=en_US # en_US or ja_JP

# Specify the location of the language resource files (*.mo).
wrapper.lang.folder=%JETTY_BASE%/lang

#********************************************************************
# Wrapper Java Properties
#********************************************************************
# Java Application
wrapper.java.command=%JAVA_HOME%/bin/java

# Tell the Wrapper to log the full generated Java command line.
#wrapper.java.command.loglevel=INFO

# Wrapper Jar file
wrapper.jarfile=%JETTY_BASE%/lib/wrapper.jar

# Log level for notices about missing Java Classpath entries.
wrapper.java.classpath.missing.loglevel=WARN

# Java Version control
wrapper.java.version.output=true
wrapper.java.version.min=17
#wrapper.java.version.max=

# Java Classpath.  Add class path elements as needed starting from 1
# (See wrapper-generated.conf)

# Java Modulepath. (Requires Java 9 or above)
#  Add module path elements as needed starting from 1
#wrapper.java.module_path.1=

# Java Module list. (Requires Java 9 or above)
#  Add module names as needed starting from 1
#wrapper.java.module.1=

# Java Library Path (location of wrapper.dll or libwrapper.so)
wrapper.java.library.path.1=%JETTY_BASE%/lib

# Java Bits.  On applicable platforms, tells the JVM to run in 32 or 64-bit mode.
wrapper.java.additional.auto_bits=TRUE

# Java Additional Parameters
wrapper.java.additional.1=-Djava.io.tmpdir=%JETTY_BASE%/tmp

# Initial Java Heap Size (in MB)
#wrapper.java.initmemory=3

# Maximum Java Heap Size (in MB)
wrapper.java.maxmemory=256

# Application System Properties passed via the backend.
#  Core Java System Properties must be passed using wrapper.java.additional.<n>.
wrapper.app.property.1=jetty.home=%JETTY_HOME%
wrapper.app.property.2=jetty.base=%JETTY_BASE%

# Java Main class.  This class must implement the WrapperListener interface
#  or guarantee that the WrapperManager class is initialized.
#  Helper classes are provided to do this for you.
#  See the following page for details:
#  https://wrapper.tanukisoftware.com/doc/english/integrate.html
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp

# Application parameters.
#  Pass parameters via the backend instead of the command line.
#wrapper.app.parameter.backend=TRUE

#  Add parameters as needed starting from 1
# (See wrapper-generated.conf)

#********************************************************************
# Wrapper Logging Properties
#********************************************************************
# Enables Debug output from the Wrapper.
# wrapper.debug=TRUE

# Format of output for the console.  (See docs for formats)
wrapper.console.format=PM

# Log Level for console output.  (See docs for log levels)
wrapper.console.loglevel=INFO

# Log file to use for Wrapper output logging.
wrapper.logfile=%JETTY_BASE%/logs/wrapper.log

# Format of output for the log file.  (See docs for formats)
wrapper.logfile.format=LPTM

# Log Level for log file output.  (See docs for log levels)
wrapper.logfile.loglevel=INFO

# Roll mode of the log file.
#  SIZE_OR_WRAPPER causes the file to be rolled whenever its size exceeds the
#  value defined by wrapper.logfile.maxsize, or whenever the Wrapper is
#  launched.
wrapper.logfile.rollmode=SIZE_OR_WRAPPER

# Maximum size that the log file will be allowed to grow to before
#  the log is rolled. Size is specified in bytes.  The default value
#  of 0 disables log rolling.  May abbreviate with the 'k' (kb) or
#  'm' (mb) suffixes.  For example: 10m = 10 megabytes.
wrapper.logfile.maxsize=10m

# Maximum number of rolled log files which will be allowed before old
#  files are deleted.  The default value of 0 implies no limit.
wrapper.logfile.maxfiles=9

# Log Level for sys/event log output.  (See docs for log levels)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Wrapper General Properties
#********************************************************************
# Allow for the use of non-contiguous numbered properties
wrapper.ignore_sequence_gaps=TRUE

# Do not start if the pid file already exists.
wrapper.pidfile.strict=TRUE

# Title to use when running as a console
wrapper.console.title=Jetty Server

#********************************************************************
# Wrapper JVM Checks
#********************************************************************
# Detect DeadLocked Threads in the JVM. (Requires Standard Edition)
wrapper.check.deadlock=TRUE
wrapper.check.deadlock.interval=60
wrapper.check.deadlock.action=RESTART
wrapper.check.deadlock.output=FULL

# Out Of Memory detection.
#  Ignore -verbose:class output to avoid false positives.
wrapper.filter.trigger.1000=[Loaded java.lang.OutOfMemoryError
wrapper.filter.action.1000=NONE
#  Ignore -Xlog:class+load=level output to avoid false positives.
wrapper.filter.trigger.1001=[class,load] java.lang.OutOfMemoryError
wrapper.filter.action.1001=NONE
# (Simple match)
wrapper.filter.trigger.1002=java.lang.OutOfMemoryError
# (Only match text in stack traces if -XX:+PrintClassHistogram is being used.)
#wrapper.filter.trigger.1002=Exception in thread "*" java.lang.OutOfMemoryError
#wrapper.filter.allow_wildcards.1002=TRUE
wrapper.filter.action.1002=RESTART
wrapper.filter.message.1002=The JVM has run out of memory.

#********************************************************************
# Wrapper Email Notifications. (Requires Professional Edition)
#********************************************************************
# Common Event Email settings.
#wrapper.event.default.email.debug=TRUE
#wrapper.event.default.email.smtp.host=<SMTP_Host>
#wrapper.event.default.email.smtp.port=25
#wrapper.event.default.email.subject=[%WRAPPER_HOSTNAME%:%WRAPPER_NAME%:%WRAPPER_EVENT_NAME%] Event Notification
#wrapper.event.default.email.sender=<Sender email>
#wrapper.event.default.email.recipient=<Recipient email>

# Configure the log attached to event emails.
#wrapper.event.default.email.maillog=ATTACHMENT
#wrapper.event.default.email.maillog.lines=50
#wrapper.event.default.email.maillog.format=LPTM
#wrapper.event.default.email.maillog.loglevel=INFO

# Enable specific event emails.
#wrapper.event.wrapper_start.email=TRUE
#wrapper.event.jvm_prelaunch.email=TRUE
#wrapper.event.jvm_start.email=TRUE
#wrapper.event.jvm_started.email=TRUE
#wrapper.event.jvm_deadlock.email=TRUE
#wrapper.event.jvm_stop.email=TRUE
#wrapper.event.jvm_stopped.email=TRUE
#wrapper.event.jvm_restart.email=TRUE
#wrapper.event.jvm_failed_invocation.email=TRUE
#wrapper.event.jvm_max_failed_invocations.email=TRUE
#wrapper.event.jvm_kill.email=TRUE
#wrapper.event.jvm_killed.email=TRUE
#wrapper.event.jvm_unexpected_exit.email=TRUE
#wrapper.event.wrapper_stop.email=TRUE

# Specify custom mail content
wrapper.event.jvm_restart.email.body=The JVM was restarted.\n\nPlease check on its status.\n

#********************************************************************
# Wrapper Secure File Properties
#********************************************************************
# To enforce the principle of least privilege for files containing
#  sensitive data, the Wrapper requires that all permissions granted
#  to these files be explicitly allowed in the configuration.
#  Please read the documentation for the full list of properties.

# Allow specific accounts or groups on Windows.
#wrapper.secure_file.check.windows.allowed_account.1=NT AUTHORITY\SYSTEM
#wrapper.secure_file.check.windows.allowed_account.2=BUILTIN\Administrators

# Allow specific groups on Unix systems.
#wrapper.secure_file.check.unix.allowed_group.1=<Group_Of_Users>

# Additional files to check for permissions (Requires Standard Edition)
#wrapper.secure_file.additional.1=<Secured_File>

#********************************************************************
# Wrapper Windows Service Properties
#********************************************************************
# WARNING - Do not modify any of these properties when an application
#  using this configuration file has been installed as a service.
#  Please uninstall the service before modifying this section.
#  The service can then be reinstalled.

# Name of the service
wrapper.name=jetty

# Display name of the service
wrapper.displayname=Jetty

# Description of the service
wrapper.description=Jetty Server

# Service dependencies.  Add dependencies as needed starting from 1
wrapper.ntservice.dependency.1=

# Mode in which the service is installed.
#  AUTO_START, DELAY_START (Requires Standard Edition) or DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# Account to use when running the service.
#  The default blank value will use LocalSystem, which is highly privileged
#  account on Windows. Please read the documentation page for this property to
#  learn about other account types that can be used.
wrapper.ntservice.account=

# Allow the current user to perform certain actions without being prompted for
#  administrator credentials. (Requires Professional Edition)
#wrapper.ntservice.permissions.1.account=CURRENT_USER
#wrapper.ntservice.permissions.1.allow=START, STOP, PAUSE_RESUME

Die start.jar von Jetty 12 startet den Jetty-Server nicht direkt. Vielmehr handelt es sich um eine Bootstrap-Anwendung, die dynamisch die Befehlszeile erzeugt, um einen untergeordneten Java-Prozess zu starten, der den Jetty-Server tatsächlich ausführt. Dies ist nicht ideal, wenn der Java Service Wrapper verwendet wird, da dieser die Java-Instanz, die Jetty ausführt, nicht direkt überwachen kann. Jetty bietet eine Möglichkeit, Komponenten dieser Befehlszeile zu extrahieren, und das unten stehende Skript wird verwendet, um ein Konfigurationsfragment conf/wrapper-generated.conf zu erzeugen, das von der oben genannten conf/wrapper.conf eingebunden wird. Wenn Sie wesentliche Änderungen an Ihrer Anwendungskonfiguration vornehmen, müssen Sie dieses Skript möglicherweise erneut ausführen. Andernfalls sollte es unverändert bleiben.

Erstellen Sie das folgende Shell-Skript in Ihrem Verzeichnis jetty-base-12 als updateWrapperGeneratedConf.sh.

#!/bin/bash
set -e

# Run from Jetty base dir and specify Jetty home as argument.
cd "$(dirname "$0")" || exit 1

# Jetty home.
JETTY_HOME="${1:-}"
if [[ -z "$JETTY_HOME" ]]; then
    echo "ERROR: jetty.home directory not specified." >&2
    echo "Usage: $0 /path/to/jetty.home" >&2
    exit 1
fi
if [[ ! -d "$JETTY_HOME" ]]; then
    echo "ERROR: '$JETTY_HOME' does not exist or is not a directory." >&2
    exit 1
fi
if [[ ! -f "$JETTY_HOME/start.jar" ]]; then
    echo "ERROR: '$JETTY_HOME/start.jar' not found." >&2
    echo "Is '$JETTY_HOME' a valid Jetty home directory?" >&2
    exit 1
fi
JETTY_BASE="."
CONF_DIR="${JETTY_BASE}/conf"
ABS_JETTY_HOME=$(cd "$JETTY_HOME" && pwd)
ABS_JETTY_BASE=$(cd "$JETTY_BASE" && pwd)
echo ABS_JETTY_HOME=$ABS_JETTY_HOME
echo ABS_JETTY_BASE=$ABS_JETTY_BASE

# Run dry-run from inside JETTY_BASE
DRY_RUN() {
    (cd "$JETTY_BASE" && java -jar "$JETTY_HOME/start.jar" "$@")
}
OPTS=$(DRY_RUN --dry-run=opts)
MAIN_CLASS=$(DRY_RUN --dry-run=main)
ARGS=$(DRY_RUN --dry-run=args)
PATH_INFO=$(DRY_RUN --dry-run=path)
ENVS=$(DRY_RUN --dry-run=envs || echo "")

if [[ "$JETTY_HOME" == /* ]]
then
    CONF_JETTY_HOME="$JETTY_HOME"
else
    CONF_JETTY_HOME="%WRAPPER_BIN_DIR%/../$JETTY_HOME"
fi
CONF_JETTY_BASE="%WRAPPER_BIN_DIR%/.."

# Generate the wrapper-generated.conf file:
cat > "$CONF_DIR/wrapper-generated.conf" << EOF
# =============================================================
# AUTO-GENERATED Jetty 12 Java Service Wrapper config - $(date)
# Regenerate with: $0
# =============================================================

set.JETTY_HOME=$CONF_JETTY_HOME
set.JETTY_BASE=$CONF_JETTY_BASE

# From --dry-run=path
EOF

k=1
echo "$PATH_INFO" | sed 's/^--class-path //' | tr ':' '\n' | while read -r entry; do
    if [[ -n "$entry" ]]; then
        entry_clean=$(echo "$entry" | sed "s|$ABS_JETTY_HOME|%JETTY_HOME%|g" | sed "s|$ABS_JETTY_BASE|%JETTY_BASE%|g")
        echo "wrapper.java.classpath.$k=$entry_clean" >> "$CONF_DIR/wrapper-generated.conf"
        ((k++))
    fi
done

cat >> "$CONF_DIR/wrapper-generated.conf" << EOF

# App Main Class
wrapper.app.parameter.1=$MAIN_CLASS

# From --dry-run=args (properties + XMLs)
EOF

m=100
echo "$ARGS" | xargs -n1 | while read -r arg; do
    if [[ -n "$arg" ]]; then
        if [[ "$arg" == *addHiddenClasses* ]]; then
            echo "wrapper.app.parameter.$m=jetty.webapp.addHiddenClasses=org.eclipse.jetty.logging.,file://%JETTY_HOME%/lib/logging/,org.slf4j." >> "$CONF_DIR/wrapper-generated.conf"
        else
            arg_clean=$(echo "$arg" | sed "s|$ABS_JETTY_HOME|%JETTY_HOME%|g" | sed "s|$ABS_JETTY_BASE|%JETTY_BASE%|g" | sed 's|file:///|file://|g')
            echo "wrapper.app.parameter.$m=$arg_clean" >> "$CONF_DIR/wrapper-generated.conf"
        fi
        ((m++))
    fi
done
if [[ -n "$ENVS" ]]; then
    echo "" >> "$CONF_DIR/wrapper-generated.conf"
    echo "# From --dry-run=envs (EEnn)" >> "$CONF_DIR/wrapper-generated.conf"
    m=1000
    echo "$ENVS" | xargs -n1 | while read -r arg; do
        if [[ -n "$arg" ]]; then
            arg_clean=$(echo "$arg" | sed "s|$ABS_JETTY_HOME|%JETTY_HOME%|g" | sed "s|$ABS_JETTY_BASE|%JETTY_BASE%|g" | sed 's|file:///|file://|g')
            echo "wrapper.app.parameter.$m=$arg_clean" >> "$CONF_DIR/wrapper-generated.conf"
            ((m++))
        fi
    done
fi

echo "SUCCESS! Generated -> $CONF_DIR/wrapper-generated.conf"

Führen Sie innerhalb des Verzeichnisses jetty-base-12 den folgenden Befehl aus:

./updateWrapperGeneratedConf.sh ../jetty-home-12.1.10

NOTE

Wenn Sie die Standard oder Professional Edition verwenden, dann wurde eine standardmäßige 15-Minuten-Lizenz als conf/wrapper-license.conf kopiert. Sie müssen diese mit einer Trial-, Server- oder Development-Lizenz aktualisieren, um länger als diese Zeitspanne ausführen zu können.

Ausführen

Zum Ausführen in einer Konsole:

  • Ausführen: bin/service.sh console

Zum Ausführen als daemon (service):

  • Installieren Sie den Dienst mit: bin/service.sh install

  • Starten Sie anschließend den Dienst mit: bin/service.sh start

  • Stoppen Sie den Dienst mit: bin/service.sh stop

  • Deinstallieren Sie den Dienst mit: bin/service.sh remove

Für eine Liste der verfügbaren Befehle:

  • Ausführen: bin/service.sh

Sie können die Protokollausgabe des Wrappers zusammen mit der Konsolenausgabe von Java sehen, indem Sie die Protokolldatei logs/wrapper.log mit tail verfolgen. Weitere Jetty-Protokolldateien finden Sie ebenfalls in diesem Verzeichnis.

Eclipse Jetty 11.0.x-Integration

Dieser Abschnitt beschreibt die Schritte zur schnellen Einrichtung von Eclipse Jetty 11.0.26. Andere Versionen der Jetty-11-Serie sollten auf ähnliche Weise funktionieren.

Jetty herunterladen

Laden Sie Jetty als tar.gz-Datei von den Jetty-Downloads herunter. Bestimmte Versionen können auch aus dem Maven-Repository heruntergeladen werden. Wir werden mit jetty-home-11.0.26.tar.gz arbeiten.

Entpacken Sie das Archiv, um ein Verzeichnis jetty-home-11.0.26 zu erhalten, und benennen Sie es optional nach Ihren Wünschen um.

Jetty 11 möchte nichts im Home-Verzeichnis ändern. Erstellen Sie ein paralleles Verzeichnis jetty-base-11, wechseln Sie in dieses Verzeichnis und führen Sie den folgenden Befehl aus, um das Verzeichnis zu initialisieren:

java -jar ../jetty-home-11.0.26/start.jar --add-module=server,http,deploy

Wrapper herunterladen

Die folgenden Schritte sind für die Version 3.7.4 des Java Service Wrappers ausgelegt. Die Verwendung früherer Versionen ist möglich, erfordert jedoch wahrscheinlich einige Anpassungen.

Entscheiden Sie, welche Edition Sie verwenden möchten (Professional, Standard oder Community), und wählen Sie die Zielplattform, Bittiefe und Architektur. Laden Sie anschließend das Installationsprogramm oder Archiv herunter und installieren bzw. entpacken Sie es. Wir gehen davon aus, dass Sie die Professional 64-Bit-Edition unter Linux x86 verwenden.

Wrapper-Integration

Um die Platzierung der erforderlichen Wrapper-Dateien zu erleichtern, erstellen Sie das folgende Shell-Skript in Ihrem Verzeichnis jetty-base-11 als updateWrapper.sh. Aktualisieren Sie den Speicherort, an dem Sie den Wrapper oben installiert oder entpackt haben. Vergessen Sie nicht, es ausführbar zu machen.

#!/bin/sh
WRAPPER_HOME=../wrapper-linux-x86-64-3.7.4-pro
JETTY_BASE=.
WRAPPER_SCRIPT=service.sh

mkdir -p ${JETTY_BASE}/bin
mkdir -p ${JETTY_BASE}/lib
if [ -d ${WRAPPER_HOME}/lang ]
then
    mkdir -p ${JETTY_BASE}/lang
    cp -n ${WRAPPER_HOME}/lang/wrapper_*.mo ${JETTY_BASE}/lang/.
    cp -n ${WRAPPER_HOME}/lang/wrapperjni_*.mo ${JETTY_BASE}/lang/.
fi
mkdir -p ${JETTY_BASE}/conf
if [ -f ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ]
then
    cp -n ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ${JETTY_BASE}/conf/wrapper-license.conf
fi
mkdir -p ${JETTY_BASE}/logs
mkdir -p ${JETTY_BASE}/tmp

cp ${WRAPPER_HOME}/bin/wrapper ${JETTY_BASE}/bin/.
cp ${WRAPPER_HOME}/lib/wrapper.jar ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/lib/libwrapper.* ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/src/bin/App.sh.in ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

sed -i '' -e 's/@app\.name@/jetty/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
sed -i '' -e 's/@app\.long\.name@/Jetty Server/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
chmod +x ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

Führen Sie das Skript aus:

./updateWrapper.sh

Die Konfiguration verwendet Integrationsmethode 1. Siehe den Hinweis unten, warum start.jar nicht als ausführbare JAR-Datei verwendet wird.

NOTE

- Die Variable JAVA_HOME muss gesetzt sein, verwendet jedoch standardmäßig die Systemumgebung, falls sie dort definiert ist. Für Jetty 11 muss mindestens Java 11 angegeben werden.

- Die Datei start.jar von Jetty ist eine ausführbare JAR-Datei. Grundsätzlich hätten wir für diese Einrichtung Integrationsmethode 4 verwenden können, dies hätte jedoch erfordert, dass die erste Anwendungseigenschaft als wrapper.app.parameter.1=%JETTY_HOME%/start.jar angegeben wird. Dies würde auf einzelnen Rechnern zu unterschiedlichen Werten aufgelöst werden und bei Verwendung des Lizenzschlüssels nicht funktionieren. Als Workaround wird die start.jar als reguläre JAR-Datei im Klassenpfad behandelt, und der Eintrag Main-Class: org.eclipse.jetty.start.Main wurde aus der Manifest-Datei extrahiert, um direkt darauf zu verweisen.

Erstellen Sie die Wrapper-Konfigurationsdatei als conf/wrapper.conf mit folgendem Inhalt:

@encoding=UTF-8
# The configuration file must begin with a line declaring its encoding.

# Default mode for file inclusions
@include.default_mode=required

# Include file problems can be debugged by removing '#' at the beginning
#  of the following line:
#@include.debug

#********************************************************************
# Wrapper License Properties (Ignored by Community Edition)
#********************************************************************
# Professional and Standard Editions of the Wrapper require a valid
#  License Key to start.  Licenses can be purchased or a trial license
#  requested on the following pages:
# https://wrapper.tanukisoftware.com/purchase
# https://wrapper.tanukisoftware.com/trial

# The Wrapper will look for either of the following optional files for a
#  valid License Key.  License Key properties can optionally be included
#  directly in this configuration file.
@include.optional %WRAPPER_CONF_DIR%/wrapper-license.conf
@include.optional %WRAPPER_CONF_DIR%/wrapper-license-%WRAPPER_HOST_NAME%.conf

# The following property will output information about which License Key(s)
#  are being found, and can aid in resolving any licensing problems.
#wrapper.license.debug=TRUE

#********************************************************************
# Environment
#********************************************************************
set.default.JAVA_HOME=(SetMe)
# Setting all relative paths next to the fixed WRAPPER_BIN_DIR location helps make their meaning clear.
set.JETTY_HOME=%WRAPPER_BIN_DIR%/../../jetty-home-11.0.26
set.JETTY_BASE=%WRAPPER_BIN_DIR%/..

# Change the working dir used by java so Jetty is in its expected location.
#  Setting JETTY_BASE relative to the fixed WRAPPER_BIN_DIR location helps make their meaning clear and avoid confusion when changing the working dir.
wrapper.working.dir=%JETTY_BASE%

#********************************************************************
# Wrapper Localization
#********************************************************************
# Specify the language and locale which the Wrapper should use.
#wrapper.lang=en_US # en_US or ja_JP

# Specify the location of the language resource files (*.mo).
wrapper.lang.folder=%JETTY_BASE%/lang

#********************************************************************
# Wrapper Java Properties
#********************************************************************
# Java Application
wrapper.java.command=%JAVA_HOME%/bin/java

# Tell the Wrapper to log the full generated Java command line.
#wrapper.java.command.loglevel=INFO

# Wrapper Jar file
wrapper.jarfile=%JETTY_BASE%/lib/wrapper.jar

# Log level for notices about missing Java Classpath entries.
wrapper.java.classpath.missing.loglevel=WARN

# Java Version control
wrapper.java.version.output=true
wrapper.java.version.min=11
#wrapper.java.version.max=

# Java Classpath.  Add class path elements as needed starting from 1
wrapper.java.classpath.1=%JETTY_HOME%/start.jar

# Java Modulepath. (Requires Java 9 or above)
#  Add module path elements as needed starting from 1
#wrapper.java.module_path.1=

# Java Module list. (Requires Java 9 or above)
#  Add module names as needed starting from 1
#wrapper.java.module.1=

# Java Library Path (location of wrapper.dll or libwrapper.so)
wrapper.java.library.path.1=%JETTY_BASE%/lib

# Java Bits.  On applicable platforms, tells the JVM to run in 32 or 64-bit mode.
wrapper.java.additional.auto_bits=TRUE

# Java Additional Parameters
wrapper.java.additional.1=-Djava.io.tmpdir=%JETTY_BASE%/tmp

# Initial Java Heap Size (in MB)
#wrapper.java.initmemory=3

# Maximum Java Heap Size (in MB)
wrapper.java.maxmemory=256

# Application System Properties passed via the backend.
#  Core Java System Properties must be passed using wrapper.java.additional.<n>.
wrapper.app.property.1=jetty.home=%JETTY_HOME%
wrapper.app.property.2=jetty.base=%JETTY_BASE%

# Java Main class.  This class must implement the WrapperListener interface
#  or guarantee that the WrapperManager class is initialized.
#  Helper classes are provided to do this for you.
#  See the following page for details:
#  https://wrapper.tanukisoftware.com/doc/english/integrate.html
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp

# Application parameters.
#  Pass parameters via the backend instead of the command line.
#wrapper.app.parameter.backend=TRUE

#  Add parameters as needed starting from 1
wrapper.app.parameter.1=org.eclipse.jetty.start.Main

#********************************************************************
# Wrapper Logging Properties
#********************************************************************
# Enables Debug output from the Wrapper.
# wrapper.debug=TRUE

# Format of output for the console.  (See docs for formats)
wrapper.console.format=PM

# Log Level for console output.  (See docs for log levels)
wrapper.console.loglevel=INFO

# Log file to use for Wrapper output logging.
wrapper.logfile=%JETTY_BASE%/logs/wrapper.log

# Format of output for the log file.  (See docs for formats)
wrapper.logfile.format=LPTM

# Log Level for log file output.  (See docs for log levels)
wrapper.logfile.loglevel=INFO

# Roll mode of the log file.
#  SIZE_OR_WRAPPER causes the file to be rolled whenever its size exceeds the
#  value defined by wrapper.logfile.maxsize, or whenever the Wrapper is
#  launched.
wrapper.logfile.rollmode=SIZE_OR_WRAPPER

# Maximum size that the log file will be allowed to grow to before
#  the log is rolled. Size is specified in bytes.  The default value
#  of 0 disables log rolling.  May abbreviate with the 'k' (kb) or
#  'm' (mb) suffixes.  For example: 10m = 10 megabytes.
wrapper.logfile.maxsize=10m

# Maximum number of rolled log files which will be allowed before old
#  files are deleted.  The default value of 0 implies no limit.
wrapper.logfile.maxfiles=9

# Log Level for sys/event log output.  (See docs for log levels)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Wrapper General Properties
#********************************************************************
# Allow for the use of non-contiguous numbered properties
wrapper.ignore_sequence_gaps=TRUE

# Do not start if the pid file already exists.
wrapper.pidfile.strict=TRUE

# Title to use when running as a console
wrapper.console.title=Jetty Server

#********************************************************************
# Wrapper JVM Checks
#********************************************************************
# Detect DeadLocked Threads in the JVM. (Requires Standard Edition)
wrapper.check.deadlock=TRUE
wrapper.check.deadlock.interval=60
wrapper.check.deadlock.action=RESTART
wrapper.check.deadlock.output=FULL

# Out Of Memory detection.
#  Ignore -verbose:class output to avoid false positives.
wrapper.filter.trigger.1000=[Loaded java.lang.OutOfMemoryError
wrapper.filter.action.1000=NONE
#  Ignore -Xlog:class+load=level output to avoid false positives.
wrapper.filter.trigger.1001=[class,load] java.lang.OutOfMemoryError
wrapper.filter.action.1001=NONE
# (Simple match)
wrapper.filter.trigger.1002=java.lang.OutOfMemoryError
# (Only match text in stack traces if -XX:+PrintClassHistogram is being used.)
#wrapper.filter.trigger.1002=Exception in thread "*" java.lang.OutOfMemoryError
#wrapper.filter.allow_wildcards.1002=TRUE
wrapper.filter.action.1002=RESTART
wrapper.filter.message.1002=The JVM has run out of memory.

#********************************************************************
# Wrapper Email Notifications. (Requires Professional Edition)
#********************************************************************
# Common Event Email settings.
#wrapper.event.default.email.debug=TRUE
#wrapper.event.default.email.smtp.host=<SMTP_Host>
#wrapper.event.default.email.smtp.port=25
#wrapper.event.default.email.subject=[%WRAPPER_HOSTNAME%:%WRAPPER_NAME%:%WRAPPER_EVENT_NAME%] Event Notification
#wrapper.event.default.email.sender=<Sender email>
#wrapper.event.default.email.recipient=<Recipient email>

# Configure the log attached to event emails.
#wrapper.event.default.email.maillog=ATTACHMENT
#wrapper.event.default.email.maillog.lines=50
#wrapper.event.default.email.maillog.format=LPTM
#wrapper.event.default.email.maillog.loglevel=INFO

# Enable specific event emails.
#wrapper.event.wrapper_start.email=TRUE
#wrapper.event.jvm_prelaunch.email=TRUE
#wrapper.event.jvm_start.email=TRUE
#wrapper.event.jvm_started.email=TRUE
#wrapper.event.jvm_deadlock.email=TRUE
#wrapper.event.jvm_stop.email=TRUE
#wrapper.event.jvm_stopped.email=TRUE
#wrapper.event.jvm_restart.email=TRUE
#wrapper.event.jvm_failed_invocation.email=TRUE
#wrapper.event.jvm_max_failed_invocations.email=TRUE
#wrapper.event.jvm_kill.email=TRUE
#wrapper.event.jvm_killed.email=TRUE
#wrapper.event.jvm_unexpected_exit.email=TRUE
#wrapper.event.wrapper_stop.email=TRUE

# Specify custom mail content
wrapper.event.jvm_restart.email.body=The JVM was restarted.\n\nPlease check on its status.\n

#********************************************************************
# Wrapper Secure File Properties
#********************************************************************
# To enforce the principle of least privilege for files containing
#  sensitive data, the Wrapper requires that all permissions granted
#  to these files be explicitly allowed in the configuration.
#  Please read the documentation for the full list of properties.

# Allow specific accounts or groups on Windows.
#wrapper.secure_file.check.windows.allowed_account.1=NT AUTHORITY\SYSTEM
#wrapper.secure_file.check.windows.allowed_account.2=BUILTIN\Administrators

# Allow specific groups on Unix systems.
#wrapper.secure_file.check.unix.allowed_group.1=<Group_Of_Users>

# Additional files to check for permissions (Requires Standard Edition)
#wrapper.secure_file.additional.1=<Secured_File>

#********************************************************************
# Wrapper Windows Service Properties
#********************************************************************
# WARNING - Do not modify any of these properties when an application
#  using this configuration file has been installed as a service.
#  Please uninstall the service before modifying this section.
#  The service can then be reinstalled.

# Name of the service
wrapper.name=jetty

# Display name of the service
wrapper.displayname=Jetty

# Description of the service
wrapper.description=Jetty Server

# Service dependencies.  Add dependencies as needed starting from 1
wrapper.ntservice.dependency.1=

# Mode in which the service is installed.
#  AUTO_START, DELAY_START (Requires Standard Edition) or DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# Account to use when running the service.
#  The default blank value will use LocalSystem, which is highly privileged
#  account on Windows. Please read the documentation page for this property to
#  learn about other account types that can be used.
wrapper.ntservice.account=

# Allow the current user to perform certain actions without being prompted for
#  administrator credentials. (Requires Professional Edition)
#wrapper.ntservice.permissions.1.account=CURRENT_USER
#wrapper.ntservice.permissions.1.allow=START, STOP, PAUSE_RESUME

NOTE

Wenn Sie die Standard oder Professional Edition verwenden, dann wurde eine standardmäßige 15-Minuten-Lizenz als conf/wrapper-license.conf kopiert. Sie müssen diese mit einer Trial-, Server- oder Development-Lizenz aktualisieren, um länger als diese Zeitspanne ausführen zu können.

Ausführen

Zum Ausführen in einer Konsole:

  • Ausführen: bin/service.sh console

Zum Ausführen als daemon (service):

  • Installieren Sie den Dienst mit: bin/service.sh install

  • Starten Sie anschließend den Dienst mit: bin/service.sh start

  • Stoppen Sie den Dienst mit: bin/service.sh stop

  • Deinstallieren Sie den Dienst mit: bin/service.sh remove

Für eine Liste der verfügbaren Befehle:

  • Ausführen: bin/service.sh

Sie können die Protokollausgabe des Wrappers zusammen mit der Konsolenausgabe von Java sehen, indem Sie die Protokolldatei logs/wrapper.log mit tail verfolgen. Weitere Jetty-Protokolldateien finden Sie ebenfalls in diesem Verzeichnis.

Eclipse Jetty 10.0.x-Integration

Dieser Abschnitt beschreibt die Schritte zur schnellen Einrichtung von Eclipse Jetty 10.0.26. Andere Versionen der Jetty-10-Serie sollten auf ähnliche Weise funktionieren.

Jetty herunterladen

Laden Sie Jetty als tar.gz-Datei von den Jetty-Downloads herunter. Bestimmte Versionen können auch aus dem Maven-Repository heruntergeladen werden. Wir werden mit jetty-home-10.0.26.tar.gz arbeiten.

Entpacken Sie das Archiv, um ein Verzeichnis jetty-home-10.0.26 zu erhalten, und benennen Sie es optional nach Ihren Wünschen um.

Jetty 10 möchte nichts im Home-Verzeichnis ändern. Erstellen Sie ein paralleles Verzeichnis jetty-base-10, wechseln Sie in dieses Verzeichnis und führen Sie den folgenden Befehl aus, um das Verzeichnis zu initialisieren:

java -jar ../jetty-home-10.0.26/start.jar --add-module=server,http,deploy

Wrapper herunterladen

Die folgenden Schritte sind für die Version 3.7.4 des Java Service Wrappers ausgelegt. Die Verwendung früherer Versionen ist möglich, erfordert jedoch wahrscheinlich einige Anpassungen.

Entscheiden Sie, welche Edition Sie verwenden möchten (Professional, Standard oder Community), und wählen Sie die Zielplattform, Bittiefe und Architektur. Laden Sie anschließend das Installationsprogramm oder Archiv herunter und installieren bzw. entpacken Sie es. Wir gehen davon aus, dass Sie die Professional 64-Bit-Edition unter Linux x86 verwenden.

Wrapper-Integration

Um die Platzierung der erforderlichen Wrapper-Dateien zu erleichtern, erstellen Sie das folgende Shell-Skript in Ihrem Verzeichnis jetty-base-10 als updateWrapper.sh. Aktualisieren Sie den Speicherort, an dem Sie den Wrapper oben installiert oder entpackt haben. Vergessen Sie nicht, es ausführbar zu machen.

#!/bin/sh
WRAPPER_HOME=../wrapper-linux-x86-64-3.7.4-pro
JETTY_BASE=.
WRAPPER_SCRIPT=service.sh

mkdir -p ${JETTY_BASE}/bin
mkdir -p ${JETTY_BASE}/lib
if [ -d ${WRAPPER_HOME}/lang ]
then
    mkdir -p ${JETTY_BASE}/lang
    cp -n ${WRAPPER_HOME}/lang/wrapper_*.mo ${JETTY_BASE}/lang/.
    cp -n ${WRAPPER_HOME}/lang/wrapperjni_*.mo ${JETTY_BASE}/lang/.
fi
mkdir -p ${JETTY_BASE}/conf
if [ -f ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ]
then
    cp -n ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ${JETTY_BASE}/conf/wrapper-license.conf
fi
mkdir -p ${JETTY_BASE}/logs
mkdir -p ${JETTY_BASE}/tmp

cp ${WRAPPER_HOME}/bin/wrapper ${JETTY_BASE}/bin/.
cp ${WRAPPER_HOME}/lib/wrapper.jar ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/lib/libwrapper.* ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/src/bin/App.sh.in ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

sed -i '' -e 's/@app\.name@/jetty/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
sed -i '' -e 's/@app\.long\.name@/Jetty Server/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
chmod +x ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

Führen Sie das Skript aus:

./updateWrapper.sh

Die Konfiguration verwendet Integrationsmethode 1. Siehe den Hinweis unten, warum start.jar nicht als ausführbare JAR-Datei verwendet wird.

NOTE

- Die Variable JAVA_HOME muss gesetzt sein, verwendet jedoch standardmäßig die Systemumgebung, falls sie dort definiert ist. Für Jetty 10 muss mindestens Java 11 angegeben werden.

- Die Datei start.jar von Jetty ist eine ausführbare JAR-Datei. Grundsätzlich hätten wir für diese Einrichtung Integrationsmethode 4 verwenden können, dies hätte jedoch erfordert, dass die erste Anwendungseigenschaft als wrapper.app.parameter.1=%JETTY_HOME%/start.jar angegeben wird. Dies würde auf einzelnen Rechnern zu unterschiedlichen Werten aufgelöst werden und bei Verwendung des Lizenzschlüssels nicht funktionieren. Als Workaround wird die start.jar als reguläre JAR-Datei im Klassenpfad behandelt, und der Eintrag Main-Class: org.eclipse.jetty.start.Main wurde aus der Manifest-Datei extrahiert, um direkt darauf zu verweisen.

Erstellen Sie die Wrapper-Konfigurationsdatei als conf/wrapper.conf mit folgendem Inhalt:

@encoding=UTF-8
# The configuration file must begin with a line declaring its encoding.

# Default mode for file inclusions
@include.default_mode=required

# Include file problems can be debugged by removing '#' at the beginning
#  of the following line:
#@include.debug

#********************************************************************
# Wrapper License Properties (Ignored by Community Edition)
#********************************************************************
# Professional and Standard Editions of the Wrapper require a valid
#  License Key to start.  Licenses can be purchased or a trial license
#  requested on the following pages:
# https://wrapper.tanukisoftware.com/purchase
# https://wrapper.tanukisoftware.com/trial

# The Wrapper will look for either of the following optional files for a
#  valid License Key.  License Key properties can optionally be included
#  directly in this configuration file.
@include.optional %WRAPPER_CONF_DIR%/wrapper-license.conf
@include.optional %WRAPPER_CONF_DIR%/wrapper-license-%WRAPPER_HOST_NAME%.conf

# The following property will output information about which License Key(s)
#  are being found, and can aid in resolving any licensing problems.
#wrapper.license.debug=TRUE

#********************************************************************
# Environment
#********************************************************************
set.default.JAVA_HOME=(SetMe)
# Setting all relative paths next to the fixed WRAPPER_BIN_DIR location helps make their meaning clear.
set.JETTY_HOME=%WRAPPER_BIN_DIR%/../../jetty-home-10.0.26
set.JETTY_BASE=%WRAPPER_BIN_DIR%/..

# Change the working dir used by java so Jetty is in its expected location.
#  Setting JETTY_BASE relative to the fixed WRAPPER_BIN_DIR location helps make their meaning clear and avoid confusion when changing the working dir.
wrapper.working.dir=%JETTY_BASE%

#********************************************************************
# Wrapper Localization
#********************************************************************
# Specify the language and locale which the Wrapper should use.
#wrapper.lang=en_US # en_US or ja_JP

# Specify the location of the language resource files (*.mo).
wrapper.lang.folder=%JETTY_BASE%/lang

#********************************************************************
# Wrapper Java Properties
#********************************************************************
# Java Application
wrapper.java.command=%JAVA_HOME%/bin/java

# Tell the Wrapper to log the full generated Java command line.
#wrapper.java.command.loglevel=INFO

# Wrapper Jar file
wrapper.jarfile=%JETTY_BASE%/lib/wrapper.jar

# Log level for notices about missing Java Classpath entries.
wrapper.java.classpath.missing.loglevel=WARN

# Java Version control
wrapper.java.version.output=true
wrapper.java.version.min=11
#wrapper.java.version.max=

# Java Classpath.  Add class path elements as needed starting from 1
wrapper.java.classpath.1=%JETTY_HOME%/start.jar

# Java Modulepath. (Requires Java 9 or above)
#  Add module path elements as needed starting from 1
#wrapper.java.module_path.1=

# Java Module list. (Requires Java 9 or above)
#  Add module names as needed starting from 1
#wrapper.java.module.1=

# Java Library Path (location of wrapper.dll or libwrapper.so)
wrapper.java.library.path.1=%JETTY_BASE%/lib

# Java Bits.  On applicable platforms, tells the JVM to run in 32 or 64-bit mode.
wrapper.java.additional.auto_bits=TRUE

# Java Additional Parameters
wrapper.java.additional.1=-Djava.io.tmpdir=%JETTY_BASE%/tmp

# Initial Java Heap Size (in MB)
#wrapper.java.initmemory=3

# Maximum Java Heap Size (in MB)
wrapper.java.maxmemory=256

# Application System Properties passed via the backend.
#  Core Java System Properties must be passed using wrapper.java.additional.<n>.
wrapper.app.property.1=jetty.home=%JETTY_HOME%
wrapper.app.property.2=jetty.base=%JETTY_BASE%

# Java Main class.  This class must implement the WrapperListener interface
#  or guarantee that the WrapperManager class is initialized.
#  Helper classes are provided to do this for you.
#  See the following page for details:
#  https://wrapper.tanukisoftware.com/doc/english/integrate.html
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp

# Application parameters.
#  Pass parameters via the backend instead of the command line.
#wrapper.app.parameter.backend=TRUE

#  Add parameters as needed starting from 1
wrapper.app.parameter.1=org.eclipse.jetty.start.Main

#********************************************************************
# Wrapper Logging Properties
#********************************************************************
# Enables Debug output from the Wrapper.
# wrapper.debug=TRUE

# Format of output for the console.  (See docs for formats)
wrapper.console.format=PM

# Log Level for console output.  (See docs for log levels)
wrapper.console.loglevel=INFO

# Log file to use for Wrapper output logging.
wrapper.logfile=%JETTY_BASE%/logs/wrapper.log

# Format of output for the log file.  (See docs for formats)
wrapper.logfile.format=LPTM

# Log Level for log file output.  (See docs for log levels)
wrapper.logfile.loglevel=INFO

# Roll mode of the log file.
#  SIZE_OR_WRAPPER causes the file to be rolled whenever its size exceeds the
#  value defined by wrapper.logfile.maxsize, or whenever the Wrapper is
#  launched.
wrapper.logfile.rollmode=SIZE_OR_WRAPPER

# Maximum size that the log file will be allowed to grow to before
#  the log is rolled. Size is specified in bytes.  The default value
#  of 0 disables log rolling.  May abbreviate with the 'k' (kb) or
#  'm' (mb) suffixes.  For example: 10m = 10 megabytes.
wrapper.logfile.maxsize=10m

# Maximum number of rolled log files which will be allowed before old
#  files are deleted.  The default value of 0 implies no limit.
wrapper.logfile.maxfiles=9

# Log Level for sys/event log output.  (See docs for log levels)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Wrapper General Properties
#********************************************************************
# Allow for the use of non-contiguous numbered properties
wrapper.ignore_sequence_gaps=TRUE

# Do not start if the pid file already exists.
wrapper.pidfile.strict=TRUE

# Title to use when running as a console
wrapper.console.title=Jetty Server

#********************************************************************
# Wrapper JVM Checks
#********************************************************************
# Detect DeadLocked Threads in the JVM. (Requires Standard Edition)
wrapper.check.deadlock=TRUE
wrapper.check.deadlock.interval=60
wrapper.check.deadlock.action=RESTART
wrapper.check.deadlock.output=FULL

# Out Of Memory detection.
#  Ignore -verbose:class output to avoid false positives.
wrapper.filter.trigger.1000=[Loaded java.lang.OutOfMemoryError
wrapper.filter.action.1000=NONE
#  Ignore -Xlog:class+load=level output to avoid false positives.
wrapper.filter.trigger.1001=[class,load] java.lang.OutOfMemoryError
wrapper.filter.action.1001=NONE
# (Simple match)
wrapper.filter.trigger.1002=java.lang.OutOfMemoryError
# (Only match text in stack traces if -XX:+PrintClassHistogram is being used.)
#wrapper.filter.trigger.1002=Exception in thread "*" java.lang.OutOfMemoryError
#wrapper.filter.allow_wildcards.1002=TRUE
wrapper.filter.action.1002=RESTART
wrapper.filter.message.1002=The JVM has run out of memory.

#********************************************************************
# Wrapper Email Notifications. (Requires Professional Edition)
#********************************************************************
# Common Event Email settings.
#wrapper.event.default.email.debug=TRUE
#wrapper.event.default.email.smtp.host=<SMTP_Host>
#wrapper.event.default.email.smtp.port=25
#wrapper.event.default.email.subject=[%WRAPPER_HOSTNAME%:%WRAPPER_NAME%:%WRAPPER_EVENT_NAME%] Event Notification
#wrapper.event.default.email.sender=<Sender email>
#wrapper.event.default.email.recipient=<Recipient email>

# Configure the log attached to event emails.
#wrapper.event.default.email.maillog=ATTACHMENT
#wrapper.event.default.email.maillog.lines=50
#wrapper.event.default.email.maillog.format=LPTM
#wrapper.event.default.email.maillog.loglevel=INFO

# Enable specific event emails.
#wrapper.event.wrapper_start.email=TRUE
#wrapper.event.jvm_prelaunch.email=TRUE
#wrapper.event.jvm_start.email=TRUE
#wrapper.event.jvm_started.email=TRUE
#wrapper.event.jvm_deadlock.email=TRUE
#wrapper.event.jvm_stop.email=TRUE
#wrapper.event.jvm_stopped.email=TRUE
#wrapper.event.jvm_restart.email=TRUE
#wrapper.event.jvm_failed_invocation.email=TRUE
#wrapper.event.jvm_max_failed_invocations.email=TRUE
#wrapper.event.jvm_kill.email=TRUE
#wrapper.event.jvm_killed.email=TRUE
#wrapper.event.jvm_unexpected_exit.email=TRUE
#wrapper.event.wrapper_stop.email=TRUE

# Specify custom mail content
wrapper.event.jvm_restart.email.body=The JVM was restarted.\n\nPlease check on its status.\n

#********************************************************************
# Wrapper Secure File Properties
#********************************************************************
# To enforce the principle of least privilege for files containing
#  sensitive data, the Wrapper requires that all permissions granted
#  to these files be explicitly allowed in the configuration.
#  Please read the documentation for the full list of properties.

# Allow specific accounts or groups on Windows.
#wrapper.secure_file.check.windows.allowed_account.1=NT AUTHORITY\SYSTEM
#wrapper.secure_file.check.windows.allowed_account.2=BUILTIN\Administrators

# Allow specific groups on Unix systems.
#wrapper.secure_file.check.unix.allowed_group.1=<Group_Of_Users>

# Additional files to check for permissions (Requires Standard Edition)
#wrapper.secure_file.additional.1=<Secured_File>

#********************************************************************
# Wrapper Windows Service Properties
#********************************************************************
# WARNING - Do not modify any of these properties when an application
#  using this configuration file has been installed as a service.
#  Please uninstall the service before modifying this section.
#  The service can then be reinstalled.

# Name of the service
wrapper.name=jetty

# Display name of the service
wrapper.displayname=Jetty

# Description of the service
wrapper.description=Jetty Server

# Service dependencies.  Add dependencies as needed starting from 1
wrapper.ntservice.dependency.1=

# Mode in which the service is installed.
#  AUTO_START, DELAY_START (Requires Standard Edition) or DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# Account to use when running the service.
#  The default blank value will use LocalSystem, which is highly privileged
#  account on Windows. Please read the documentation page for this property to
#  learn about other account types that can be used.
wrapper.ntservice.account=

# Allow the current user to perform certain actions without being prompted for
#  administrator credentials. (Requires Professional Edition)
#wrapper.ntservice.permissions.1.account=CURRENT_USER
#wrapper.ntservice.permissions.1.allow=START, STOP, PAUSE_RESUME

NOTE

Wenn Sie die Standard oder Professional Edition verwenden, dann wurde eine standardmäßige 15-Minuten-Lizenz als conf/wrapper-license.conf kopiert. Sie müssen diese mit einer Trial-, Server- oder Development-Lizenz aktualisieren, um länger als diese Zeitspanne ausführen zu können.

Ausführen

Zum Ausführen in einer Konsole:

  • Ausführen: bin/service.sh console

Zum Ausführen als daemon (service):

  • Installieren Sie den Dienst mit: bin/service.sh install

  • Starten Sie anschließend den Dienst mit: bin/service.sh start

  • Stoppen Sie den Dienst mit: bin/service.sh stop

  • Deinstallieren Sie den Dienst mit: bin/service.sh remove

Für eine Liste der verfügbaren Befehle:

  • Ausführen: bin/service.sh

Sie können die Protokollausgabe des Wrappers zusammen mit der Konsolenausgabe von Java sehen, indem Sie die Protokolldatei logs/wrapper.log mit tail verfolgen. Weitere Jetty-Protokolldateien finden Sie ebenfalls in diesem Verzeichnis.

Eclipse Jetty 9.4.x Integration

Dieser Abschnitt beschreibt die Schritte zur schnellen Einrichtung von Eclipse Jetty 9.4.58.v20250814. Andere Versionen der Jetty-9-Serie sollten auf ähnliche Weise funktionieren.

Jetty herunterladen

Laden Sie Jetty als tar.gz-Datei von Jetty-Downloads herunter. Bestimmte Versionen können auch von der Archivseite heruntergeladen werden. Wir werden mit jetty-distribution-9.4.58.v20250814.tar.gz arbeiten.

Entpacken Sie das Archiv, um ein Verzeichnis jetty-distribution-9.4.58.v20250814 zu erhalten, und benennen Sie es optional nach Ihren Wünschen um.

Jetty 9 möchte nichts im Home-Verzeichnis verändern. Erstellen Sie ein paralleles Verzeichnis jetty-base-9, wechseln Sie mit cd in dieses Verzeichnis und führen Sie den folgenden Befehl aus, um das Verzeichnis zu initialisieren:

java -jar ../jetty-distribution-9.4.58.v20250814/start.jar --add-to-start=http,deploy

Wrapper herunterladen

Die folgenden Schritte sind für die Version 3.7.4 des Java Service Wrappers ausgelegt. Die Verwendung früherer Versionen ist möglich, erfordert jedoch wahrscheinlich einige Änderungen.

Entscheiden Sie, welche Edition Sie verwenden möchten (Professional, Standard oder Community), und wählen Sie die Zielplattform, Bittiefe und Architektur. Laden Sie dann das Installationsprogramm oder Archiv herunter und installieren bzw. entpacken Sie es. Wir gehen davon aus, dass Sie die Professional 64-Bit-Edition unter Linux x86 verwenden.

Wrapper-Integration

Um die Platzierung der erforderlichen Wrapper-Dateien zu erleichtern, erstellen Sie das folgende Shell-Skript in Ihrem Verzeichnis jetty-base-9 als updateWrapper.sh. Aktualisieren Sie den Speicherort, an dem Sie den Wrapper oben installiert oder entpackt haben. Vergessen Sie nicht, es ausführbar zu machen.

#!/bin/sh
WRAPPER_HOME=../wrapper-linux-x86-64-3.7.4-pro
JETTY_BASE=.
WRAPPER_SCRIPT=service.sh

mkdir -p ${JETTY_BASE}/bin
mkdir -p ${JETTY_BASE}/lib
if [ -d ${WRAPPER_HOME}/lang ]
then
    mkdir -p ${JETTY_BASE}/lang
    cp -n ${WRAPPER_HOME}/lang/wrapper_*.mo ${JETTY_BASE}/lang/.
    cp -n ${WRAPPER_HOME}/lang/wrapperjni_*.mo ${JETTY_BASE}/lang/.
fi
mkdir -p ${JETTY_BASE}/conf
if [ -f ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ]
then
    cp -n ${WRAPPER_HOME}/src/conf/wrapper-license-time.conf ${JETTY_BASE}/conf/wrapper-license.conf
fi
mkdir -p ${JETTY_BASE}/logs
mkdir -p ${JETTY_BASE}/tmp

cp ${WRAPPER_HOME}/bin/wrapper ${JETTY_BASE}/bin/.
cp ${WRAPPER_HOME}/lib/wrapper.jar ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/lib/libwrapper.* ${JETTY_BASE}/lib/.
cp ${WRAPPER_HOME}/src/bin/App.sh.in ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

sed -i '' -e 's/@app\.name@/jetty/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
sed -i '' -e 's/@app\.long\.name@/Jetty Server/g' ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}
chmod +x ${JETTY_BASE}/bin/${WRAPPER_SCRIPT}

Führen Sie das Skript aus:

./updateWrapper.sh

Die Konfiguration verwendet Integrationsmethode 1. Siehe den Hinweis unten, warum start.jar nicht als ausführbare JAR-Datei verwendet wird.

NOTE

- Die Variable JAVA_HOME muss gesetzt sein, greift jedoch standardmäßig auf die Systemumgebung zurück, falls sie dort definiert ist. Für Jetty 9 muss mindestens Java 8 angegeben werden.

- Die Datei start.jar von Jetty ist eine ausführbare JAR-Datei. Prinzipiell hätten wir für diese Einrichtung die Integrationsmethode 4 verwenden können, dann hätten wir jedoch die erste Anwendungseigenschaft als wrapper.app.parameter.1=%JETTY_HOME%/start.jar angeben müssen. Das würde auf einzelnen Rechnern zu unterschiedlichen Werten aufgelöst und würde bei Verwendung des Lizenzschlüssels nicht funktionieren. Als Workaround wird die start.jar als normale JAR-Datei im Klassenpfad behandelt, und der Eintrag Main-Class: org.eclipse.jetty.start.Main wurde aus der Manifest-Datei extrahiert, um direkt darauf zu verweisen.

Erstellen Sie die Wrapper-Konfigurationsdatei als conf/wrapper.conf mit folgendem Inhalt:

@encoding=UTF-8
# The configuration file must begin with a line declaring its encoding.

# Default mode for file inclusions
@include.default_mode=required

# Include file problems can be debugged by removing '#' at the beginning
#  of the following line:
#@include.debug

#********************************************************************
# Wrapper License Properties (Ignored by Community Edition)
#********************************************************************
# Professional and Standard Editions of the Wrapper require a valid
#  License Key to start.  Licenses can be purchased or a trial license
#  requested on the following pages:
# https://wrapper.tanukisoftware.com/purchase
# https://wrapper.tanukisoftware.com/trial

# The Wrapper will look for either of the following optional files for a
#  valid License Key.  License Key properties can optionally be included
#  directly in this configuration file.
@include.optional ../conf/wrapper-license.conf
@include.optional ../conf/wrapper-license-%WRAPPER_HOST_NAME%.conf

# The following property will output information about which License Key(s)
#  are being found, and can aid in resolving any licensing problems.
#wrapper.license.debug=TRUE

#********************************************************************
# Environment
#********************************************************************
set.default.JAVA_HOME=(SetMe)
# Setting all relative paths next to the fixed WRAPPER_BIN_DIR location helps make their meaning clear.
set.JETTY_HOME=%WRAPPER_BIN_DIR%/../../jetty-distribution-9.4.58.v20250814
set.JETTY_BASE=%WRAPPER_BIN_DIR%/..

# Change the working dir used by java so Jetty is in its expected location.
#  Setting JETTY_BASE relative to the fixed WRAPPER_BIN_DIR location helps make their meaning clear and avoid confusion when changing the working dir.
wrapper.working.dir=%JETTY_BASE%

#********************************************************************
# Wrapper Localization
#********************************************************************
# Specify the language and locale which the Wrapper should use.
#wrapper.lang=en_US # en_US or ja_JP

# Specify the location of the language resource files (*.mo).
wrapper.lang.folder=%JETTY_BASE%/lang

#********************************************************************
# Wrapper Java Properties
#********************************************************************
# Java Application
wrapper.java.command=%JAVA_HOME%/bin/java

# Tell the Wrapper to log the full generated Java command line.
#wrapper.java.command.loglevel=INFO

# Wrapper Jar file
wrapper.jarfile=%JETTY_BASE%/lib/wrapper.jar

# Log level for notices about missing Java Classpath entries.
wrapper.java.classpath.missing.loglevel=WARN

# Java Version control
wrapper.java.version.output=true
wrapper.java.version.min=8
#wrapper.java.version.max=

# Java Classpath.  Add class path elements as needed starting from 1
wrapper.java.classpath.1=%JETTY_HOME%/start.jar

# Java Modulepath. (Requires Java 9 or above)
#  Add module path elements as needed starting from 1
#wrapper.java.module_path.1=

# Java Module list. (Requires Java 9 or above)
#  Add module names as needed starting from 1
#wrapper.java.module.1=

# Java Library Path (location of wrapper.dll or libwrapper.so)
wrapper.java.library.path.1=%JETTY_BASE%/lib

# Java Bits.  On applicable platforms, tells the JVM to run in 32 or 64-bit mode.
wrapper.java.additional.auto_bits=TRUE

# Java Additional Parameters
wrapper.java.additional.1=-Djava.io.tmpdir=%JETTY_BASE%/tmp

# Initial Java Heap Size (in MB)
#wrapper.java.initmemory=3

# Maximum Java Heap Size (in MB)
#wrapper.java.maxmemory=64

# Application System Properties passed via the backend.
#  Core Java System Properties must be passed using wrapper.java.additional.<n>.
wrapper.app.property.1=jetty.home=%JETTY_HOME%
wrapper.app.property.2=jetty.base=%JETTY_BASE%

# Java Main class.  This class must implement the WrapperListener interface
#  or guarantee that the WrapperManager class is initialized.
#  Helper classes are provided to do this for you.
#  See the following page for details:
#  https://wrapper.tanukisoftware.com/doc/english/integrate.html
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp

# Application parameters.
#  Pass parameters via the backend instead of the command line.
#wrapper.app.parameter.backend=TRUE

#  Add parameters as needed starting from 1
wrapper.app.parameter.1=org.eclipse.jetty.start.Main
wrapper.app.parameter.2=jetty.state=%JETTY_BASE%/jetty-echo.state
wrapper.app.parameter.3=jetty-started.xml

#********************************************************************
# Wrapper Logging Properties
#********************************************************************
# Enables Debug output from the Wrapper.
# wrapper.debug=TRUE

# Format of output for the console.  (See docs for formats)
wrapper.console.format=PM

# Log Level for console output.  (See docs for log levels)
wrapper.console.loglevel=INFO

# Log file to use for Wrapper output logging.
wrapper.logfile=%JETTY_BASE%/logs/wrapper.log

# Format of output for the log file.  (See docs for formats)
wrapper.logfile.format=LPTM

# Log Level for log file output.  (See docs for log levels)
wrapper.logfile.loglevel=INFO

# Roll mode of the log file.
#  SIZE_OR_WRAPPER causes the file to be rolled whenever its size exceeds the
#  value defined by wrapper.logfile.maxsize, or whenever the Wrapper is
#  launched.
wrapper.logfile.rollmode=SIZE_OR_WRAPPER

# Maximum size that the log file will be allowed to grow to before
#  the log is rolled. Size is specified in bytes.  The default value
#  of 0 disables log rolling.  May abbreviate with the 'k' (kb) or
#  'm' (mb) suffixes.  For example: 10m = 10 megabytes.
wrapper.logfile.maxsize=10m

# Maximum number of rolled log files which will be allowed before old
#  files are deleted.  The default value of 0 implies no limit.
wrapper.logfile.maxfiles=9

# Log Level for sys/event log output.  (See docs for log levels)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Wrapper General Properties
#********************************************************************
# Allow for the use of non-contiguous numbered properties
wrapper.ignore_sequence_gaps=TRUE

# Do not start if the pid file already exists.
wrapper.pidfile.strict=TRUE

# Title to use when running as a console
wrapper.console.title=Jetty Server

#********************************************************************
# Wrapper JVM Checks
#********************************************************************
# Detect DeadLocked Threads in the JVM. (Requires Standard Edition)
wrapper.check.deadlock=TRUE
wrapper.check.deadlock.interval=60
wrapper.check.deadlock.action=RESTART
wrapper.check.deadlock.output=FULL

# Out Of Memory detection.
#  Ignore -verbose:class output to avoid false positives.
wrapper.filter.trigger.1000=[Loaded java.lang.OutOfMemoryError
wrapper.filter.action.1000=NONE
#  Ignore -Xlog:class+load=level output to avoid false positives.
wrapper.filter.trigger.1001=[class,load] java.lang.OutOfMemoryError
wrapper.filter.action.1001=NONE
# (Simple match)
wrapper.filter.trigger.1002=java.lang.OutOfMemoryError
# (Only match text in stack traces if -XX:+PrintClassHistogram is being used.)
#wrapper.filter.trigger.1002=Exception in thread "*" java.lang.OutOfMemoryError
#wrapper.filter.allow_wildcards.1002=TRUE
wrapper.filter.action.1002=RESTART
wrapper.filter.message.1002=The JVM has run out of memory.

#********************************************************************
# Wrapper Email Notifications. (Requires Professional Edition)
#********************************************************************
# Common Event Email settings.
#wrapper.event.default.email.debug=TRUE
#wrapper.event.default.email.smtp.host=<SMTP_Host>
#wrapper.event.default.email.smtp.port=25
#wrapper.event.default.email.subject=[%WRAPPER_HOSTNAME%:%WRAPPER_NAME%:%WRAPPER_EVENT_NAME%] Event Notification
#wrapper.event.default.email.sender=<Sender email>
#wrapper.event.default.email.recipient=<Recipient email>

# Configure the log attached to event emails.
#wrapper.event.default.email.maillog=ATTACHMENT
#wrapper.event.default.email.maillog.lines=50
#wrapper.event.default.email.maillog.format=LPTM
#wrapper.event.default.email.maillog.loglevel=INFO

# Enable specific event emails.
#wrapper.event.wrapper_start.email=TRUE
#wrapper.event.jvm_prelaunch.email=TRUE
#wrapper.event.jvm_start.email=TRUE
#wrapper.event.jvm_started.email=TRUE
#wrapper.event.jvm_deadlock.email=TRUE
#wrapper.event.jvm_stop.email=TRUE
#wrapper.event.jvm_stopped.email=TRUE
#wrapper.event.jvm_restart.email=TRUE
#wrapper.event.jvm_failed_invocation.email=TRUE
#wrapper.event.jvm_max_failed_invocations.email=TRUE
#wrapper.event.jvm_kill.email=TRUE
#wrapper.event.jvm_killed.email=TRUE
#wrapper.event.jvm_unexpected_exit.email=TRUE
#wrapper.event.wrapper_stop.email=TRUE

# Specify custom mail content
wrapper.event.jvm_restart.email.body=The JVM was restarted.\n\nPlease check on its status.\n

#********************************************************************
# Wrapper Secure File Properties
#********************************************************************
# To enforce the principle of least privilege for files containing
#  sensitive data, the Wrapper requires that all permissions granted
#  to these files be explicitly allowed in the configuration.
#  Please read the documentation for the full list of properties.

# Allow specific accounts or groups on Windows.
#wrapper.secure_file.check.windows.allowed_account.1=NT AUTHORITY\SYSTEM
#wrapper.secure_file.check.windows.allowed_account.2=BUILTIN\Administrators

# Allow specific groups on Unix systems.
#wrapper.secure_file.check.unix.allowed_group.1=<Group_Of_Users>

# Additional files to check for permissions (Requires Standard Edition)
#wrapper.secure_file.additional.1=<Secured_File>

#********************************************************************
# Wrapper Windows Service Properties
#********************************************************************
# WARNING - Do not modify any of these properties when an application
#  using this configuration file has been installed as a service.
#  Please uninstall the service before modifying this section.
#  The service can then be reinstalled.

# Name of the service
wrapper.name=jetty

# Display name of the service
wrapper.displayname=Jetty

# Description of the service
wrapper.description=Jetty Server

# Service dependencies.  Add dependencies as needed starting from 1
wrapper.ntservice.dependency.1=

# Mode in which the service is installed.
#  AUTO_START, DELAY_START (Requires Standard Edition) or DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# Account to use when running the service.
#  The default blank value will use LocalSystem, which is highly privileged
#  account on Windows. Please read the documentation page for this property to
#  learn about other account types that can be used.
wrapper.ntservice.account=

# Allow the current user to perform certain actions without being prompted for
#  administrator credentials. (Requires Professional Edition)
#wrapper.ntservice.permissions.1.account=CURRENT_USER
#wrapper.ntservice.permissions.1.allow=START, STOP, PAUSE_RESUME

NOTE

Wenn Sie die Standard oder Professional Edition verwenden, dann wurde eine standardmäßige 15-Minuten-Lizenz als conf/wrapper-license.conf kopiert. Sie müssen diese mit einer Trial-, Server- oder Development-Lizenz aktualisieren, um länger als diese Zeitspanne ausführen zu können.

Ausführen

Zum Ausführen in einer Konsole:

  • Ausführen: bin/service.sh console

Zum Ausführen als daemon (service):

  • Installieren Sie den Dienst mit: bin/service.sh install

  • Starten Sie anschließend den Dienst mit: bin/service.sh start

  • Stoppen Sie den Dienst mit: bin/service.sh stop

  • Deinstallieren Sie den Dienst mit: bin/service.sh remove

Für eine Liste der verfügbaren Befehle:

  • Ausführen: bin/service.sh

Die Protokollausgabe des Wrappers sowie die Konsolenausgabe von Java können Sie einsehen, indem Sie die Protokolldatei logs/wrapper.log mit tail verfolgen. Weitere Jetty-Protokolldateien finden Sie ebenfalls in diesem Verzeichnis.

Feedback-Anfrage

Wenn Sie ein erfahrener Jetty-Anwender sind und Vorschläge zur Verbesserung dieses Dokuments haben, lassen Sie es uns bitte unter support@tanukisoftware.com wissen.