test

Sun Management Center 3.5 使用者指南

第 20章 使用指令行介面

Sun Management Center 指令行介面 (CLI) 是一種輕量級的字元從動式主控台，是除 Jave 和 Web 主控台圖形介面以外的另一種可以監視和管理系統的主控台。

本章討論主題如下：

Sun Management Center CLI 概觀

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

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

系統需求

您可以從具有以下系統配置之一的使用者終端階段作業存取 CLI：

CLI 互動模式

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

CLI 指令與參數概觀

本節提供 CLI 指令與參數的概觀。

CLI 指令概觀

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

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

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

CLI 參數概觀

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

輸入與輸出功能

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

CLI 指令輔助說明

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

CLI 參數

大多數 CLI 參數為名稱 - 值組：每個參數均具有名稱和值。少數參數僅有名稱，沒有值。這些參數稱為旗標。

參數範圍

您可以在 CLI 階段作業中的多個位址指定參數值：

參數語法

參數被指定為 name=value 組：

file=/home/examples/example1

其中，參數 name 是 file，參數 value 是 /home/examples/example1。請勿在等號 (=) 與參數名稱或參數值之間加入空白。如果值中包含空白（如空格或定位字元），則該值必須以雙引號字元（ASCII 字元 0x22）括住：

moduleDesc="Local File Scanning"

參數值可以是以逗號分隔的值的清單。請勿在逗號分隔的值之間加入空白，如以下範例所示。

severity=DIS,DWN,ERR

參數清單是以空白分隔的參數序列，如以下範例所示。

m=kernel-reader moduleDesc="My Kernel Reader"

可接受的和不可接受的參數語法範例

以下參數具有可接受的語法：

ok1="This is just a test"
ok2=hello
ok3=hello,hi,aloha
ok4="hello,hi,aloha"

以下參數不具有可接受的語法：

broken1="How are you?","Who are you?"
broken2="Testing",1,2,3
broken3="Hello
broken4=Hello"

參數輸入檔案格式

參數可以儲存在檔案中並在需要時讀取。您可以依需要建立任意多個參數檔案。使用內建 i 參數指定所需參數輸入檔案的名稱。

預先定義的參數和旗標

本節說明 CLI 中具有預先定義意義的參數。

註解 –

有些預先定義的參數具有單字母名稱。範例包括 a、f 和 o。這些是正確的參數名稱，而非錯誤。

-b

如果旗標包含在 UNIX 指令行上，則啟動 CLI 時，該旗標將指示 CLI 以批次模式執行。該旗標在階段作業模式中將被忽略。

-h

當該旗標用作階段作業模式中指令的參數時，它將指示 CLI 顯示該指令的輔助說明文字。

-l

該旗標的名稱為小寫字母 l（ASCII 字元 0x6c），而非數字 1（ASCII 字元 0x31）。當該旗標用作階段作業模式中延伸指令的參數時，它將指示 CLI 在執行目前指令時保留最近延伸指令的參數。如果已指定 -l 旗標，則為目前指令指定的任何其他參數均被忽略。該旗標對基本指令不起作用。以下範例說明 -l 旗標的用法：


> getLoadModules a=myHostName
...
...
> getAlarms -l

當 getAlarms 指令執行時，該指令使用先前執行的 getLoadModules 指令中參數 a (myHostName) 的值。

a

a 參數的值是代理程式，可將此值指定為代理程式主機和（可選）連接埠號。如果您要指定連接埠號，請使用冒號 (:) 將該號碼與主機名稱隔開。一般語法為 a=agentHost[:agentPort] 。例如，若要指定在主機 example_host 上執行並收聽連接埠 12345 的代理程式，您可以使用以下語法：


a=example_host:12345

a 參數的值也可以是以逗號分隔的代理程式設定清單：a=agent[, agent]+。

append

append 參數的值是將指令的輸出附加到其中的檔案名稱。如果該檔案不存在，會建立該檔案。如果您將 append 參數設定為通用參數，則該階段作業的所有指令輸出都將附加到指定的檔案中。您還可以為特定指令設定該參數，如以下範例所示。


append=/home/examples/cli_output

如果 append 和 o 參數均已設定，則 append 優先於 o。僅有指令結果會被記錄在指定檔案中。並不記錄實際指令。使用 log 參數可記錄指令資訊。

columns

