Topology Commands

There are nine extended commands for managing topology.

createEntity

Description

The createEntity command creates a managed entity.

Syntax

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]

Parameters

t, pollType, fullDesc, targetHost, agentPort, targetIp, family, isPolled, topoType, topoCfg, readInfo, writeInfo, and url.

If the url or agentPort parameters are specified, the default port of 161 is not used.

createGroup

Description

The createGroup command creates a topology domain or group.

Syntax

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

Parameters

t, family, and fullDesc.

If the entity being created is a group, the family parameter is mandatory.

If the entity being created is a domain, the family and fullDesc parameters are ignored.

delTopoObject

Description

The delTopoObject command deletes a managed topology object in the managed topology hierarchy. All objects under the specified topology object are deleted as well.

Syntax

delTopoObject t=topoObject

Parameter

t

export

Description

The export command exports topology data in a domain or domains to a file.

Syntax

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

Parameters

filename, domain, mode, validity, and comment.

getAgentPort

Description

The getAgentPort command returns a port number of the Sun Management Center agent running on the specified host in a topology domain. If there are multiple agents, a list of port numbers is returned.

Syntax

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

Parameters

a and t.

If the t parameter is not specified, the default domain is used.

getAllTopoObjects

Description

The getAllTopoObjects command returns a list of all managed objects in the managed topology hierarchy that satisfy conditions specified by the arch, family, or pollType parameters.

Syntax

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

Parameters

t, arch, family, and pollType.

getCurrentDomain

Description

The getCurrentDomain command returns the name of the current domain.

Syntax

getCurrentDomain

Parameters

None

getDomains

Description

The getDomains command returns a list of all managed domains in the current server context.

Syntax

getDomains

Parameters

None

getTopoObject

Description

The getTopoObject command returns a list of managed topology objects directly under the topology object specified by parameter t that satisfy conditions specified by the arch, family, or pollType parameters.

Syntax

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

Parameters

t, arch, family, and pollType.

import

Description

The export command imports topology data from a file to a domain.

Syntax

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

Parameters

filename, domainmode, nodemode, and domain.

setCurrentDomain

Description

The setCurrentDomain command sets the home domain to the value specified in the domain parameter.

Syntax

setCurrentDomain domain=domainName

Parameter

domain