test

Sun Management Center 3.5 使用者指南

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