Sun Management Center CLI 簡介

Sun Management Center 指令行介面 (CLI) 是一種字元驅動的主控台應用程式，可用來監視和管理您的系統。CLI 提供數種有用特徵：

• 較低的系統負擔 – 儘管 CLI 可提供 Java 主控台和 Web 主控台的大多數功能，但是 CLI 無需點陣圖形。因此，CLI 可透過低頻寬連接在簡單資料終端設備上執行。但是，需要 GUI 的功能 (例如實體檢視或繪圖) 則無法透過 CLI 使用。

• 批次模式處理 – CLI 支援基本程序檔功能，此功能可讓 CLI 以批次模式從檔案中獲取指令輸入。

• 可配置的輸出格式 – 您可以配置 CLI 輸出的格式。純文字輸出可與其他以文字為基礎的工具相容。 對於延伸指令，您可以指定以 XML 和 HTML 輸出。

• 說明 – CLI 指令的線上說明可從 CLI 中取得。

您可以使用 CLI 執行以下作業：

• 建立拓樸物件 (如網域、群組和實體)，並擷取有關這些物件的拓樸資訊。

• 擷取和操控受管理物件的屬性。

• 載入、卸載、啟用和停用 Sun Management Center 代理程式上的模組。

• 設定並執行警示動作、擷取警示資訊，以及在 Sun Management Center 代理程式上確認或刪除警示。

---

備註 –

(在 Solaris) 您可以使用參數檔自動登入主控台。若參數檔包含使用者名稱和密碼，該檔案的權限一定是 400。否則，就不能透過 CLI 自動登入。

---

系統需求

您可以在下列其中一個系統配置上從使用者終端機階段作業存取 CLI：

• UNIX® 工作站，執行 Solaris 2.6、Solaris 7、Solaris 8、Solaris 9 或 Solaris 10 版本的 Solaris 作業系統。

• UNIX 工作站，執行 Red Hat，SuSE/JDS Linux 核心版本 2.4 和 2.6。

• 個人電腦，執行 Windows 98、Windows 2000、Windows XP 或 Windows NT

CLI 互動模式

CLI 支援下列兩種互動模式：

• 階段作業模式 – 階段作業模式為互動模式。登入 Sun Management Center 伺服器之後，您便可以輸入指令並接收輸出，直到您明確登出該伺服器為止。

• 批次模式 – CLI 連接至伺服器並執行 filename 中包含的指令，其中 filename 為包含 CLI 指令的檔案名稱。

配置 CLI 批次模式

CLI 批次模式可以藉由修改位於 /opt/SUNWsymon/cli 的 cli.properties 檔來進行配置。此檔包含九個配置參數。

表 20–1 說明配置參數。

表 20–1 配置 CLI 批次模式的參數

參數	說明	預設值
process_time_out	到達時間時，CLI 後端程序將會從系統移除。	Process time-out 24 hrs process_time_out = 86400 (in seconds)
uds_dgram_wait_time	DGRAM 用戶端將會等待來自 CLI 後端程序的回應。若用戶端沒有在指定時間內收到回應，就會顯示錯誤訊息「Error receiving data from Backend」。	UDS DGRAM wait time in seconds uds_dgram_wait_time = 300
uds_stream_wait_time	STREAM 用戶端將會等待來自 CLI 後端程序的回應。若用戶端沒有在指定時間內收到回應，就會顯示錯誤訊息「Error receiving data from Backend」。	UDS STREAM wait time in seconds uds_stream_wait_time = 180
out_file	此檔包含目前執行的 CLI 後端程序詳細資訊。此檔的格式是   <user>:<hostname>:<C Process ID>:<Java Process ID>	User & process information file out_file = /var/opt/SUNWsymon/cli/process-file
socket_pathclnt	此檔包含用戶端代理程式 UDS 檔的路徑。已處理之 CLI 指令的輸出會傳送到此檔。	Path to uds file socket_pathclnt = /var/opt/SUNWsymon/cli/broker_uds_client_file
cli_log_path	此檔包含 CLI 記錄檔的路徑。	Location of CLI log file cli_log_path = /tmp/sunmclog/cli
cli_log_file	CLI 記錄檔名稱。	Location of backend(broker) log file cli_log_file = /tmp/sunmclog/cli/cli-batch-mode-log
uds_file_path	此路徑包含 STREAM 和 DGRAM UDS 檔的位置。	Path of the uds files uds_file_path = /var/opt/SUNWsymon/cli/
log_level	指定要使用的記錄層級。將生產環境的記錄層級設為 ERROR。將除錯環境的記錄層級設為 INFO。	Batch mode log level [options : INFO|ERROR] log_level=ERROR

