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

Sie können einen Liberty -Server aus einer JAR-Datei starten. Diese Methode bietet eine kompakte, portierbare Methode zum Starten eines Liberty -Servers. Sie erstellen die JAR-Datei mit dem Serverbefehl Liberty und führen sie dann als ausführbare JAR-Datei mit dem Java-Befehl -jar aus.

Open Liberty Die neueste Dokumentation zu ausführbaren JAR-Dateien für Liberty ist auf der Open Liberty Websiteverfügbar.

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 <server name> --include=[minify,]runnable --archive=<jar file name>.jar

JAR-Datei ausführen

Führen Sie die JAR-Datei aus, indem Sie den Java-Standardbefehl mit der Option -jar verwenden. Beispiel:
java -jar <jar file name>.jar

Operation

Wenn die JAR-Datei ausgeführt wird, wird sie in ein temporäres Verzeichnis extrahiert und anschließend wird der Server im Vordergrund ausgeführt, der durch den Ausführungsbefehl des Liberty -Servers gestartet wird. Die gesamte Ausgabe wird in stdout oder stderr geschrieben. Dateien werden standardmäßig in temporäre Verzeichnisse entpackt:
  • Für Windows: %HOMEPATH%/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn
  • Für alle anderen Plattformen: $HOME/wlpExtract/<jar file name>_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 Starten 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

Standardmäßig sind Transaktionen mit zweiphasiger Festschreibung 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 gelten zwei Voraussetzungen:

  1. Die Umgebungsvariable WLP_JAR_CYGWIN muss angegeben sein.

    Diese Variable bewirkt, dass der JAR-Runner des Liberty -Servers die Verarbeitung von Dateien und Prozessen im UNIX-Stil ausführt, wenn er in der CYGWIN-Umgebung ausgeführt wird.

  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 Extrahiert die JAR-Datei in das Verzeichnis ${WLP_JAR_EXTRACT_ROOT}/<jar file name>_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 <server name> anstelle von server run <server name>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.