columns 參數的值是指要透過 print 指令顯示的一個或多個指令輸出欄位的名稱。欄位名稱區分大小寫。多個欄位名稱以逗號隔開。以下範例使用了數個欄位名稱。


columns="Alarm Id,Node URL,Target Host,Severity"
f

f 參數的值決定指令輸出的格式。目前的格式為 plain 和 html。請參閱指令輸出格式，以取得更多資訊。若要將格式設定為 HTML，請使用以下語法：


f=html
height

height 參數的值是要顯示在螢幕上的指令輸出的行數。以下範例將高度設定為大約等於標準終端螢幕的高度：


height=24
i

i 參數的值是輸入檔案的名稱，該檔案中包含目前階段作業中要包括的參數定義。在輸入檔案中，每個參數定義均應位於單獨的行上。例如，假定以下各行位於檔案 /home/examples/myParams 中：


more=off
serverHost=myserver
a=myagent:161

您可以使用以下行將這些參數包括在目前 CLI 階段作業中：


i=/home/examples/myParams
log

log 參數的值是記錄所有 CLI 指令及指令執行時間的檔案名稱。請注意，日誌檔僅記錄指令名稱和執行時間。指令輸出記錄在由 a 或 o 參數指定的檔案中。設定該參數之後，後續執行的所有指令都會附加至該檔案中。如果該檔案不存在，會建立該檔案。因為日誌檔在記錄開啟時不會被覆寫，因此如果您想獲取不同的日誌，請確定指定不同的檔案。若要關閉記錄，請 unset（取消設定）log 參數。以下範例先開啟日誌，然後停止日誌。


> log=/home/examples/sunmc-log
...
...
> unset log
m

m 參數的值是 Sun Management Center 模組的名稱。該值也可以是以逗號分隔的模組清單。


m=kernel-reader
more

more 參數的值可控制顯示器上指令輸出的分頁。可能的值為 on 和 off。如果將 more 設定為 on，則輸出至終端的所有後續輸出都將一次顯示在一個畫面上。 畫面的大小由高度和寬度參數定義。批次模式的預設值為 off，階段作業模式的預設值為 on。


more=on
o

o 參數的值是指令輸出所寫入檔案的名稱。如果該檔案存在，則覆寫該檔案。您可以透過將 o 參數指定給特定指令， 使用 o 參數捕捉指令的輸出。您還可以使用 set 指令將該參數設定為通用參數，以將所有後續輸出寫入檔案。

如果 append 和 o 參數均已設定，則 append 優先於 o。輸出會附加至指定的檔案。僅有指令輸出會被寫入該檔案。 並不記錄實際指令。使用 log 參數可記錄指令資訊。以下範例定義指令輸出所寫入的檔案。


o=/home/examples/sunmc-output
serverHost

serverHost 參數的值決定 CLI 登入時連接的伺服器主機。一旦 CLI 連接至伺服器，該通用參數將無法變更。

serverPort

serverPort 參數的值是登入的伺服器連接埠。建立登入階段作業之後，該通用參數將無法設定。如果未設定該參數，則使用預設連接埠 2099。

t

t 參數的值是拓樸代理程式中受管理物件的名稱。物件可以是領域、檢視群組或實體。物件名稱是以領域開頭的完整名稱，例如 /domain/group/host。

CLI 指令

請參閱CLI 指令與參數概觀，以取得指令類型和概念的概觀。

基本 CLI 指令

以下清單說明基本 CLI 指令。

alias

使用 alias 指令可為經常使用的指令或具有複雜參數的指令建立別名。別名不能與現有的 CLI 指令同名。別名定義中的空白必須用雙引號（"， ASCII 字元 0x22）括住。以下範例先顯示一個簡單的 alias 指令，再顯示一個較為複雜的 alias 指令。


> alias assign=set
> alias alarms="getAlarms severity=dwn"

如果不帶引數呼叫，alias 指令可列出已定義的別名及其值的清單。以下範例顯示 alias 指令不帶引數呼叫的結果。


> alias
assign - set
alarms - getAlarms severity=dwn
clear

clear 指令可從目前階段作業移除所有參數。該指令與 unset 指令相似，但是無需參數名稱作為引數。

exit

exit 指令可切斷與伺服器的連接並結束 CLI 階段作業。

註解 –

exit 指令和 quit 指令完全相同。

help

