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
java -jar <Name_der_JAR-Datei>.jar
Operation
- 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:
- 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.
- 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
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. |