Sun Management Center 3.6.1 用户指南

拓扑扩展命令

有九个用于管理拓扑的扩展命令。

拓扑命令参数

扩展命令可将以下参数用于拓扑。有关 at 参数的详细信息,请参阅预定义的参数和标记

agentPort

agentPort 参数的值表示代理的端口号。如果未指定 agentPort 参数,将使用缺省值 161。agentPort 参数是可选的。仅当未指定 url 参数且不需要缺省端口时才指定此参数。

arch

arch 参数的值表示拓扑对象的体系结构。

domain

domain 参数的值是您必须为 setCurrentDomain 命令指定的 Sun Management Center 域的名称。

domainmode

domainmode 参数的值可以是 followignore。如果该参数的值为 followimport 命令会将文件中的组和域信息都导入到指定的目标域内。如果该参数的值为 ignoreimport 命令将忽略有关域的信息。

family

family 参数的值表示拓扑对象的对象系列。如果没有进行指定,将自动获取该参数的值。

filename

filename 参数的值表示文件的名称。exportimport 命令使用该参数导出和导入拓扑数据。

fullDesc

fullDesc 参数的值表示正在创建的实体或组的文本说明。

isPolled

isPolled 参数的值可以是 truefalse。如果值为 true,则实体根据轮询类型 (pollType) 轮询状态信息。默认值为 true

mode

mode 参数的值可以是 appendoverwrite。如果该参数的值为 append,则 export 会将拓扑数据添加到文件的末尾。如果该参数的值为 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]

参数

tpollTypefullDesctargetHostagentPort targetIpfamilyisPolled topoTypetopoCfgreadInfo writeInfourl

如果指定了 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]

参数

文件名模式有效性注释

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

拓扑命令示例

以下命令用于返回所有 Sun Management Center 代理主机的列表,这些代理主机位于运行 SunOS 5.7 软件的 menlo_park 域的 building12 组中的 sun4u 族:


> 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

以下命令将创建名为 myHost 的被管理实体,该实体位于 test_domain 域的 building12 组中。拓扑对象是一个在端口 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