從指令行來管理 Liberty

您可以利用 server 指令和 ws-server.jar JAR 執行檔來建立伺服器、啟動或停止伺服器、檢查伺服器是否在執行中,或是對伺服器進行除錯。

關於這項作業

wlp/bin 目錄包含稱為 server 的 Script 來協助控制伺服器程序。 這個 Script 的語法如下:
server <action> [server] [options]

關於 options 可用的值,請參閱伺服器指令選項

避免問題: 如果 Liberty 伺服器是可自動調整的叢集中的叢集成員,則管理主控台容許啟動和停止該伺服器,但前提是伺服器必須是處於維護模式。當 Liberty 伺服器是可自動調整的叢集中的叢集成員時,如果從指令行來啟動或停止該 Liberty 伺服器,則可能造成無法預期的結果。
這個 Script 支援下列動作:
create
這個指令會建立新的伺服器的指令。
debug
除錯器連接到除錯埠之後,在主控台前景執行具名伺服器的指令。 預設埠是 7777。 您可以利用 WLP_DEBUG_ADDRESS 變數來指定替代埠。
dump
這個指令會建立伺服器的 Snapshot,並將結果儲存在保存檔中,以便進一步調整及診斷。
javadump
這個指令會建立伺服器 Java™ 虛擬機器 (JVM) 的 Snapshot,並將結果儲存在檔案中。每個記憶體傾出類型都會建立一個檔案,但並不是所有虛擬機器都支援所有記憶體傾出類型。記憶體傾出檔案的預設目錄為 ${server.output.dir}。如果要設定不同的預設目錄,您必須使用 IBM® JVM,並設定下列環境變數:
  • IBM_HEAPDUMPDIR
  • IBM_COREDIR
  • IBM_JAVACOREDIR
list
這個指令會列出所定義的 Liberty 應用程式伺服器。
package
這個指令會套裝伺服器
[17.0.0.1 以及更新版本]pause
[17.0.0.1 以及更新版本]這個指令會暫停伺服器上可暫停的所有元件。如果要暫停特定的元件,請使用 --target 選項。如需 pause 和 resume 的相關資訊,請參閱從指令行暫停及回復 Liberty 伺服器
[17.0.0.1 以及更新版本]resume
[17.0.0.1 以及更新版本]這個指令會回復伺服器上可能暫停的所有元件。如果要回復特定的元件,請使用 --target 選項。如需 pause 和 resume 的相關資訊,請參閱從指令行暫停及回復 Liberty 伺服器
run
在前景啟動伺服器的指令。
start
這個指令會以背景程序形式來啟動伺服器。
stop
這個指令會停止執行中的伺服器。
status
這個指令會檢查指定的伺服器是否在執行中。
version
這個指令會顯示現行伺服器及 Java 執行時期環境的版本資訊。
help
這個指令會取得指令行 Script 說明,其中包含其他選項的詳細資料。
註: 如果沒有在指令行指定伺服器,當預設伺服器實例 defaultServer 存在時,會針對它來執行動作。
您也可以利用 ${wlp.install.dir}/bin/tools 目錄中的 JAR 執行檔 ws-server.jar 來完成類似的動作。

範例

如果要在 Windows 系統上執行 server Script:
server.bat create server_name
server.bat package server_name
server.bat run server_name
server.bat help server_name
如果要在其他系統上執行 server Script:
server create server_name
server package server_name
server run server_name
server help server_name
如要執行 JAR 執行檔 ws-server.jar 而不使用 server Script:
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar server_name --create
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar server_name
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar --help
--help 選項提供 JAR 執行檔 ws-server.jar 之其他指令行參數(例如 --stop、--version、--clean、--include)的相關資訊。

指示主題類型的圖示 作業主題

檔名:twlp_admin_script.html