Sun Management Center 3.6.1 使用者指南

拓樸延伸指令

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

拓樸指令參數

下列參數可被延伸指令用來管理拓樸:如需關於 a 和 t 參數的詳細資訊,請參閱預先定義的參數和旗標。

agentPort

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

arch

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

domain

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

domainmode

domainmode 參數的值可以是 follow 或 ignore。若值為 follow,import 指令則會從檔案將群組和網域資訊匯入到指定的目標網域。若值為 ignore,則 import 指令會忽略網域資訊。

family

family 參數的值是拓樸物件的物件系列。若未指定,則將會自動取得。

filename

filename 參數的值是檔案名稱。此參數是被 export 和 import 指令用來匯出和匯入拓樸資料。

fullDesc

fullDesc 參數值為所建立實體或群組的文字描述。

isPolled

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

mode

mode 參數的值可以是 append 或 overwrite。若值為 append,export 指令會將拓樸資料加到檔案末端。若值為 overwrite,export 指令會使用拓樸資料覆寫檔案。

nodemode

nodemode 參數的值可以是 replace 或 ignore。若在檔案和網域中有資料不相符,replace 值會以檔案中的資料取代網域中的資料。ignore 值會忽略資料的不相符。

pollType

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

  • agroup – 識別使用中代理程式安裝並執行的群組

  • 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
validity

validity 參數的值是您要匯出之拓樸資料有效的期間 (以日為單位)。 validity 參數的值可以為 Unlimited、7、15、30 或 90。

writeInfo

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

拓樸指令

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

createEntity

說明

createEntity 指令可以建立受管理實體。

語法

createEntity t=topoObject pollType=ahost|amod|aprox|dummy|ping|snmp [fullDesc=text] [targetHost=host] [agentPort=port] [targetIp=ip] [family=family] [isPolled=true|false] [topoType=text] [topoCfg=text] [readInfo=text] [writeInfo=text] [url=url]

參數

t、pollType、fullDesc、targetHost、agentPort、targetIp、family、isPolled、topoType、topoCfg、readInfo、writeInfo 和 url。

若已指定url 或 agentPort 參數,就不會使用預設連接埠 161。

createGroup

說明

createGroup 指令可建立拓樸網域或群組。

語法

createGroup t=topoObject [family=base|building-view|campus-view|network-view|subnetwork-view] [fullDesc=desc]

參數

t、family 和 fullDesc。

若建立的實體為群組,family 參數就是必要的。

若建立的實體是網域,就會忽略 family 和 fullDesc 參數。

delTopoObject

說明

delTopoObject 指令會刪除受管理拓樸階層結構中的受管理拓樸物件。同時將刪除指定拓樸物件下面的所有物件。

語法

delTopoObject t=topoObject

參數

t

export

說明

export 指令會將網域的拓樸資料匯出到檔案中。

語法

export filename=filename domain=domain|"All Domains" mode=append|overwrite validity=Unlimited|7|15|30|90 [comment=text]

參數

filename、domain、 mode、validity 和 comment。

getAgentPort

說明

getAgentPort 指令可傳回在拓樸領域中指定的主機上執行的 Sun Management Center 代理程式的連接埠號。如果有多個代理程式,將會傳回連接埠號清單。

語法

getAgentPort a=host[,host]* [t=topoObject]

參數

a 和 t。

若未指定 t 參數,就會使用預設網域。

getAllTopoObjects

說明

getAllTopoObjects 指令會傳回符合 arch、family 或 pollType 參數指定之情況的受管理拓樸階層結構中的所有受管理物件清單。

語法

getAllTopoObjects t=topoObject [arch=os] [family=platform] [pollType=aview|ahost|amod|aprox|dummy|ping|snmp]

參數

t、arch、family 和 pollType。

getCurrentDomain

說明

getCurrentDomain 指令會傳回目前網域名稱。

語法

getCurrentDomain

參數

無

getDomains

說明

getDomains 指令會傳回目前伺服器環境中所有受管理網域的清單。

語法

getDomains

參數

無

getTopoObject

說明

getTopoObject 指令會直接傳回由 t 參數指定之符合 arch、 family 或 pollType 參數指定情況的拓樸物件下的受管理拓樸物件清單。

語法

getTopoObject t=topoObject [arch=os] [family=platform] [pollType=aview|ahost|amod|aprox|dummy|ping|snmp]

參數

t、arch、family 和 pollType。

import

說明

export 指令可以從檔案將拓樸資料匯入到網域。

語法

import filename=filename domainmode=follow|ignore nodemode=replace|ignore [domain=domain]

參數

filename、domainmode、 nodemode 和 domain。

setCurrentDomain

說明

setCurrentDomain 指令可將主網域設定為 domain 參數中指定的值。

語法

setCurrentDomain domain=domainName

參數

domain

拓樸指令範例

以下指令可傳回執行 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 上執行代理程式的主機。


> 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