CLI 指令與參數簡介

本節提供 CLI 指令與參數的簡介。

CLI 指令簡介

CLI 指令可以區分為兩種類型：基本指令和延伸指令。

• 基本指令是修改其他 CLI 指令執行環境的指令。您可以使用基本指令設定參數值、定義指令別名、檢查指令狀況或者登入與登出伺服器。基本指令一律在前景執行。

• 延伸指令是詢問或修改受管理物件的拓樸及其屬性的指令。您可以使用延伸指令執行數種功能：

  • 在受管理物件拓樸中定位受管理物件

  • 啟用或停用模組

  • 認可或刪除警報

  依預設，延伸指令在背景執行。您可以將延伸指令配置為在前景執行。

在階段作業模式中，指令既可在前景執行，也可在背景執行。

• 前景 – 在前景執行的指令執行完成。這些指令會將其輸出直接傳送至螢幕，除非另外重新導向。每次僅可在前景執行一個指令。基本指令僅能在前景執行。依據預設，延伸指令是在背景執行，但是可以將其配置為在前景執行。

• 背景 – 在背景執行的指令會非同步執行，並且依據預設不會向螢幕傳送任何輸出或診斷訊息。輸出將被緩衝，並可稍後根據明確請求顯示。與 UNIX shell 不同，每次僅可在背景執行一個延伸指令。當該指令在背景執行時，可在前景執行任何數量的基本指令。依據預設，延伸指令是在背景執行，但是您可以指定延伸指令在前景執行。基本指令不能在背景執行。

CLI 同時也支援別名的使用。您可以為比較複雜的指令及其參數定義縮寫或別名。使用者定義的別名在不同的 CLI 階段作業中均可使用。

CLI 參數簡介

CLI 參數是一對名稱值：每個參數都有一個名稱和一個值。某些參數是 CLI 內建參數。它們的名稱和值的涵義都在 CLI 中預先定義。您可以定義其他參數，也稱為變數。某些參數在範圍上是屬於全域參數。全域參數會影響在特定階段作業中執行的所有 CLI 指令的執行。其他參數是某個指令或指令群組所特有的。

輸入與輸出功能

CLI 可提供數種輸入與輸出功能。

• 輸入

  • 在階段作業模式中，CLI 可從鍵盤互動地接受指令。　

  • 在批次模式中，CLI 可執行包含在 CLI 指令檔中的指令，該檔案的名稱是指定在 shell 指令行上。

• 輸出

  • 若為基本指令，輸出會依據預設顯示在螢幕上。

  • 若為延伸指令，輸出會依據預設在背景中緩衝，直到您請求輸出為止。

  • 基本和延伸指令的輸出均可重新導向到您指定的檔案。

  • 指令和參數可以儲存在記錄檔中，稍後可將該記錄檔以批次模式輸入至 CLI。

    ---

    備註 –

    若要將記錄檔以批次模式輸入至 CLI，您必須編輯該檔案。移除記錄檔中實際指令及參數前面出現的時間戳記和所有訊息。

    ---

• 格式

  • 您可以指定輸出顯示的行數。

  • 對於多欄位輸出，您可以指定要顯示的欄位。

  • 除純文字輸出以外，您可以為某些指令指定 XML 和 HTML 輸出。

CLI 指令說明

CLI 可為每個 CLI 指令提供線上說明。CLI 說明可從 CLI 中取得。CLI 輔助說明無需 GUI。對於每個指令，說明均提供指令用法對照表和與該指令相關的參數清單。