help 指令可顯示關於 CLI 指令及其參數的資訊。輔助說明資訊適合於顯示在非點陣終端螢幕上。如果不帶引數執行 help，輔助說明可按字母順序顯示可用 CLI 指令的清單及簡短說明。首先列出基本指令，然後再列出延伸指令。當以 CLI 指令名稱作為引數呼叫 help 時，help 可列出針對該指令的資訊。以下範例顯示 getAlarms 指令的輔助說明。


> help getAlarms
getAlarms [a=host[,host]+] [alarm_filter_list]
 - 基於一組過濾條件，取得有關代理程式或代理程式群組的警報資訊。
如果未提供代理程式，將取得所有警報。所有過濾條件均可進行邏輯與運算，
以產生所需結果。
alarm_filter_list 中指定的過濾條件包括：
  domain=domain and/or
  m=module[+instance] and/or
  managed_object=managed_object and/or
  property=property and/or
  property_instance=property_instance and/or
  qualifier=qualifier and/or
  severity=[DIS,DWN,ERR,OFF,INF,IRR,WRN] and/or
  state=[C,F,O] and/or
  ack=[A,N]
kill

kill 指令可結束所有在背景執行的指令。

login

login 指令可與 Sun Management Center 伺服器建立連接。您可以指定 serverHost 和 serverPort（可選）參數作為引數。 如果未指定主機，則會提示您輸入主機。login 指令還會提示您輸入使用者名稱和密碼。

logout

logout 指令可結束與 Sun Management Center 伺服器的連接，但並不結束 CLI 階段作業。

more

more 指令可顯示您為控制指令輸出至螢幕的格式而所設參數的輔助說明資訊。請參考預先定義的參數和旗標中預先定義參數 height 和 more 的說明，以取得其他資訊。

print

print 指令可以以指定的格式將上一延伸指令的輸出導向至指定目標。依預設，print 以純文字格式將此輸出導向至終端螢幕。如果已設定參數 a 或 o，則將輸出導向至這些參數指定的檔案中。該輸出不會顯示在螢幕上。

註解 –

print 指令不會儲存在指令歷程中。

quit

quit 指令可切斷與伺服器的連接，並結束 CLI 階段作業。

註解 –

exit 指令和 quit 指令完全相同。

reset

reset 指令可將在指令行上指定的所有參數值復原為 CLI 階段作業開始時指定的值。在階段作業期間而不是在指令行上定義的參數保持不變。如果將特定參數名稱作為引數提供給 reset，並且該參數是在指令行上被指定的，則該參數的值將被復原至原始值。否則，該參數的值保持不變。

註解 –

reset 指令不會儲存在指令歷程中。

set

set 指令可讓您指定參數值或顯示參數值。使用 set 指令指定其值的參數對於目前階段作業通用。在該階段作業期間，通用指令可用於所有指令。如果不帶引數執行 set，則會顯示目前階段作業期間定義的所有參數的值。如果帶有指定為引數的參數執行 set，則會顯示該參數的值。以下範例顯示該指令的所有三種變化形式。


> set height=10
> set
height=10
> set height
height=10
status

status 指令可顯示在背景執行的所有指令的狀態。

unalias

unalias 指令可移除指定為引數的別名。

unset

unset 指令可從目前階段作業中移除指定的參數。

註解 –

unset 指令不會儲存在指令歷程中。

延伸 CLI 指令

以下章節將說明在 CLI 中可用的數種類型的延伸指令：

模組延伸指令

有七個延伸指令可用於管理模組。如需有關 a、m、 f 和 columns 參數的詳細資訊，請參閱預先定義的參數和旗標。

模組指令

disableModule

停用代理程式中的模組。disableModule 指令具有以下參數： a 和 m

enableModule

啟用代理程式中的模組。enableModule 指令具有以下參數： a、f、m 和 columns。

getLoadedModules

取得代理程式中載入模組的清單。getLoadedModules 指令具有以下參數： a、f 和 columns。

getModule

取得特定模組的資訊。getModule 指令具有以下參數： a、f、m 和 columns。

getModules

取得代理程式中的模組清單。getModules 指令具有以下參數： a、f 和 columns。

loadModule

載入代理程式中的模組。loadModule 指令具有以下參數： a、f、m 和 columns。

loadModule 指令還可以具有兩個附加參數： moduleName，國際化的模組名稱；moduleDesc，該模組的文字說明。

