Sun Management Center 3.6 使用者指南

拓樸延伸指令

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

拓樸指令參數

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

agentPort

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

arch

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

domain

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

domainmode

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

family

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

filename

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

fullDesc

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

isPolled

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

mode

mode 參數的值可以是 appendoverwrite。若值為 appendexport 指令會將拓樸資料加到檔案末端。若值為 overwriteexport 指令會使用拓樸資料覆寫檔案。

nodemode

nodemode 參數的值可以是 replaceignore。若在檔案和網域中有資料不相符,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 參數的值可以為 Unlimited7153090

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]

參數

tpollTypefullDesctargetHostagentPorttargetIpfamilyisPolledtopoTypetopoCfgreadInfowriteInfourl

若已指定urlagentPort 參數,就不會使用預設連接埠 161

createGroup

說明

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

語法

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

參數

tfamilyfullDesc

若建立的實體為群組,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]

參數

filenamedomain modevaliditycomment

getAgentPort

說明

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

語法

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

參數

at

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

getAllTopoObjects

說明

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

語法

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

參數

tarchfamilypollType

getCurrentDomain

說明

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

語法

getCurrentDomain

參數

getDomains

說明

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

語法

getDomains

參數

getTopoObject

說明

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

語法

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

參數

tarchfamilypollType

import

說明

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

語法

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

參數

filenamedomainmode nodemodedomain

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