확장 CLI 명령

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

• 모듈 확장 명령

• 개체 속성 확장 명령

• 경보 확장 명령

• 토폴로지 확장 명령

• CLI 인터페이스 가져오기 및 내보내기에 설명되어 있는 토폴로지 가져오기 및 내보내기 명령

모듈 확장 명령

모듈 관리를 위한 7개의 확장 명령이 있습니다. a, m, f 및 columns 매개 변수에 대한 자세한 내용은 미리 정의된 매개 변수 및 플래그를 참조하십시오.

모듈 명령

disableModule

에이전트에서 모듈을 비활성화합니다. disableModule 명령은 매개 변수 a 및 m과 함께 사용됩니다.

enableModule

에이전트에서 모듈을 활성화합니다. enableModule 명령은 매개 변수 a, f, m 및 columns와 함께 사용됩니다.

getLoadedModules

에이전트에서 로드된 모듈 목록을 얻습니다. getLoadedModules 명령은 매개 변수 a, f 및 columns와 함께 사용됩니다.

getModule

특정 모듈에 대한 정보를 얻습니다. getModule 명령은 매개 변수 a, f, m 및 columns와 함께 사용됩니다.

getModules

에이전트에서 모듈 목록을 얻습니다. getModules 명령은 매개 변수 a, f 및 columns와 함께 사용됩니다.

loadModule

에이전트에서 모듈을 로드합니다. loadModule 명령은 매개 변수 a, f, m 및 columns와 함께 사용됩니다.

loadModule 명령은 국제화된 모듈 이름인 moduleName과 모듈에 대한 텍스트 설명인 moduleDesc라는 두 개의 추가 매개 변수와 함께 사용할 수 있습니다.

unloadModule

에이전트에서 하나 이상의 모듈을 언로드합니다. unloadModule 명령은 매개 변수 a, f, m 및 columns와 함께 사용됩니다.

모듈 명령의 예

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

> getLoadedModules a=seattle

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

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

개체 속성 확장 명령

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

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

다음 매개 변수는 개체 속성 명령에서 사용할 수 있습니다. a, m, f 및 columns 매개 변수에 대한 자세한 내용은 미리 정의된 매개 변수 및 플래그를 참조하십시오.

mgtObj

mgtObj 매개 변수의 값은 속성 및 등록 정보가 설정 또는 검색되고 있는 관리 대상 개체의 이름입니다.

property

property 매개 변수의 값은 속성 및 값이 설정 또는 검색되고 있는 등록 정보의 이름입니다.

propInst

propInst 매개 변수의 값은 속성 및 값이 설정 또는 검색되고 있는 등록 정보의 인스턴스 이름입니다.

rowValues

rowValues 매개 변수의 값은 이름-값 쌍의 쉼표로 구분된 목록입니다. name은 행에 있는 열의 이름입니다. value는 해당 열의 값입니다.

attributes

attributes 매개 변수의 값은 속성 및 값이 설정 또는 검색되고 있는 등록 정보에 속하는 속성 이름의 쉼표로 구분된 목록입니다. setAttributes 명령과 함께 사용될 때 attributes 매개 변수에 있는 각 속성 이름은 values 매개 변수에 있는 해당 값을 가져야 합니다.

values

values 매개 변수의 값은 attributes 매개 변수에 지정된 속성에 해당하는 값의 쉼표로 구분된 목록입니다. setAttributes 명령과 함께 사용될 때 지정된 각 속성에 대한 값이 존재해야 합니다.

개체 속성 명령

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

addRow

addRow 명령은 표에 행을 추가합니다. addRow 명령은 매개 변수 a, m, mgtObj, property, propInst 및 rowValues와 함께 사용됩니다.

delRow

delRow 명령은 표에서 행을 삭제합니다. delRow 명령은 매개 변수 a, m, mgtObj, property, propInst 및 rowValues와 함께 사용됩니다.

getAttributes

getAttributes 명령은 에이전트 또는 에이전트 목록에서 지정된 속성을 검색합니다. getAttributes 명령은 매개 변수 a, f, m, columns, mgtObj, property, propInst 및 attributes와 함께 사용됩니다.