unloadModule

卸載代理程式中的一個或多個模組。unloadModule 指令具有以下參數： a、f、m 和 columns。

模組指令範例

若要決定將哪個模組載入到 agentHost 名稱為 seattle 的主機，您應在 CLI 提示符號處鍵入以下指令：


> getLoadedModules a=seattle

若要將 kernel-reader 模組載入在連接埠 1776 的主機 seattle ，您應該鍵入以下指令：


> loadModule a=seattle:1776 m=kernel-reader

物件屬性延伸指令

有四個延伸指令可用於管理物件屬性及屬性值。

物件屬性指令的參數

物件屬性指令可以使用以下參數。如需有關 a、m、 f 和 columns 參數的詳細資訊，請參閱預先定義的參數和旗標。

mgtObj

mgtObj 參數的值是其屬性已被設定或擷取的受管理物件的名稱。

property

property 參數的值是其屬性和值已被設定或擷取的屬性的名稱。

propInst

propInst 參數的值是其屬性和值已被指定或擷取的屬性實例的名稱。

rowValues

rowValues 參數的值是以逗號分隔的名稱 - 值組清單。name 是列中欄位的名稱。value 是該欄位中的值。

attributes

attributes 參數的值是以逗號分隔的屬性名稱清單，這些屬性名稱屬於其屬性和值已被設定或擷取的屬性。當與 setAttributes 指令配合使用時，attributes 參數中的每個屬性名稱在 values 參數中均必須具有對應的值。

values

values 參數的值是以逗號分隔並對應於 attributes 參數中指定屬性的值清單。當與 setAttributes 指令配合使用時，每個指定的屬性均必須有值。

物件屬性指令

您可以使用以下指令設定與擷取物件屬性及屬性值：

addRow

addRow 指令可向表格中新增列。addRow 指令具有以下參數： a、m、mgtObj、property、propInst 和 rowValues。

delRow

delRow 指令可從表格中刪除列。delRow 指令具有以下參數： a、m、mgtObj、property、propInst 和 rowValues。

getAttributes

getAttributes 指令可從代理程式或代理程式群組中擷取指定屬性。getAttributes 指令具有以下參數： a、f、m、columns、 mgtObj、property、propInst 和 attributes。

setAttributes

setAttributes 指令可為代理程式或代理程式群組中的指定屬性指定值。setAttributes 指令具有以下參數： a、m、mgtObj、property、propInst、attributes 和 values。

對於在 attributes 參數中指定的每個屬性，values 參數中必須有對應的值。

物件屬性指令的範例

以下指令可擷取主機 haiku 連接埠 1161 上的 agent-stats 模組中 totalstats 受管理物件之 size 屬性的全部屬性：


> getAttributes a=haiku:1161 m=agent-stats mgtObj=totalstats \
property=size

以下指令可將先前範例中指定的 size 屬性中的屬性alarmlimits.error-gt 設定為值 2：


> setAttributes a=haiku:1161 m=agent-stats mgtObj=totalstats \
property=size attributes=alarmlimits.error-gt values=2

以下指令可從 mgtObj 中指定的受管理物件中刪除在 rowValues 中指定的列：


> delRow a=haiku:1161 \
m=filemon mgtObj=filemonstats/filemonTable/filemonEntry \
rowValues="name=test,desc=this,filename=/etc/passwd"

警報延伸指令

有五個延伸指令可用於管理警報。

警報指令參數

以下參數可以用於警報延伸指令。如需有關 a 和 m 參數的詳細資訊，請參閱預先定義的參數和旗標。

ack

ack 參數的值是以逗號分隔並表示受管理警報是否已被認可的值的清單。ack 參數的合法值是 A（已認可）和 N（未認可）。

command

command 參數的值是要執行的警報動作。

domain

domain 參數的值是要管理其警報的 Sun Management Center 領域的名稱。如果未指定領域，則使用「預設領域」。

managed_object

managed_object 參數的值是要管理其警報的受管理物件的名稱。

note

note 參數的值是正在執行的指令的文字註解。

property

property 參數的值是要管理其警報的屬性的名稱。

property_instance

property_instance 參數的值是要管理其警報的特定屬性實例的名稱。

qualifier

qualifier 參數的值是與要管理其警報的受管理屬性相關的限制器的名稱。

severity

