拓樸延伸指令

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

拓樸指令參數

以下參數可以用於拓樸延伸指令。如需有關 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