延伸 CLI 指令

以下章節將說明在 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