本節說明 Web 伺服器 的指令行介面,並定義所有支援的伺服器配置與管理指令。
Web 伺服器 引進名為 wadm 的新 CLI。
舊版的伺服器支援少數不連續的指令行,這些指令行組合在一起只能處理 GUI 所提供的全部管理功能中的一小部分。Web 伺服器 6.1 中所支援的指令行介面為 HttpServerAdmin
、wdeploy
與 flexanlg
。新 CLI (wadm) 具有下列功能:
內嵌式 JACL shell,用於產生程序檔。
可延伸的 CLI — 藉由協力廠商外掛程式可將更多指令增加到 CLI。
Web 伺服器 不支援 HttpServerAdmin
。
Web 伺服器 支援 wdeploy 只是為了與 6.x 版本向下相容,且只能在管理伺服器節點上運作。
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 可執行使用管理主控台能夠完成的所有作業。
何處可以找到管理 Web 伺服器 所需的 CLI?
答案:管理 CLI 位於 install-root/bin/wadm
。若要使用 CLI,您需要瞭解下列資訊:
管理伺服器的主機名稱 (預設為 localhost
)。
管理伺服器的 SSL 連接埠 (預設為 8989)。
管理伺服器的使用者名稱 (預設為 admin
)。
管理伺服器的密碼。
管理伺服器需要處於執行狀態才能使用 CLI。執行 install-root/admin-server/bin/startserv
即可啟動伺服器。
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 上註冊 Web 伺服器。按一下首頁的 [註冊到 Sun Connection] 標籤,畫面上會有精靈開啟。請依照精靈指示完成註冊。在 Sun Connection 上註冊 Web 伺服器有下列好處:
可得知修補程式資訊和錯誤更新
可得知新聞和活動
可獲得支援和訓練課程