severity 參數的值是以逗號分隔的受管理警報的嚴重程度值的清單。severity 參數允許使用以下值：

  • ERR — 錯誤

  • WRN — 警告

  • INF — 提供資訊

  • IRR — 不合理

  • DWN — 當機

  • DIS — 已停用

  • OFF — 關閉

state

state 參數的值是以逗號分隔的受管理警報的狀態值的清單。狀態參數的合法值為 O（開啟）或 C（關閉）。

警報指令

您可以使用以下指令檢查警報值和設定警報動作：

ackAlarms

ackAlarms 指令可認可代理程式或代理程式群組中的警報。ackAlarms 指令具有以下參數： a、ack、columns、domain、f、m、managed_object、 note、property、property_instance、qualifier、severity 和 state。

如果沒有為 state 參數指定值，則 state 預設為 O（開啟）。

delAlarms

delAlarms 指令可刪除代理程式或代理程式群組中的警報。delAlarms 指令具有以下參數： a、ack、columns、domain、f、m、managed_object、 note、property、property_instance、qualifier、severity 和 state。

如果沒有為 state 參數指定值，則 state 預設為 C（關閉）。

getAlarms

getAlarms 指令可擷取代理程式或代理程式群組中的警報資訊。getAlarms 指令具有以下參數： a、ack、columns、domain、f、m、managed_object、 property、property_instance、qualifier、severity 和 state。

如果未指定任何參數，getAlarms 可傳回所有警報資訊。

runAlarmAction

runAlarmAction 指令可在代理程式或代理程式群組中執行手動或延遲的警報動作。runAlarmAction 指令具有以下參數： a 和 domain

setAlarmAction

setAlarmAction 指令可在代理程式或代理程式群組中，為現有警報設定手動或延遲的警報動作。setAlarmAction 指令具有以下參數：a、command 和 domain。

警報指令範例

以下指令可從主機 haiku 中擷取所有嚴重程度為 ERR 或 DWN 的警報： 


> getAlarms a=haiku severity=ERR,DWN

拓樸延伸指令

有九個延伸指令可用於管理拓樸。

拓樸指令參數

以下參數可以用於拓樸延伸指令。如需有關 a、columns、f 和 t 參數的詳細資訊，請參閱預先定義的參數和旗標。

agentPort

agentPort 參數的值是代理程式連接埠號。如果未指定 agentPort，將使用預設值 161。agentPort 參數為可選。僅在未指定 url 參數並且您不想使用預設連接埠時，才需要指定此參數。

arch

arch 參數的值是拓樸物件的架構。

domain

domain 參數的值是您必須為 setCurrentDomain 指令指定的 Sun Management Center 領域的名稱。

family

family 參數的值是拓樸物件的物件家族。

fullDesc

fullDesc 參數的值是正在建立的實體或群組的文字說明。

isPolled

isPolled 參數的值可以是 true 或 false。如果值為 true，實體可根據輪詢類型 (pollType) 輪詢狀態資訊。

pollType

pollType 參數的值是該實體的輪詢類型。pollType 參數允許使用以下值：

  • ahost – 識別安裝並執行作用中代理程式的主機

  • amod – 識別具有作用中代理程式的模組

  • aprox – 識別正在執行 SNMP 代理模組的代理程式

  • dummy – 識別不受監視的裝置

  • ping – 使用 ICMP ping 指令識別要受監視的主機

  • snmp — 使用 SNMP ping 指令識別要受監視的主機

readInfo

readInfo 參數的值是 SNMP 輪詢物件的 SNMPv1 讀取團體的名稱。

targetHost

targetHost 參數的值是目標主機的名稱。

targetIp

targetIP 參數的值是目標主機的 IP 位址。

topoCfg

topoCfg 參數的值是受管理實體的拓樸形式的配置資訊。

topoType

topoType 參數的值是受管理實體的拓樸形式顯示類型。

url

url 參數的值是要輪詢實體的 URL。url 參數的值可用以下格式指定：

ping://hostname
snmp://hostname:port/oid/#.#.#.#
snmp://hostname:port/[mod,sym]/path
writeInfo

writeInfo 參數的值是 SNMP 輪詢物件的 SNMPv1 寫入團體的名稱。

拓樸指令

有九個延伸指令可用於管理拓樸。

createEntity

