Sun Management Center 3.6.1 사용 설명서

CLI 명령

명령 유형 및 개념의 개요는 CLI 명령 및 매개 변수 개요를 참조하십시오. 기본 CLI 명령에 의해 사용된 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.

기본 CLI 명령

다음 목록은 기본 CLI 명령을 설명합니다.

alias

설명

alias 명령은 복잡한 매개 변수를 갖고 있는 명령 또는 자주 사용되는 명령에 대한 별칭을 만듭니다. 별칭은 기존 CLI 명령과 같은 이름을 가질 수 없습니다. 별칭 정의에서 공백은 큰따옴표(", ASCII 문자 0x22)로 묶어야 합니다.

사용자가 CLI 세션을 중지하면 사용자가 지정한 별칭은 aliases 디렉토리의 파일에 저장됩니다. 이러한 별칭은 사용자가 CLI 세션에 로그인할 때 사용 가능합니다.

구문

alias [<pseudonym>="command [parameters]"]

예

> alias assign=set
> alias alarms="getAlarms severity=dwn"

인수 없이 호출된 경우, alias 명령은 정의된 별칭 및 해당 값의 목록을 인쇄합니다. 다음은 alias 명령을 인수 없이 호출한 경우의 결과를 보여주는 예입니다.

> alias
assign - set
alarms - getAlarms severity=dwn

attrib

설명

attrib 명령은 토폴로지 개체의 속성을 검색합니다.

구문

attrib [group=groupName [name=attribName] [-key]]

browse

설명

browse 명령은 토폴로지의 검색 모드를 활성화합니다.

구문

browse

cd

설명

cd 명령은 현재 토폴로지 경로를 변경합니다. 지정된 경로가 없는 경우, 현재 경로가 기본 도메인으로 설정됩니다. 번호(n)가 지정된 경우, 현재 경로는 list 명령으로 표시된 대로 n^th 자식 경로로 설정됩니다.

구문

cd [path|number]

clear

설명

clear 명령은 현재 세션 중 설정된 모든 매개 변수를 제거합니다. 그러나, 이 명령은 명령줄에서 설정된 매개 변수를 제거하지 않습니다. 이 명령은 unset 명령과 비슷하지만 인수로서 매개 변수 이름을 필요로 하지 않습니다.

구문

clear

data

설명

data 명령은 토폴로지 개체의 세부 정보를 표시합니다. 번호(n)가 지정된 경우, 경로는 list 명령으로 표시된 대로 n^th 자식 경로로 설정됩니다.

구문

data [path|number|-key]

end

설명

end 명령은 토폴로지의 검색 모드를 비활성화합니다.

구문

end

exit

설명

exit 명령은 서버 연결 및 CLI 세션을 종료합니다.

구문

exit [-onError]

매개 변수

onError

onError 매개 변수는 이전 명령의 실행으로 예외가 발생한 경우 CLI 세션을 종료하는 데 사용됩니다. 이 매개 변수는 일괄 처리 모드에서만 사용됩니다.

주 –

exit 명령 및 quit 명령은 동일합니다.

goto

설명

goto 명령은 대소문자를 구분하는 패턴과 일치하는 토폴로지 경로를 탐색합니다. 두 개 이상의 일치 경로를 찾은 경우, 사용자는 경로를 선택할 것인지 질문을 받습니다.

구문

goto <pattern>

help

설명

help 명령은 CLI 명령 및 해당 매개 변수에 대한 정보를 표시합니다. 도움말 정보는 비트맵되지 않은 터미널 화면에 표시하기에 적절합니다. 인수 없이 help를 실행하는 경우 도움말은 사용 가능한 CLI 명령에 대한 알파벳 목록과 간단한 설명을 표시합니다. 기본 명령이 먼저 나열되고 그 다음에 확장 명령이 나열됩니다.

구문

help [-e][-h] [<command>|about|legal]

매개변수

-e, -h, command, about 및 legal

-e는 확장 모드로 도움말 텍스트를 표시합니다. 다음 형식도 지원됩니다. <command> -e.

-h는 정상 모드로 도움말 텍스트를 표시합니다. 다음 형식도 지원됩니다. <command> -h.

command는 해당 명령에 대한 정보를 표시합니다.

about은 CLI의 버전 정보를 표시합니다.

legal은 CLI의 사용권 조항을 표시합니다.

예제

다음 예는 getAlarms 명령에 대한 도움말을 보여줍니다.

> help getAlarms
getAlarms [a=host[,host]+] [alarm_filter_list]
 - Get alarm information on an agent or a list of agents under a
set of filter conditions. If no agent is provided, all alarms will
be obtained. All the filter conditions are "ANDED" to provide the
result. The filter conditions as specified in alarm_filter_list
comprises:
  domain=domain and/or
  m=module[+instance] and/or
  managed_object=managed_object and/or
  property=property and/or
  property_instance=property_instance and/or
  qualifier=qualifier and/or
  severity=[DIS,DWN,ERR,OFF,INF,IRR,WRN] and/or
  state=[C,F,O] and/or
  ack=[A,N]

history

설명

history 명령은 CLI 세션에서 이전에 입력된 명령을 나열 또는 실행합니다. history 명령이 인수 없이 호출되고 기록이 이전에 설정된 경우, 이전에 입력된 모든 명령이 나열됩니다. history 명령이 숫자 인수와 함께 호출되고 기록이 이전에 설정된 경우, 이 인수와 일치하는 명령이 실행됩니다.

구문

history [num]

kill

설명

kill 명령은 백그라운드에서 실행중인 모든 명령을 종료합니다.

구문

kill

list

설명

list 명령은 경로 아래에 개체를 나열합니다. 번호(n)가 지정된 경우, 이 명령으로 표시된 대로 n^th 자식 경로로 설정됩니다.

구문

list [path|number]

locate

설명

locate 명령은 지정된 패턴과 일치하는 모든 토폴로지 경로를 찾습니다. 패턴은 대소문자를 구분합니다.

구문

locate <pattern>

login

설명

login 명령은 Sun Management Center 서버에 대한 연결을 설정합니다. serverHost를 지정하고 선택적으로 serverPort 매개 변수를 인수로 지정할 수 있습니다. 호스트를 지정하지 않은 경우 호스트를 묻는 메시지가 표시됩니다. 지정된 포트가 없는 경우, 2099가 사용됩니다. login 명령을 실행하는 경우에도 사용자 이름과 암호를 묻는 메시지가 표시됩니다.

구문

login [serverHost=host] [serverPort=portNumber] [user=userName] [password=userPassword]

매개변수

serverHost, serverPort, user 및 password

logout

설명

logout 명령은 Sun Management Center 서버에 대한 연결을 종료하지만 CLI 세션을 종료하지 않습니다.

구문

logout

print

설명

print 명령은 지정된 형식의 마지막 확장 명령의 출력을 지정된 대상으로 안내합니다. 기본적으로 print는 해당 출력을 일반 텍스트 형식의 터미널 화면으로 지정합니다. 매개 변수 append 또는 o를 설정하는 경우 출력은 해당 매개 변수가 지정하는 파일로 지정됩니다. 출력이 화면에 표시되지 않습니다. 지정된 ncols가 없는 경우, 열의 기본 수는 4로 설정됩니다.

주 –

print 명령은 history 명령으로 저장되지 않습니다.

구문

매개변수

f, style, columns, ncols, o 및 append

quit

설명

quit 명령은 서버와의 연결을 끊고 CLI 세션을 종료합니다.

주 –

quit 및 exit 명령 간의 차이가 없습니다.

구문

quit

reset

설명

reset 명령은 명령줄에 지정되는 모든 매개 변수의 값을 CLI 세션이 시작될 때 지정된 값으로 복원합니다. 세션 동안 정의되었지만 명령줄에는 정의되지 않은 매개 변수는 변경되지 않고 그대로 유지됩니다. reset에 대한 인수로서 특정 매개 변수 이름이 제공되고 매개 변수가 명령줄에 지정된 경우 해당 매개 변수의 값은 원래 값으로 복원됩니다. 그렇지 않은 경우 매개 변수의 값은 변경되지 않고 그대로 유지됩니다.

주 –

reset 명령은 history 명령으로 저장되지 않습니다.

구문

reset [<parameter>]*

set

설명

set 명령을 사용하여 매개 변수 값을 지정하거나 매개 변수 값을 표시할 수 있습니다. set 명령으로 값이 지정된 매개 변수는 현재 세션에 대해 전역적입니다. 전역 명령은 해당 세션 동안 모든 명령에서 사용할 수 있습니다. 인수 없이 set를 실행하는 경우 현재 세션 동안 정의된 모든 매개 변수의 값이 표시됩니다. 인수로서 지정되는 매개 변수를 사용하여 set를 실행하는 경우 해당 매개 변수의 값이 표시됩니다.

구문

set [<parameter>[=value]]* [height=num] [history=num] [log=file] [logmode=detailed|command|"from n"] [more=on|off] [prompt=prompt]

예제

다음 예에서는 이 명령의 세 가지 변형 모두를 보여줍니다.

> set height=10
> set
height=10
> set height
height=10

status

설명

status 명령은 백그라운드에서 실행 중인 모든 명령의 상태를 표시합니다.

구문

status

unalias

설명

unalias 명령은 인수로 지정된 별칭 또는 별칭 목록을 제거합니다.

구문

unalias [<pseudonym>]*

unset

설명

unset 명령은 현재 세션에서 지정된 매개 변수를 제거합니다.

구문

unset [<parameter>]*

주 –

unset 명령은 명령 기록에 저장되지 않습니다.

where

설명

where 명령은 현재 토폴로지 경로를 표시합니다.

구문

where

확장 CLI 명령

다음 여러 절에서는 CLI에서 사용할 수 있는 확장 명령의 몇 가지 유형에 대하여 설명합니다.

모듈 확장 명령
개체 속성 확장 명령
경보 확장 명령
토폴로지 확장 명령
CLI 인터페이스 가져오기 및 내보내기의 토폴로지 가져오기 및 내보내기 명령

모듈 확장 명령

7개의 확장 명령이 모듈 관리에 사용 가능합니다.

모듈 명령에 대한 매개 변수

다음 매개 변수는 모듈 명령에서 사용할 수 있습니다. a 및 m 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.

moduleName: 모듈의 국제화 이름
moduleDesc: 모듈의 텍스트 설명
moduleParams: 쉼표로 구분된 모듈 매개 변수의 목록
-default: 모듈의 기본 설정

모듈 명령

disableModule

설명

disableModule 명령은 에이전트(들)의 모듈(들)을 비활성화합니다.

구문

disableModule a=host[:port][,host[:port]]* m=module[+instance][,module[+instance]]*

매개변수

a 및 m

enableModule

설명

enableModule 명령은 에이전트(들)의 모듈(들)을 활성화합니다.

구문

enableModule a=host[:port][,host[:port]]* m=module[+instance][,module[+instance]]*

매개변수

a 및 m

getLoadedModules

설명

getLoadedModules 명령은 에이전트(들)의 로드된 모듈 목록을 얻습니다.

구문

getLoadedModules a=host[:port][,host[:port]]*

매개 변수

a

getModule

설명

getModule 명령은 에이전트(들)의 특정 모듈에 대한 정보를 얻습니다.

구문

getModule a=host[:port][,host[:port]]* m=module[+instance]

매개변수

a 및 m

getModules

설명

getModules 명령은 에이전트(들)의 모든 사용 가능한 모듈 목록을 얻습니다.

구문

getModules a=host[:port][,host[:port]]*

매개 변수

a

loadModule

설명

loadModule 명령은 에이전트(들)의 모듈을 로드합니다.

구문

loadModule a=host[:port][,host[:port]]* m=module[+instance] [moduleName= name] [moduleDesc=description] [moduleParams= key=value[,key=value]*] [-default]

매개변수

a, m, moduleName, moduleDesc, moduleParams 및 -default .

unloadModule

설명

unloadModule 명령은 에이전트(들)의 하나 이상의 모듈을 언로드합니다.

구문

unloadModule a=host[:port][,host[:port]]* m=module[+instance][,module[+instance]]*

매개변수

a 및 m

모듈 명령의 예

agentHost 이름이 seattle인 호스트에서 로드되는 모듈을 확인하려면 CLI 프롬프트에서 다음 명령을 입력합니다.

> getLoadedModules a=seattle

포트 1776의 호스트 seattle 에 kernel-reader 모듈을 로드하려면 다음 명령을 입력합니다.

> loadModule a=seattle:1776 m=kernel-reader

개체 속성 확장 명령

개체 속성 및 속성 값 관리를 위한 4개의 확장 명령이 있습니다.

개체 속성 명령에 대한 매개 변수

다음 매개 변수는 개체 속성 명령에 의해 사용될 수 있습니다. a 및 m 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.

mgtObj: mgtObj 매개 변수의 값은 해당 속성 및 등록 정보가 설정 또는 검색되는 관리 대상 개체의 이름입니다.
property: property 매개 변수의 값은 해당 속성 및 값이 설정 또는 검색되는 등록 정보의 이름입니다.
propInst: propInst 매개 변수의 값은 해당 속성 및 값이 설정 또는 검색되는 등록 정보의 인스턴스 이름입니다.
rowValues: rowValues 매개 변수의 값은 쉼표로 구분된 이름-값 쌍 목록입니다. name은 행에 있는 열의 이름입니다. value는 해당 열의 값입니다.
attribute: attribute 매개 변수의 값은 해당 속성 및 값이 설정 또는 검색되는 등록 정보에 속한 쉼표로 구분된 속성 이름의 목록입니다. setAttributes 명령과 함께 사용될 때 attribute 매개 변수에 있는 각 속성 이름은 value 매개 변수에 있는 해당 값을 가져야 합니다.
value: value 매개 변수의 값은 attribute 매개 변수에 지정된 속성에 해당하는 값의 쉼표로 구분된 목록입니다. setAttributes 명령과 함께 사용될 때 지정된 각 속성에 대한 값이 존재해야 합니다.

개체 속성 명령

다음 명령을 사용하여 개체 속성 및 속성 값을 설정 및 검색할 수 있습니다.

addRow

설명

addRow 명령은 지정된 값을 가진 행을 표에 추가합니다.

구문

addRow a=host[:port][,host[:port]]* m=module[+instance] mgtObj=managedObject [property=property] [propInst=propertyInstance] rowValues=name=value[,name=value]

매개변수

a, m, mgtObj, property, propInst 및 rowValues.

delRow

설명

delRow 명령은 지정된 값을 가진 행을 표에서 삭제합니다.

구문

delRow a=host[:port][,host[:port]]* m=module[+instance] mgtObj=managedObject [property=property] [propInst=propertyInstance] rowValues=name=value[,name=value]

매개변수

a, m, mgtObj, property, propInst 및 rowValues.

getAttributes

설명

getAttributes 명령은 등록정보에 대한 정보를 검색하거나 에이전트 또는 에이전트 목록에서 지정된 속성을 검색합니다.

구문

getAttributes a=host[:port][,host[:port]]* m=module[+instance] mgtObj=managedObject property=property [propInst=propertyInstance] [attribute=attribute[,attribute]*]

매개변수

a, m, mgtObj, property, propInst 및 attribute.

setAttributes

설명

setAttributes 명령은 에이전트 또는 에이전트 목록의 지정된 속성에 등록 정보를 설정하거나 값을 설정합니다. 또한 지정된 속성값을 Null로 재설정할 수도 있습니다.

구문

setAttributes a=host[:port][,host[:port]]* m=module[+instance] mgtObj=managedObject property=property [propInst=propertyInstance] [attribute=attribute[,attribute]*] value=value[,value]*

매개변수

a, m, mgtObj, property, propInst, attribute 및 value.

attribute 매개 변수에 지정된 각 속성의 경우 value 매개 변수에 해당 값이 존재해야 합니다.

개체 속성 명령의 예

다음 명령은 호스트 haiku에서 포트 1161의 agent-stats 모듈에 있는 totalstats 관리 대상 개체의 size 등록정보에 대한 모든 속성을 검색합니다.

> getAttributes a=haiku:1161 m=agent-stats mgtObj=totalstats \
property=size

다음 명령은 alarmlimits.error-gt 속성을 이전 예에서 지정된 size 등록정보에 2의 값으로 설정합니다.

> setAttributes a=haiku:1161 m=agent-stats mgtObj=totalstats \
property=size attribute=alarmlimits.error-gt value=2

다음 명령은 mgtObj에 지정된 관리 대상 개체에서 rowValues 에 지정된 행을 삭제합니다.

> delRow a=haiku:1161 \
m=filemon mgtObj=filemonstats/filemonTable/filemonEntry \
rowValues="name=test,desc=this,filename=/etc/passwd"

경보 확장 명령

경보 관리를 위한 5개의 확장 명령이 있습니다.

경보 명령 매개 변수

다음 매개 변수는 경보에 대한 확장 명령에 의해 사용될 수 있습니다. a 및 m 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.

ack

ack 매개 변수의 값은 관리되는 경보가 응답되었는지 여부를 표시하는 쉼표로 구분된 값 목록입니다. ack 매개 변수에 대한 유효한 값은 ACK (응답됨) 및 NOACK (응답되지 않음)입니다.

command

command 매개 변수의 값은 수행될 경보 작업입니다.

domain

domain 매개 변수의 값은 관리될 경보에 대한 Sun Management Center 도메인의 이름입니다. 도메인을 지정하지 않는 경우 Default Domain이 사용됩니다.

mgtObj

mgtObj 매개 변수의 값은 관리되는 경보에 대한 관리 대상 개체의 이름입니다.

note

note 매개 변수의 값은 실행되는 명령에 대한 텍스트 주석입니다.

property

property 매개 변수의 값은 관리되는 경보에 대한 등록 정보의 이름입니다.

propInst

propInst 매개 변수의 값은 관리되는 경보에 대한 특정 매개 변수 인스턴스의 이름입니다.

qualifier

qualifier 매개 변수의 값은 해당 경보가 관리되는 관리 대상 등록 정보와 연결된 승인자의 이름입니다.

severity

severity 매개 변수의 값은 관리 중인 경보에 대한 심각도 값의 쉼표로 구분된 목록입니다. severity 매개 변수에 허용되는 값은 다음과 같습니다.

ERR — 오류
WRN — 경고
INF — 정보성
IRR — 불합리
DWN — 중단
DIS — 사용 불가
OFF — Off

state

state 매개 변수의 값은 관리 중인 경보에 대한 상태 값의 쉼표로 구분된 목록입니다. 상태 매개 변수에 대한 유효한 값은 Open, Closed 및 Fixed입니다.

경보 명령

다음 명령을 사용하여 경보 값을 검토하고 경보 작업을 설정할 수 있습니다.

ackAlarms

설명

ackAlarms 명령은 에이전트 또는 에이전트 목록에서 경보에 응답합니다.

구문

ackAlarms a=host[:port][,host[:port]]* [domain=domain] [m=module[+instance][mgtObj=managedObject [property=property [propInst=propertyInstance] [qualifier=qualifier]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [note=reason]

매개변수

a, domain, m, mgtObj, property, propInst, qualifier, severity, state 및 note.

state 매개 변수에 대한 지정된 값이 없는 경우, state의 기본값은 Open이 됩니다.

delAlarms

설명

delAlarms 명령은 에이전트 또는 에이전트의 목록에서 경보를 삭제합니다.

구문

delAlarms a=host[:port][,host[:port]]* [domain=domain] [m=module[+instance][mgtObj=managedObject [property=property [propInst=propertyInstance] [qualifier=qualifier]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK] [note=reason]

매개변수

a, domain, m, mgtObj, property, propInst, qualifier, severity, state, ack 및 note.

state 매개 변수에 대한 지정된 값이 없는 경우, state의 기본값은 Closed가 됩니다.

getAlarms

설명

getAlarms 명령은 에이전트 또는 에이전트 집합에 대한 경보 정보를 검색합니다.

구문

getAlarms a=host[:port][,host[:port]]* [domain=domain] [m=module[+instance][mgtObj=managedObject [property=property [propInst=propertyInstance] [qualifier=qualifier]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK]

매개변수

a, domain, m, mgtObj, property, propInst, qualifier, severity, state 및 ack.

지정된 매개 변수가 없는 경우, getAlarms가 모든 경보 정보를 반환합니다.

runAlarmAction

설명

runAlarmAction 명령은 에이전트의 도메인 또는 에이전트의 목록에서 모든 경보에 대해 수동 또는 지연된 경보 작업을 실행합니다.

구문

runAlarmAction a=host[:port][,host[:port]]* [domain=domain] [m=module[+instance][mgtObj=managedObject [property=property [propInst=propertyInstance] [qualifier=qualifier]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK]

매개변수

a, domain, m, mgtObj, property, propInst, qualifier, severity, state 및 ack.

setAlarmAction

설명

setAlarmAction 명령은 에이전트의 도메인 또는 에이전트 목록에서 모든 경보에 대해 수동 또는 지연된 경보 작업을 설정합니다.

구문

setAlarmAction a=host[:port][,host[:port]]* command=command [domain=domain] [m=module[+instance][mgtObj=managedObject [property=property [propInst=propertyInstance] [qualifier=qualifier]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK]

경보에 대한 전자 우편 경고를 설정하려면 명령 형식이

command="email.sh:<email-id>:<message>" 또는

command="email:<email-id>:<message>"일 수 있습니다.

매개변수

a, command, domain , m, mgtObj, property, propInst, qualifier, severity, state 및 ack.

경보 명령의 예

다음 명령은 haiku 호스트에서 심각도가 ERR 또는 DWN인 경보를 모두 검색합니다.

> getAlarms a=haiku severity=ERR,DWN

토폴로지 확장 명령

토폴로지 관리를 위한 9개의 확장 명령이 있습니다.

토폴로지 명령 매개 변수

다음 매개 변수는 토폴로지에 대한 확장 명령에 의해 사용될 수 있습니다. 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 쓰기 커뮤니티의 이름입니다.

토폴로지 명령

토폴로지 관리를 위해 9개의 확장 명령이 있습니다.

createEntity

설명

createEntity 명령은 관리 대상 엔티티를 작성합니다.

구문

매개변수

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 매개 변수에 의해 지정된 조건을 만족시키는 관리 대상 토폴로지 계층의 모든 관리 대상 개체 목록을 반환합니다.

구문

매개변수

t, arch, family 및 pollType.

getCurrentDomain

설명

getCurrentDomain 명령은 현재 도메인의 이름을 반환합니다.

구문

getCurrentDomain

매개변수

없음

getDomains

설명

getDomains 명령은 현재 서버 컨텍스트의 모든 관리 대상 도메인 목록을 반환합니다.

구문

getDomains

매개변수

없음

getTopoObject

설명

getTopoObject 명령은 arch, family 또는 pollType 매개 변수에 의해 지정된 조건을 만족시키는 매개 변수 t에 의해 지정된 토폴로지 개체 아래에 바로 관리 대상 토폴로지 개체 목록을 반환합니다.

구문

매개변수

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