setAttributes

setAttributes 명령은 에이전트 또는 에이전트 목록에서 지정된 속성에 값을 할당합니다. setAttributes 명령은 매개 변수 a, m, mgtObj, property, propInst, attributes 및 values와 함께 사용됩니다.

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

개체 속성 명령의 예

다음 명령은 호스트 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 attributes=alarmlimits.error-gt values=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 매개 변수에 대한 유효한 값은 A (응답됨) 및 N (응답되지 않음)입니다.

command

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

domain

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

managed_object

managed_object 매개 변수의 값은 경보가 관리될 관리 대상 개체의 이름입니다.

note

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

property

property 매개 변수의 값은 경보가 관리될 등록 정보의 이름입니다.

property_instance

property_instance 매개 변수의 값은 경보가 관리될 특정 등록 정보 인스턴스의 이름입니다.

qualifier

qualifier 매개 변수의 값은 경보가 관리될 관리 대상 등록 정보와 관련된 한정자의 이름입니다.

severity

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

• ERR — 오류

• WRN — 경고

• INF — 정보성

• IRR — 불합리

• DWN — 중단

• DIS — 사용 불가

• OFF — 사용 안 함

state

state 매개 변수의 값은 관리 중인 경보에 대한 상태 값의 쉼표로 구분된 목록입니다. 상태 매개 변수에 대한 유효한 값은 O (열림) 또는 C (닫힘)입니다.

경보 명령

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

ackAlarms

ackAlarms 명령은 에이전트 또는 에이전트 목록에서 경보에 응답합니다. ackAlarms 명령은 매개 변수 a, ack, columns, domain, f, m, managed_object, note, property, property_instance, qualifier, severity 및 state와 함께 사용됩니다.

state 매개 변수에 대한 값을 지정하지 않은 경우 state는 기본적으로 O (열림)로 설정됩니다.

delAlarms

delAlarms 명령은 에이전트 또는 에이전트의 목록에서 경보를 삭제합니다. delAlarms 명령은 매개 변수 a, ack, columns, domain, f, m, managed_object, note, property, property_instance, qualifier, severity 및 state와 함께 사용됩니다.

state 매개 변수에 대한 값을 지정하지 않은 경우 state는 기본적으로 C (닫힘)로 설정됩니다.

getAlarms

getAlarms 명령은 에이전트 또는 에이전트 집합에 대한 경보 정보를 검색합니다. getAlarms 명령은 매개 변수 a, ack, columns, domain, f, m, managed_object, property , property_instance, qualifier, severity 및 state와 함께 사용됩니다.

매개 변수를 지정하지 않은 경우 getAlarms는 모든 경보 정보를 반환합니다.

runAlarmAction

runAlarmAction 명령은 에이전트 또는 에이전트 목록에서 수동 또는 지연된 경보 작업을 실행합니다. runAlarmAction 명령은 매개 변수 a 및 domain과 함께 사용됩니다.

setAlarmAction

setAlarmAction 명령은 에이전트 또는 에이전트 목록에서 기존 경보에 대한 수동 또는 지연된 경보 작업을 설정합니다. setAlarmAction는 매개 변수 a, command 및 domain과 함께 사용됩니다.

경보 명령의 예

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

> getAlarms a=haiku severity=ERR,DWN

토폴로지 확장 명령

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

토폴로지 명령 매개 변수

토폴로지에 대한 확장 명령에 다음 매개 변수를 사용할 수 있습니다. a, columns, f 및 t 매개 변수에 대한 자세한 내용은 미리 정의된 매개 변수 및 플래그를 참조하십시오.

agentPort

agentPort 매개 변수의 값은 에이전트 포트 번호입니다. agentPort가 지정되지 않은 경우 기본값 161이 사용됩니다. agentPort 매개 변수는 선택 사항입니다. url 매개 변수를 지정하지 않은 경우와 기본 포트를 사용하지 않을 경우에만 이 매개 변수를 지정합니다.

arch

arch 매개 변수의 값은 토폴로지 개체의 구조입니다.

