使用 CLI

本節說明 Sun Java System Web Server 7.0 的指令行介面，並定義所有支援的伺服器配置和管理指令。

Sun Java System Web Server 7.0 引入了一種稱為 wadm 的新 CLI。

舊版的伺服器支援少數不連續的指令行，這些指令行組合在一起只能處理 GUI 所提供的全部管理功能中的一小部分。Sun Java System Web Server 6.1 支援的指令行介面包括 HttpServerAdmin、wdeploy 和 flexanlg。新 CLI (wadm) 具有下列功能：

• 內嵌式 JACL shell，用於產生程序檔。

• 可延伸的 CLI—藉由協力廠商外掛程式可將更多指令增加到 CLI。

Sun Java System Web Server 7.0 不支援 HttpServerAdmin。

Sun Java System Web Server 7.0 支援 wdeploy 只是為了與 6.x 版本向下相容，且只能在 Administration Server 節點上運作。

CLI 的模式

wadm 支援三種不同模式的呼叫。它們是：

• 獨立模式—在此模式下，將從指令 shell 呼叫 wadm，指定所需的指令、選項和運算元。指令執行完成後，CLI 將結束並返回至 shell。此模式可支援以互動式及非互動式方法執行指令。互動式執行為預設設定，如果密碼檔案 (透過 --password-file 選項傳送) 中尚未指定密碼，則將提示輸入密碼。如果未指定 --password-file 選項，非互動式執行將產生錯誤。例如，

  wadm> create-config --user=admin --password-file=./admin.pwd --http-port=2222 --server-name=syrinx myconfig

• Shell 模式—在此模式下，將從無任何指令的指令 shell 呼叫 wadm。wadm 會提示使用者輸入指令。執行指令後，它將返回至 shell。鍵入結束或退出指令可結束此 shell。互動式及非互動式執行均可採用此模式。例如，

  wadm -user=admin -host=serverhost --password-file=admin.pwd --port=8989

• 檔案模式—在此模式下，您可在檔案中增加指令清單，並將該檔案做為引數傳送至 wadm。例如，

  wadm -user=admin -host=serverhost --password-file=admin.pwd --port=8989 -commands-file=/space/scripts/admscr

下圖描述呼叫 wadm 指令的語法。

藉由 wadm CLI 可執行使用管理主控台能夠完成的所有作業。

wadm CLI 的位置

在何處可以找到用於 Sun Java System Web Server 7.0 管理的 CLI？

管理 CLI 位於 install-root/bin/wadm。若要使用 CLI，您需要瞭解下列資訊：

• 管理伺服器的主機名稱 (預設為 localhost)。

• 管理伺服器的 SSL 連接埠 (預設為 8989)。

• 管理伺服器的使用者名稱 (預設為 admin)。

• 管理伺服器的密碼。

管理伺服器需要處於執行狀態才能使用 CLI。執行 install-root/admin-server/bin/startserv 即可啟動伺服器。

以 CLI 進行認證

wadm 將使用管理員的使用者名稱和密碼，來通過 Administration Server 的認證。您必須將有效的使用者名稱和密碼檔案當成引數，傳送至在單一模式下執行的每個指令。Shell 模式在呼叫 wadm 可執行檔時，可接受使用者名稱和密碼檔案。在 shell 模式下呼叫的指令不需要連線選項 (例如 user、password-file、host、port 和 ssl)。如果已指定選項，則會將其忽略。

CLI 支援的一些指令需要輸入密碼。例如 bindpw、user-password 和 token-pin。使用者可在包含管理使用者密碼的同一檔案中指定這些密碼。如果指令中未指定 password-file，則將會提示使用者輸入密碼。

如果 Administration Server 已啟用 SSL，則 wadm 會透過 SSL 與該 Administration Server 進行通訊。驗證由 Administration Server 傳送的憑證時，會以 truststore (~/.wadmtruststore) 為依據。如果憑證存在並且有效，指令將繼續正常執行。否則，wadm 將顯示憑證，並讓使用者選擇是否接受此憑證。如果使用者接受憑證，則會將此憑證增加到 truststore，並且指令將繼續正常執行。

truststore 不需要密碼保護，因為其中並不包含機密資料。