使用 CLI

本節說明 Web 伺服器 的指令行介面，並定義所有支援的伺服器配置與管理指令。

Web 伺服器 引進名為 wadm 的新 CLI。

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

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

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

Web 伺服器 不支援 HttpServerAdmin。

Web 伺服器 支援 wdeploy 只是為了與 6.x 版本向下相容，且只能在管理伺服器節點上運作。

CLI 的模式

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

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

  wadm> create-config --doc-root=[DOCROOT] --jdk-home=[JAVAHOME] --server-user=[SERVERUSER] [--document-root=serverdocroot] [--platform=32|64] --http-port=port --server-name=servername CONFIGNAME

• 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 的位置

何處可以找到管理 Web 伺服器 所需的 CLI？

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

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

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

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

• 管理伺服器的密碼。

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

以 CLI 進行認證

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

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

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

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

重設管理密碼

開啟指令提示終端機並瀏覽至 install-root/bin/wadm 目錄，然後鍵入下列指令以重設密碼：

./wadm reset-admin-password。

系統會提示您鍵入新的管理密碼。再次鍵入密碼以進行確認。重新啟動伺服器，讓密碼生效。此時，請使用新密碼登入伺服器。

使用 set-admin-prop 指令變更密碼時，您必須從 install-root/admin-server/bin/restart 目錄重新啟動管理伺服器。請不要使用 restart-admin 指令重新啟動伺服器。

註冊到 Sun Connection

您可以使用管理主控台，在 Sun Connection 上註冊 Web 伺服器。按一下首頁的 [註冊到 Sun Connection] 標籤，畫面上會有精靈開啟。請依照精靈指示完成註冊。在 Sun Connection 上註冊 Web 伺服器有下列好處：

• 可得知修補程式資訊和錯誤更新

• 可得知新聞和活動

• 可獲得支援和訓練課程