Liberty-Server über eine JAR-Datei ausführen

Sie können einen Liberty-Server über eine JAR-Datei (Java-Archiv) starten. Dies ist eine kurze, übertragbare Methode zum Starten eines Liberty-Servers. Sie erstellen die JAR-Datei mit dem Liberty-Serverbefehl und führen sie anschließend als ausführbare JAR-Datei mit dem Java-Befehl -jar aus.

Ausführbare JAR-Datei erstellen

Sie können minify angeben, um das kleinstmögliche Archiv zu erstellen. Sie müssen ein Archiv vom Typ JAR angeben, um eine ausführbare JAR-Datei zu erhalten. Der Standardarchivtyp ist auf allen Plattformen .zip. Eine Ausnahme stellt z/OS dar. Der einzige unterstützte Typ auf dieser Plattform ist pax. Beispiel:

server package <Servername> --include=[minify,]runnable --archive=<Name_der_JAR-Datei>.jar

JAR-Datei ausführen

Führen Sie die JAR-Datei mit dem Java-Standardbefehl unter Angabe der Option –jar aus, z. B.:
java -jar <Name_der_JAR-Datei>.jar

Operation

Wenn die JAR-Datei ausgeführt wird, wird sie in ein temporäres Verzeichnis entpackt und der Server wird im Vordergrund ausgeführt, nachdem er vom Liberty-Befehl "server run" gestartet wurde. Die gesamte Ausgabe wird in stdout oder stderr geschrieben. Dateien werden standardmäßig in temporäre Verzeichnisse entpackt:
  • Windows: %HOMEPATH%/wlpExtract/<Name_der_JAR-Datei>_nnnnnnnnnnnnnnnnnnn
  • Alle anderen Plattformen: $HOME/wlpExtract/<Name_der_JAR-Datei>_nnnnnnnnnnnnnnnnnnn

Sie können mit der Umgebungsvariablen WLP_JAR_EXTRACT_ROOT oder der Umgebungsvariablen WLP_JAR_EXTRACT_DIR steuern, welche Ausgabeposition verwendet wird.

Server stoppen

Drücken Sie zum Stoppen des Liberty-Servers die Tastenkombination Strg + C. Wenn der Liberty-Server gestoppt wird, wird das Extraktionsverzeichnis automatisch gelöscht. Wenn Sie die aktive Shell mit einer anderen Methode stoppen, wird das Extraktionsverzeichnis nicht automatisch gelöscht. Sie müssen es in diesem Fall manuell löschen.

Ausführung im Debugmodus

Sie können den Liberty-Server im Debugmodus ausführen, wenn Sie die Umgebungsvariable WLP_JAR_DEBUG vor dem Start des Servers festlegen.

Ausgabe steuern

Die Serverausgabe wird standardmäßig in das Extraktionsverzeichnis geschrieben, das gelöscht wird, wenn der Server gestoppt wird. Wenn Sie die Ausgabe speichern möchten, geben Sie mit der Umgebungsvariablen WLP_OUTPUT_DIR vor dem Start des Servers eine dauerhafte Ausgabeposition an.

Zweiphasige Festschreibungstransaktionen

Zweiphasige Festschreibungstransaktionen sind standardmäßig inaktiviert, weil sich die Transaktionsprotokolle im Erweiterungsverzeichnis befinden und gelöscht werden, wenn der Liberty-Server gestoppt wird. Aus diesem Grund ist keine Transaktionswiederherstellung möglich.

Wenn Sie eine zweiphasige Festschreibung aktivieren möchten, konfigurieren Sie das Transaktionsprotokoll so, dass es an einer dauerhaften Position im Dateisystem oder in einem RDBMS gespeichert wird, und legen Sie die Umgebungsvariable WLP_JAR_ENABLE_2PC fest.

Verwenden Sie zum Konfigurieren des Transaktionsprotokolls entweder das Attribut transactionLogDirectory oder das Attribut dataSourceRef im Transaktionselement in Ihrer Konfigurationsdatei server.xml.

Ausführung unter CYGWIN

Für die Ausführung einer JAR-Datei des Liberty-Servers in einer CYGWIN-Shell müssen die folgenden zwei Voraussetzungen erfüllt sein:

  1. Die Umgebungsvariable WLP_JAR_CYGWIN muss angegeben sein.

    Diese Variable veranlasst die JAR-Ausführungskomponente des Liberty-Servers, bei einer Ausführung in der CYGWIN-Umgebung Dateien und Prozesse im Unix-Stil zu verarbeiten.

  2. Die Ausführung muss unter der Bash-Shell und nicht unter mintty stattfinden.

    Die Extraktionsdateien werden nur automatisch gelöscht, wenn die Ausführung unter der Bash-Shell stattfindet. Die Ausführung kann zwar auch unter mintty stattfinden, aber dann müssen Sie die Extraktionsdateien manuell löschen. Das zum Auslösen von Java-Shutdown-Hooks erforderliche Signal wird von mintty nicht weitergeleitet.

Referenzinformationen für Umgebungsvariablen

Tabelle 1. Umgebungsvariablennamen und zugehörige Definitionen
Umgebungsvariablenname Beschreibung
WLP_JAR_EXTRACT_ROOT Entpackt die JAR-Datei in das Verzeichnis ${WLP_JAR_EXTRACT_ROOT}/<Name_der_JAR-Datei>_nnnnnnnnnnnnnnnnnnn.
WLP_JAR_EXTRACT_DIR Entpackt die JAR-Datei in das Verzeichnis ${WLP_JAR_EXTRACT_DIR}.
WLP_OUTPUT_DIR Schreibt Ausgabedateien des Liberty-Servers in das Verzeichnis ${WLP_OUTPUT_DIR}.
WLP_JAR_DEBUG Führt den Liberty-Server mit server debug <Servername> und nicht mit server run <Servername> aus.
WLP_JAR_ENABLE_2PC Geben Sie für diese Variable den Wert true an, um 2PC bei der Ausführung der ausführbaren JAR-Datei zu aktivieren.
WLP_JAR_CYGWIN Geben Sie für diese Variable den Wert true an, wenn die JAR-Datei unter CYGWIN ausgeführt wird.

Symbol das den Typ des Artikels anzeigt. Referenzartikel

Dateiname: rwlp_setup_jarserver.html