createEntity 指令可以建立受管理實體。受管理實體的屬性可用以下參數指定： agentPort 、arch、family、fullDesc、isPolled、 pollType、readInfo、targetHost、targetIP、topoCfg、 topoType、url、columns、 f 和 t。

如果已指定 url 或 agentPort 參數，則不會使用預設連接埠 161。

createGroup

createGroup 指令可建立拓樸領域或群組。如果正在建立的實體為群組，則使用以下參數指定群組屬性： family 和 fullDesc。createGroup 指令還具有以下參數： columns、f 和 t。

如果正在建立的實體為領域，則將忽略 family 和 fullDesc 參數。

delTopoObjects

delTopoObjects 指令可刪除受管理拓樸階層結構中的受管理拓樸物件。同時將刪除指定拓樸物件下面的所有物件。delTopoObjects 指令具有以下參數： columns、f 和 t。

getAgentPort

getAgentPort 指令可傳回正在拓樸領域中指定的主機上執行的 Sun Management Center 代理程式的連接埠號。如果有多個代理程式，將會傳回連接埠號清單。getAgentPort 指令具有以下參數： columns、f 和 t。

如果未指定 t，則使用預設領域。

getAllTopoObjects

getAllTopoObjects 指令可傳回符合 arch、family 或 pollType 參數所指定條件的受管理拓樸階層結構中的所有受管理物件的清單。getAllTopoObjects 指令還可具有以下參數： columns、f 和 t。

getCurrentDomain

getCurrentDomain 指令可傳回目前領域的名稱。

getDomains

getDomains 指令可傳回所有受管理領域的清單。

getTopoObject

getTopoObject 指令可在符合 arch、family 或 pollType 參數所指定條件的參數 t 指定的拓樸物件下，直接傳回受管理拓樸物件的清單。getTopoObject 指令還可具有以下參數： columns 和 f。

setCurrentDomain

setCurrentDomain 指令可將起始領域設定為domain 參數中指定的值。

如需有關從 CLI 匯出與匯入拓樸資訊的資訊，請參閱匯入和匯出 CLI 介面。

拓樸指令範例

以下指令可傳回執行 SunOS 5.7 軟體的 menlo_park 領域群組 building12 中 sun4u 家族中所有 Sun Management Center 代理程式主機的清單： 


> getTopoObject t=/menlo_park/building12 pollType=ahost \
arch="SunOS 5.7" family=sun4u

以下指令可在現有名為 headquarters_test 的領域下建立名為 building19 的群組：


> createGroup t=/headquarters_test/building19 \
fullDesc="test headquarters domain" family=building-location

以下指令可在領域 test_domain 的群組 building12 中建立名為 myHost 的受管理實體。該拓樸物件為在連接埠 1161 上執行代理程式的 Sun Ultra-2 主機。


> createEntity t=/test_domain/building12/myHost \
fullDesc="my test host" family=ultra-2 topoType="" \
topoCfg="" isPolled=false pollType=ahost readInfo="" \
writeInfo="" targetHost=osftserv targetIp="" agentPort=1161

CLI 輸出

CLI 提供以下輸出選項：

註解 –

所有指令和日誌檔均為英文。但是，指令說明和輔助說明文字則遵循 Java 國際化的規格，使用除英文之外的語言。

指令輸出格式

基本指令只能以純文字輸出。請參閱CLI 指令與參數概觀，以取得基本指令和延伸指令的說明。

延伸指令可以用兩種格式輸出：

若要指定輸出格式，請將 f 參數設定為所需格式的值。目前支援的值為 plain 和 html。

您可以透過將 height 參數設定為所需的值來定義指令輸出的邏輯畫面大小。您可以設定 more 參數，以每次顯示一個輸出畫面。請參閱預先定義的參數和旗標，以取得這些參數的說明。

範例 20–1 純文字指令輸出

以下範例以純文字顯示 getLoadedModules 指令的部份輸出。


== getLoadedModules: Results 1/16 ===============================
Module Name=Dynamic Reconfiguration
Module Key=dr
Description=Dynamic Reconfiguration (Sunfire)
Agent Name=myhost-dev86
Agent Port=161
Version=2.0
== getLoadedModules: Results 2/16 ===============================
Module Name=Config-Reader(sun4u/sun4d)
Module Key=Config-Reader4u
Description=Config Reader (sun4u/sun4d)
Agent Name=myhost-dev86
Agent Port=161
Version=1.0
...
== getLoadedModules: Results 15/16 ==============================
Module Name=DNS Synthetic Transaction [dns]
Module Key=dnsST+dnstest
Description=DNS Synthetic Transaction
Agent Name=myhost-dev86
Agent Port=161
Version=1.0
================================================================