domain

domain 매개 변수의 값은 setCurrentDomain 명령에 대해 지정해야 하는 Sun Management Center 도메인의 이름입니다.

family

family 매개 변수의 값은 토폴로지 개체의 개체 패밀리입니다.

fullDesc

fullDesc 매개 변수의 값은 작성 중인 엔티티 또는 그룹에 대한 텍스트 설명입니다.

isPolled

isPolled 매개 변수의 값은 true 또는 false일 수 있습니다. 값이 true인 경우 엔티티는 폴링 유형(pollType)에 따라 상태 정보에 대해 폴링을 수행합니다.

pollType

pollType 매개 변수의 값은 해당 엔티티에 대한 폴링 유형입니다. pollType 매개 변수에 허용되는 값은 다음과 같습니다.

• 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

writeInfo

writeInfo 매개 변수의 값은 SNMP 폴링 대상 개체에 대한 SNMPv1 쓰기 커뮤니티의 이름입니다.

토폴로지 명령

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

createEntity

createEntity 명령은 관리 대상 엔티티를 작성합니다. 관리 대상 엔티티의 등록 정보는 매개 변수 agentPort , arch, family, fullDesc, isPolled, pollType , readInfo, targetHost, targetIP, topoCfg, topoType , url, columns, f 및 t를 사용하여 지정됩니다.

url 또는 agentPort 매개 변수를 지정하는 경우 기본 포트 161이 사용되지 않습니다.

createGroup

createGroup 명령은 토폴로지 도메인 또는 그룹을 작성합니다. 작성 중인 엔티티가 그룹인 경우 그룹 등록 정보는 매개 변수 family 및 fullDesc를사용하여 지정됩니다. createGroup 명령은 또한 매개 변수 columns, f 및 t와 함께 사용됩니다.

작성 중인 엔티티가 도메인인 경우 family 및 fullDesc 매개 변수는 무시됩니다.

delTopoObjects

delTopoObjects 명령은 관리되는 토폴로지 계층에서 관리 대상 토폴로지 개체를 삭제합니다. 지정된 토폴로지 개체 아래에 있는 모든 개체가 함께 삭제됩니다. delTopoObjects 명령은 매개 변수 columns, f 및 t와 함께 사용됩니다.

getAgentPort

getAgentPort 명령은 토폴로지 도메인의 지정된 호스트에서 실행 중인 Sun Management Center 에이전트의 포트 번호를 반환합니다. 여러 에이전트가 존재하는 경우 포트 번호 목록이 반환됩니다. getAgentPort 명령은 매개 변수 columns, f 및 t와 함께 사용됩니다.

t를 지정하지 않은 경우 기본 도메인이 사용됩니다.

getAllTopoObjects

getAllTopoObjects 명령은 관리되는 토폴로지 계층에서 arch, family 또는 pollType 매개 변수에 의해 지정된 조건에 맞는 모든 관리 대상 개체 목록을 반환합니다. getAllTopoObjects 명령은 또한 매개 변수 columns, f 및 t와 함께 사용됩니다.

getCurrentDomain

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

getDomains

getDomains 명령은 모든 관리 대상 도메인 목록을 반환합니다.

getTopoObject

getTopoObject 명령은 매개 변수 t에 의해 지정된 토폴로지 개체의 바로 아래에 있는 관리 대상 토폴로지 개체 중에서 매개 변수 arch, family 또는 pollType에 의해 지정된 조건에 맞는 관리 대상 토폴로지 개체 목록을 반환합니다. getTopoObject 명령은 매개 변수 columns 및 f와 함께 사용됩니다.

setCurrentDomain

setCurrentDomain 명령은 홈 도메인을 domain 매개 변수에 지정된 값으로 설정합니다.

CLI에서 토폴로지 정보 내보내기 및 가져오기에 대한 내용은 CLI 인터페이스 가져오기 및 내보내기를 참조하십시오.

토폴로지 명령의 예

다음 명령은 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에서 실행 중인 에이전트가 있는 Sun Ultra-2 호스트입니다.

> 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