CLI 日誌檔

若要將 CLI 指令記錄至日誌檔，請將 log 參數設定為要記錄該指令的檔案名稱。日誌檔具有以下格式：

DATE & TIME;duration or message;command and parameters
範例 20–2 部份 CLI 日誌檔

以下範例是先前 getLoadedModules 指令輸出的指令序列記錄的摘錄。

Fri Dec 21 14:15:12 PST 2001;0 second;set o=\
/home/examples/output.3c23b455
Fri Dec 21 14:15:23 PST 2001;0 second;set f=plain
Fri Dec 21 14:15:45 PST 2001;0 second;set a=smtg-dev21
Fri Dec 21 14:16:08 PST 2001;== START OF THREAD ==;getLoadedModules
Fri Dec 21 14:16:08 PST 2001;2 seconds;getLoadedModules
Fri Dec 21 14:16:12 PST 2001;9 seconds;print
Fri Dec 21 14:21:28 PST 2001;== START OF THREAD ==;getAgentPort
Fri Dec 21 14:21:28 PST 2001;0 second;getAgentPort
Fri Dec 21 14:21:31 PST 2001;0 second;print
Fri Dec 21 14:22:01 PST 2001;0 second;exit

CLI 程序

本節說明一些常用的 CLI 程序。

在 Solaris 作業環境中存取 CLI

  1. 若要開始互動階段作業，請鍵入指令 /opt/SUNWsymon/sbin/es-cli 以及任何所需的通用參數。

  2. 在 CLI 提示符號 (>) 處鍵入 login 作為回應。

  3. 在 Host 提示符號處鍵入您希望連接的主機名稱作為回應。

  4. 在 Login 和 Password 提示符號處鍵入您的登入名稱和密碼作為回應。

    步驟 1-4 的結果與以下範例相似：


    /opt/SUNWsymon/sbin/es-cli parameters
> login
主機： myhost
登入：mylogin
密碼：mypassword
登入成功。
>
    提示 –

    您可以將先前準備的 CLI 指令檔案作為輸入，使用以下指令在批次模式中執行 CLI： /opt/SUNWsymon/sbin/es-cli -b file.

在 Microsoft Windows 環境中存取 CLI

  1. 安裝好 Sun Management Center 主控台層後，連按兩下 CLI 資料夾中的 es-cli。

    CLI 畫面即會顯示出來。

  2. 鍵入 login 指令。

    登入程序會提示您指定所需的主機名稱和您的登入名稱。

    在以下範例中，主機為 seattle，登入名稱為 susan：


    > login
主機：seattle
登入： susan
密碼：
>
存取 CLI 線上輔助說明

  1. 若要取得所有可用 CLI 指令的清單，請在 CLI 提示符號處鍵入 help。

  2. 若要取得特定指令的較詳細說明，請鍵入 help 及該指令的名稱。

    例如，若要取得有關 getLoadedModules 指令的其他輔助說明，您應鍵入： 


    > help getLoadedModules
控制指令輸出畫面大小

  1. 透過將 height 參數設定為要顯示的行數來定義畫面大小。

    例如，若要定義 20 行高的畫面，您應鍵入：


    > set height=20

  2. 若要每次檢視一頁輸出，請將 more 參數設定為 on。


    > set more=on
將 CLI 指令記錄至日誌檔

  1. 將 log 參數設定為要在其中記錄指令的檔案名稱。


    > set log=/home/examples/log.3c254030

    一旦設定 log 參數，所有後續指令都將附加到該檔案中。如果該檔案不存在，會建立該檔案。

    由於該檔案不會被覆寫，因此如果您想要一組新記錄，請確定建立新檔案。

  2. 若要停止記錄，請取消設定 log 參數。


    > unset log
將指令輸出記錄至檔案

  1. 若要將指令輸出記錄至檔案，請將 o 參數設定為輸出檔案的名稱。


    > set o=/home/examples/output.3c254030

    若要停止記錄，請取消設定 o 參數。


    > unset o
結束 CLI 階段作業

  1. 若要結束 CLI 階段作業，請鍵入 exit。


    > exit