Sun Management Center 명령줄 인터페이스(CLI)는 시스템 모니터링 및 관리를 위한 Java 및 웹 콘솔 그래픽 인터페이스에 대한 대안으로서 가벼운 문자 구동형 콘솔입니다.
이 장에서는 다음 내용을 설명합니다.
Sun Management Center 명령줄 인터페이스(CLI)는 시스템 모니터링 및 관리를 위한 특성 주도형 콘솔 응용프로그램입니다. CLI는 다음과 같은 유용한 기능이 있습니다.
낮은 오버헤드 – CLI는 Java 콘솔 및 웹 콘솔 기능의 대부분을 제공하지만 비트맵 그래픽이 필요하지 않습니다. 따라서 CLI는 낮은 대역폭 연결을 통하여 단순 데이터 터미널 장치에서 실행할 수 있습니다. 그러나 물리적 뷰 또는 그래핑과 같이 GUI를 필요로 하는 기능은 CLI를 통해서 사용할 수 없습니다.
일괄 처리 모드 프로세싱 – CLI는 일괄 처리 모드에서 CLI가 파일로부터 명령 입력을 취할 수 있게 해주는 기본 스크립팅 기능을 지원합니다.
구성 가능한 출력 형식 – CLI 출력의 형식을 구성할 수 있습니다. 일반 텍스트 출력은 다른 텍스트 기반 도구와 호환할 수 있습니다. 확장 명령의 경우 출력을 XML 및 HTML로 지정할 수 있습니다.
도움말 – CLI 명령에 대한 온라인 도움말은 CLI 안에서 사용할 수 있습니다.
CLI를 사용하여 다음과 같은 태스크를 수행할 수 있습니다.
도메인, 그룹, 엔티티와 같은 토폴로지 개체를 만들고, 이러한 개체에 대한 토폴로지 정보를 검색합니다.
관리 대상 개체의 등록정보 또는 속성을 검색하고 조작합니다.
Sun Management Center 에이전트에서 모듈을 로드, 언로드, 활성화 및 비활성화합니다.
Sun Management Center 에이전트에서 경보 작업을 설정 및 실행하고 경보 정보를 검색하고 경보에 응답하거나 경보를 삭제합니다.
(Solaris 및 Linux에서) 매개 변수 파일을 사용하여 콘솔에 자동으로 로그인할 수 있습니다. 매개 변수 파일에 사용자 이름 및 암호가 있는 경우, 해당 파일에 대한 권한은 400이어야 합니다. 그렇지 않으면 CLI를 통한 자동 로그인이 불가능합니다.
다음 시스템 구성 중 하나에서 사용자 터미널 세션으로부터 CLI를 액세스할 수 있습니다.
Solaris 운영 체제의 Solaris 7, Solaris 8, Solaris 9 또는 Solaris 10 버전을 실행하는 UNIX® 워크스테이션
Red Hat, SuSE/JDS Linux 커널 버전 2.4 및 2.6을 실행하는 UNIX 워크스테이션
Windows 2000, Windows XP 또는 Windows NT를 실행하는 PC
세션 모드 – 세션 모드는 대화형입니다. Sun Management Center 서버로 로그인한 후에 서버에서 명시적으로 로그아웃하기 전까지 명령을 입력하고 출력을 받을 수 있습니다.
일괄 처리 모드 – CLI는 서버에 연결하여 filename에 들어 있는 명령을 실행합니다. 여기에서 filename은 CLI 명령이 들어 있는 파일의 이름입니다. CLI는 비루트 사용자로 일괄 처리 모드에서 실행될 수 있습니다.
CLI 일괄 처리 모드는 /opt/SUNWsymon/cli에 있는 cli.properties 파일을 수정하여 구성될 수 있습니다. 이 파일은 9개의 구성 가능한 매개 변수를 포함합니다.
표 20–1은 구성 가능한 매개 변수에 대해 설명합니다.
표 20–1 CLI 일괄 처리 모드를 구성하는 매개 변수
매개 변수 |
설명 |
기본값 |
---|---|---|
process_time_out |
이 시간이 만료되면 CLI 백엔드 프로세스가 시스템에서 제거됩니다. |
Process time-out 24 hrs process_time_out = 86400 (in seconds) |
uds_dgram_wait_time |
DGRAM 클라이언트가 CLI 백엔드 프로세스로부터의 응답을 기다립니다. 클라이언트가 지정된 시간 내에 어떤 응답도 받지 않는 경우, “Error receiving data from Backend” 오류 메시지가 표시됩니다. |
UDS DGRAM wait time in seconds uds_dgram_wait_time = 300 |
uds_stream_wait_time |
STREAM 클라이언트가 CLI 백엔드 프로세스로부터의 응답을 기다립니다. 클라이언트가 지정된 시간 내에 어떤 응답도 받지 않는 경우, “Error receiving data from Backend” 오류 메시지가 표시됩니다. |
UDS STREAM wait time in seconds uds_stream_wait_time = 180 |
out_file |
이 파일은 현재 실행 중인 CLI 백엔드 프로세스의 세부 정보를 포함합니다. 이 파일의 형식은 다음과 같습니다. <user>:<hostname>:<C Process ID>:<Java Process ID> |
User & process information file out_file = /var/opt/SUNWsymon/cli/process-file |
socket_pathclnt |
이 파일은 클라이언트 브로커 UDS 파일의 경로를 포함합니다. 처리된 CLI 명령의 출력이 이 파일로 전송됩니다. |
Path to uds file socket_pathclnt = /var/opt/SUNWsymon/cli/broker_uds_client_file |
cli_log_path |
이 파일은 CLI 로그 파일의 경로를 포함합니다. |
Location of CLI log file cli_log_path = /tmp/sunmclog/cli |
cli_log_file |
CLI 로그 파일의 이름입니다. |
Location of backend(broker) log file cli_log_file = /tmp/sunmclog/cli/cli-batch-mode-log |
uds_file_path |
이 경로는 STREAM 및 DGRAM UDS 파일의 위치를 포함합니다. |
Path of the uds files uds_file_path = /var/opt/SUNWsymon/cli/ |
log_level |
사용될 로깅 레벨을 지정합니다. 생산 환경에 대해 ERROR 로 로그 레벨을 설정합니다. 디버깅 환경에 대해 INFO로 로그 레벨을 설정합니다. |
Batch mode log level [options : INFO|ERROR] log_level=ERROR |
이 절에서는 CLI 명령 및 매개 변수의 개요를 제공합니다.
CLI 명령은 두 가지 유형, 즉 기본 명령 및 확장 명령으로 나눌 수 있습니다.
기본 명령은 다른 CLI 명령이 실행되는 환경을 수정하는 명령입니다. 기본 명령을 사용하여 매개 변수 값을 설정하고 명령 별칭을 정의하고 명령 상태를 확인하거나 서버에 로그인 및 로그아웃합니다. 기본 명령은 항상 포그라운드에서 실행됩니다.
확장 명령은 관리 대상 개체의 토폴로지, 등록 정보 및 속성을 문의하거나 수정하는 명령입니다. 확장 명령을 사용하여 다음과 같은 몇 가지 기능을 실행합니다.
관리 대상 개체의 토폴로지에서 관리 대상 개체를 찾습니다.
모듈을 활성화 또는 비활성화합니다.
경보에 응답하거나 경보를 삭제합니다.
기본적으로 확장 명령은 백그라운드에서 실행됩니다. 포그라운드에서 실행되도록 확장 명령을 구성할 수 있습니다.
세션 모드에서 명령은 포그라운드 또는 백그라운드에서 실행됩니다.
포그라운드 – 포그라운드에서 실행되는 명령은 완료됩니다. 이 명령은 리디렉션되지 않는 경우 화면에 직접 출력을 보냅니다. 한 번에 하나의 명령만이 포그라운드에서 실행될 수 있습니다. 기본 명령은 포그라운드에서만 실행될 수 있는 명령입니다. 확장 명령은 기본적으로 백그라운드에서 실행되지만 포그라운드에서 실행되도록 구성할 수 있습니다.
백그라운드 – 백그라운드에서 실행되는 명령은 비동기적으로 실행되며 기본적으로 출력 또는 진단 메시지를 화면에 보내지 않습니다. 출력은 버퍼되며 명시적 요청에 의해서 나중에 표시될 수 있습니다. UNIX 쉘과는 달리 한 번에 하나의 확장 명령만이 백그라운드에서 실행될 수 있습니다. 이 명령이 백그라운드에서 실행되는 동안 상당 수의 기본 명령이 포그라운드에서 실행될 수 있습니다. 확장 명령이 포그라운드에서 실행되도록 지정할 수 있지만 기본적으로 확장 명령은 백그라운드에서 실행됩니다. 기본 명령은 백그라운드에서 실행될 수 없습니다.
CLI 역시 별칭을 지원합니다. 보다 복잡한 명령 및 매개 변수에 대해 약어나 별명을 정의할 수 있습니다. 사용자 정의 별칭은 다른 CLI 세션에도 계속 유지됩니다.
CLI 매개 변수는 이름값 쌍입니다. 각 매개 변수에는 이름과 값이 포함되어 있습니다. 일부 매개 변수는 CLI에 기본 제공됩니다. 이름과 값의 의미는 CLI 안에 미리 정의되어 있습니다. 변수라고도 하는 다른 매개 변수를 지정할 수 있습니다. 일부 매개 변수의 범위는 전역입니다. 전역 매개 변수는 특정 세션에서 실행되는 모든 CLI 명령의 실행에 영향을 줍니다. 일부 매개 변수는 특정 명령 또는 명령 그룹에 국한됩니다.
CLI는 입력 및 출력에 대한 몇 가지 기능을 제공합니다.
입력
출력
출력 표시에 대한 줄 수를 지정할 수 있습니다.
여러 개의 열을 출력하는 경우 표시할 열을 지정할 수 있습니다.
일부 명령의 경우에 일반 텍스트 출력뿐만 아니라 XML 및 HTML 출력을 지정할 수 있습니다.
CLI는 각 CLI 명령에 대한 온라인 도움말을 제공합니다. CLI 도움말은 CLI 안에서 사용할 수 있습니다. CLI 도움말에는 GUI가 필요하지 않습니다. 각 명령의 경우 도움말은 명령 사용에 대한 개요와 해당 명령과 관련된 매개 변수 목록을 제공합니다.
대부분의 CLI 매개 변수는 이름-값 쌍으로 되어 있습니다. 각 매개 변수에는 이름과 값이 포함되어 있습니다. 소수의 매개 변수에는 이름만 있고 값은 없는데,이러한 매개 변수를 플래그라고 합니다.
CLI 세션에서 다음과 같은 몇몇 지점에 매개 변수 값을 지정할 수 있습니다.
CLI 시작 – CLI를 시작할 때 명령줄에서 매개 변수를 지정할 수 있습니다. 시작 시 지정되는 매개 변수는 세션에 대해서 전역적입니다. 전역 매개 변수는 set 명령을 통하여 무시되거나 unset 명령을 통하여 현재 세션에서 제거되지 않는 경우 해당 값을 유지합니다.
CLI 명령 – 세션 동안 실행되는 개별 CLI 명령에 대한 매개 변수를 지정할 수 있습니다. 명령의 일부로 지정된 값은 해당 명령이 지속되는 동안 전역 매개 변수의 값을 일시적으로 무시합니다.
입력 파일 – 매개 변수 정의는 외부 파일에 저장되고 CLI 세션에서 아무 때나 호출될 수 있습니다. 전역 매개 변수와 개별 명령 매개 변수는 외부 파일에 정의되어 있는 매개 변수 값을 무시합니다.
file=/home/examples/example1
여기서 매개 변수 name은 file이며, 매개 변수value는 /home/examples/example1 입니다. 등호(=)와 매개 변수 이름 또는 매개 변수 값 사이에는 공백이 없어야 합니다. 스페이스나 탭 문자 같은 공백이 값에 포함되는 경우 다음과 같이 해당 값을 큰따옴표(ASCII 문자 0x22)로 묶어야 합니다.
moduleDesc="Local File Scanning"
매개 변수 값은 쉼표로 구분된 값의 목록일 수 있습니다. 다음 예에서처럼 쉼표로 구분된 값 사이에는 공백이 없어야 합니다.
severity=DIS,DWN,ERR
매개 변수 목록은 다음 예에서처럼 공백으로 구분되는 일련의 매개 변수입니다.
m=kernel-reader moduleDesc="My Kernel Reader"
ok1="This is just a test" ok2=hello ok3=hello,hi,aloha ok4="hello,hi,aloha"
broken1="How are you?","Who are you?" broken2="Testing",1,2,3 broken3="Hello broken4=Hello"
매개 변수는 파일에 저장하여 필요한 경우 읽을 수 있습니다. 필요한 개수의 매개 변수 파일을 만들 수 있습니다. 기본 제공 i 매개 변수를 사용하여 원하는 매개 변수 입력 파일의 이름을 지정할 수 있습니다.
이 절에서는 CLI 안에 의미를 미리 정의해 둔 매개 변수에 대하여 설명합니다.
미리 정의된 여러 매개 변수에는 단일 문자 이름이 있습니다. a, f 및 o를 예로 들 수 있습니다.
CLI가 시작될 때 명령줄에 포함된 경우, 이 플래그는 CLI가 일괄 처리 모드에서 실행되도록 합니다. 이 플래그는 세션 모드에서 무시됩니다.
세션 모드의 명령에 이 플래그가 매개 변수로 사용되는 경우, CLI가 명령에 대한 도움말 텍스트를 표시하도록 지시합니다.
이 플래그가 세션 모드에서 확장 명령에 대한 매개 변수로 사용되는 경우 해당 플래그는 현재 명령을 실행하는 동안 마지막 확장 명령으로부터 매개 변수를 유지하도록 CLI에 지시합니다. -l 플래그가 지정되는 경우 현재 명령에 대해 지정된 추가 매개 변수는 무시됩니다. 이 플래그는 기본 명령에 영향을 주지 않습니다. 다음은 -l 플래그를 사용한 예입니다.
> getLoadModules a=myHostName ... ... > getAlarms -l |
getAlarms 명령이 실행될 때, 해당 명령은 이전에 실행된 getLoadModules 명령으로부터 매개 변수 a (myHostName)의 값을 사용합니다.
a 매개 변수의 값은 에이전트로서 에이전트 호스트 및 포트 번호(옵션)로 지정됩니다. 포트 번호를 지정하는 경우, 콜론(:)으로 호스트 이름에서 번호를 구분합니다. 일반 구문은 a=agentHost[: agentPort] 입니다. 예를 들어, 호스트 example_host에서 실행하고 포트 12345를 청취하는 에이전트를 지정하려면 다음 구문을 사용합니다.
a=example_host:12345 |
또한 a 매개 변수의 값은 에이전트 사양의 쉼표로 구분된 목록이 될 수도 있습니다. a=agent[, agent]*.
about 매개 변수는 help 명령과 함께 사용됩니다. 이 매개 변수는 CLI에 대한 버전 정보를 표시합니다.
append 매개 변수의 값은 명령의 출력이 추가되어야 하는 파일의 이름입니다. 이 파일이 존재하지 않으면 파일이 만들어집니다. append 매개 변수를 전역적으로 설정하면 해당 세션에 대한 모든 명령 출력이 지정된 파일에 추가됩니다. 또한 다음 예에서처럼 특정 명령에 대해 이 매개 변수를 설정할 수도 있습니다.
append=/home/examples/cli_output |
append 및 o 매개 변수가 설정된 경우, append는 o보다 우선합니다. 지정된 파일에 명령 결과만 기록됩니다. 실제 명령은 기록되지 않습니다. log 매개 변수를 사용하여 명령 정보를 기록합니다.
columns 매개 변수의 값은 print 명령에 의해 표시되는 명령 출력의 하나 이상의 열의 이름입니다. 열 이름은 대소문자를 구별합니다. 여러 개의 열 이름은 쉼표로 구분됩니다. 다음 예에서는 여러 열 이름을 사용합니다.
columns="Alarm Id,Node URL,Target Host,Severity" |
f 매개 변수의 값은 명령 출력의 형식을 결정합니다. 현재 형식은 plain 및 html 입니다. 자세한 정보는 명령 출력 형식을 참조하십시오. 형식을 HTML로 설정하려면 다음 구문을 사용합니다.
f=html |
height 매개 변수의 값은 화면에 표시되는 명령 출력의 행 수입니다. 다음 예에서는 높이를 대략 표준 터미널 화면의 높이에 설정합니다.
height=24 |
history 매개 변수의 값은 명령 기록에 저장되는 명령의 수입니다. history 명령을 사용하여 이전에 실행된 명령을 볼 수 있습니다. 이 매개 변수는 set 명령에 의해 사용됩니다.
history=10 |
i 매개 변수의 값은 현재 세션에 포함될 매개 변수 정의가 들어 있는 입력 파일의 이름입니다. 입력 파일 안에서 각 매개 변수의 정의는 개별 줄에 서술되어야 합니다. 예를 들어, 다음 줄이 /home/examples/myParams 파일에 있다고 가정해 봅시다.
more=off serverHost=myserver a=myagent:161 |
다음 행을 사용하여 현재 CLI 세션에 이러한 매개 변수를 포함시킬 수 있습니다.
i=/home/examples/myParams |
log 매개 변수의 값은 모든 CLI 명령을 기록하는 파일의 이름 및 명령이 실행된 시간입니다. 로그 파일은 명령 이름과 실행 시간만 기록합니다. 명령 출력은 a 또는 o 매개 변수가 지정하는 파일에 기록됩니다. 해당 매개 변수를 설정하면 모든 후속 명령이 파일에 추가됩니다. 이 파일이 존재하지 않으면 파일이 만들어집니다. 로깅이 켜져 있는 경우 로그 파일의 덮어쓰기가 되지 않으므로 다른 로그를 원한다면 다른 파일을 지정하십시오. 로깅을 끄려면 log 매개 변수와 함께 unset 명령을 사용하십시오. 다음은 로그를 시작한 다음 로그를 나중에 중지한 예입니다.
> log=/home/examples/sunmc-log ... ... > unset log |
logmode 매개 변수의 값은 detailed, command 또는 from n이 될 수 있습니다. detailed의 값은 명령 로그 파일에 명령에 대한 세부 정보를 저장합니다. command의 값은 명령 로그 파일에 명령 및 각각의 매개 변수만 저장합니다. from n의 값은 명령 로그 파일에 명령 기록의 (n th 항목에서 시작하는) 모든 항목을 추가합니다. logmode 매개 변수의 기본값은 detailed입니다.
m 매개 변수의 값은 Sun Management Center 모듈의 이름입니다. 해당 값은 또한 모듈의 쉼표로 구분된 목록일 수 있습니다.
m=kernel-reader |
more 매개 변수의 값은 표시에서 명령 출력의 페이징을 제어합니다. 가능한 값은 on 및 off입니다. more를 on으로 설정하면 터미널에 대한 모든 후속 출력이 한 번에 한 화면에 표시됩니다. 화면의 크기는 height 및 width 매개 변수에 의해 정의됩니다. 기본값은 일관 처리 모드의 경우에는 off이며 세션 모드의 경우에는 on입니다.
more=on |
o 매개 변수의 값은 명령 출력이 기록되어야 하는 파일의 이름입니다. 해당 파일이 존재하는 경우 파일은 덮어쓰기가 됩니다. o 매개 변수를 사용하면 해당 명령에 대한 o 매개 변수를 지정하여 특정 명령의 출력을 얻을 수 있습니다. 또한 set 명령을 사용하여 전역적으로 매개 변수를 설정해서 모든 후속 출력을 파일에 기록할 수 있습니다.
append 및 o 매개 변수 모두가 설정된 경우, append가 o보다 우선합니다. 출력이 지정된 파일에 추가됩니다. 파일에 명령 출력만 기록됩니다. 실제 명령은 기록되지 않습니다. log 매개 변수를 사용하여 명령 정보를 기록합니다. 다음은 명령 출력이 기록되는 파일을 정의한 예입니다.
o=/home/examples/sunmc-output |
serverPort 매개 변수의 값은 로그인용 서버 포트입니다. 이 전역 매개 변수는 로그인 세션이 시작된 후에 설정할 수 없습니다. 이 매개 변수를 설정하지 않은 경우 기본 포트 2099가 사용됩니다.
style 매개 변수의 값은 명령 출력의 스타일을 결정합니다. 이 매개 변수의 허용값은 table, list 및 <custom> 입니다. table 값은 표 형식으로 출력을 표시합니다. list 값은 쉼표로 구분된 열을 사용하여 목록의 출력을 표시합니다. <custom> 값을 사용하면 출력이 사용자 정의 형식으로 표시됩니다. 각 열은 %a로 표시됩니다. 사용자 정의 값은, \t 및 \n과 같은 특수 문자를 포함할 수 있습니다.
t 매개 변수의 값은 토폴로지 에이전트에서 관리되는 개체의 이름입니다. 개체는 도메인, 뷰 그룹 또는 엔티티일 수 있습니다. 개체 이름은 도메인 레벨의 정규화된 이름(예: /domain/group/host)입니다.
명령 유형 및 개념의 개요는 CLI 명령 및 매개 변수 개요를 참조하십시오. 기본 CLI 명령에 의해 사용된 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.
설명
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 [group=groupName [name=attribName] [-key]]
browse 명령은 토폴로지의 검색 모드를 활성화합니다.
구문
browse
설명
cd 명령은 현재 토폴로지 경로를 변경합니다. 지정된 경로가 없는 경우, 현재 경로가 기본 도메인으로 설정됩니다. 번호(n)가 지정된 경우, 현재 경로는 list 명령으로 표시된 대로 nth 자식 경로로 설정됩니다.
구문
cd [path|number]
설명
clear 명령은 현재 세션 중 설정된 모든 매개 변수를 제거합니다. 그러나, 이 명령은 명령줄에서 설정된 매개 변수를 제거하지 않습니다. 이 명령은 unset 명령과 비슷하지만 인수로서 매개 변수 이름을 필요로 하지 않습니다.
구문
clear
data 명령은 토폴로지 개체의 세부 정보를 표시합니다. 번호(n)가 지정된 경우, 경로는 list 명령으로 표시된 대로 nth 자식 경로로 설정됩니다.
구문
data [path|number|-key]
end 명령은 토폴로지의 검색 모드를 비활성화합니다.
구문
end
설명
exit 명령은 서버 연결 및 CLI 세션을 종료합니다.
구문
exit [-onError]
매개 변수
onError
onError 매개 변수는 이전 명령의 실행으로 예외가 발생한 경우 CLI 세션을 종료하는 데 사용됩니다. 이 매개 변수는 일괄 처리 모드에서만 사용됩니다.
goto 명령은 대소문자를 구분하는 패턴과 일치하는 토폴로지 경로를 탐색합니다. 두 개 이상의 일치 경로를 찾은 경우, 사용자는 경로를 선택할 것인지 질문을 받습니다.
구문
goto <pattern>
설명
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 명령은 CLI 세션에서 이전에 입력된 명령을 나열 또는 실행합니다. history 명령이 인수 없이 호출되고 기록이 이전에 설정된 경우, 이전에 입력된 모든 명령이 나열됩니다. history 명령이 숫자 인수와 함께 호출되고 기록이 이전에 설정된 경우, 이 인수와 일치하는 명령이 실행됩니다.
구문
history [num]
설명
kill 명령은 백그라운드에서 실행중인 모든 명령을 종료합니다.
구문
kill
설명
list 명령은 경로 아래에 개체를 나열합니다. 번호(n)가 지정된 경우, 이 명령으로 표시된 대로 nth 자식 경로로 설정됩니다.
구문
list [path|number]
설명
locate 명령은 지정된 패턴과 일치하는 모든 토폴로지 경로를 찾습니다. 패턴은 대소문자를 구분합니다.
구문
locate <pattern>
설명
login 명령은 Sun Management Center 서버에 대한 연결을 설정합니다. serverHost를 지정하고 선택적으로 serverPort 매개 변수를 인수로 지정할 수 있습니다. 호스트를 지정하지 않은 경우 호스트를 묻는 메시지가 표시됩니다. 지정된 포트가 없는 경우, 2099가 사용됩니다. login 명령을 실행하는 경우에도 사용자 이름과 암호를 묻는 메시지가 표시됩니다.
구문
login [serverHost=host] [serverPort=portNumber] [user=userName] [password=userPassword]
매개변수
serverHost, serverPort, user 및 password
설명
logout 명령은 Sun Management Center 서버에 대한 연결을 종료하지만 CLI 세션을 종료하지 않습니다.
구문
logout
설명
print 명령은 지정된 형식의 마지막 확장 명령의 출력을 지정된 대상으로 안내합니다. 기본적으로 print는 해당 출력을 일반 텍스트 형식의 터미널 화면으로 지정합니다. 매개 변수 append 또는 o를 설정하는 경우 출력은 해당 매개 변수가 지정하는 파일로 지정됩니다. 출력이 화면에 표시되지 않습니다. 지정된 ncols가 없는 경우, 열의 기본 수는 4로 설정됩니다.
print 명령은 history 명령으로 저장되지 않습니다.
구문
print [f=plain|xml|html] [style=table|list|<custom>] [columns= columnList] [ncols=num] [o=outputFile | append=appendFile]
매개변수
f, style, columns, ncols, o 및 append
설명
quit 명령은 서버와의 연결을 끊고 CLI 세션을 종료합니다.
구문
quit
설명
reset 명령은 명령줄에 지정되는 모든 매개 변수의 값을 CLI 세션이 시작될 때 지정된 값으로 복원합니다. 세션 동안 정의되었지만 명령줄에는 정의되지 않은 매개 변수는 변경되지 않고 그대로 유지됩니다. reset에 대한 인수로서 특정 매개 변수 이름이 제공되고 매개 변수가 명령줄에 지정된 경우 해당 매개 변수의 값은 원래 값으로 복원됩니다. 그렇지 않은 경우 매개 변수의 값은 변경되지 않고 그대로 유지됩니다.
reset 명령은 history 명령으로 저장되지 않습니다.
구문
reset [<parameter>]*
설명
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
설명
unalias 명령은 인수로 지정된 별칭 또는 별칭 목록을 제거합니다.
구문
unalias [<pseudonym>]*
설명
unset 명령은 현재 세션에서 지정된 매개 변수를 제거합니다.
구문
unset [<parameter>]*
unset 명령은 명령 기록에 저장되지 않습니다.
설명
where 명령은 현재 토폴로지 경로를 표시합니다.
구문
where
다음 여러 절에서는 CLI에서 사용할 수 있는 확장 명령의 몇 가지 유형에 대하여 설명합니다.
CLI 인터페이스 가져오기 및 내보내기의 토폴로지 가져오기 및 내보내기 명령
7개의 확장 명령이 모듈 관리에 사용 가능합니다.
다음 매개 변수는 모듈 명령에서 사용할 수 있습니다. a 및 m 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.
모듈의 국제화 이름
모듈의 텍스트 설명
쉼표로 구분된 모듈 매개 변수의 목록
모듈의 기본 설정
설명
disableModule 명령은 에이전트(들)의 모듈(들)을 비활성화합니다.
구문
disableModule a=host[:port][,host[:port]]* m=module[+instance][,module[+instance]]*
매개변수
a 및 m
설명
enableModule 명령은 에이전트(들)의 모듈(들)을 활성화합니다.
구문
enableModule a=host[:port][,host[:port]]* m=module[+instance][,module[+instance]]*
매개변수
a 및 m
설명
getLoadedModules 명령은 에이전트(들)의 로드된 모듈 목록을 얻습니다.
구문
getLoadedModules a=host[:port][,host[:port]]*
매개 변수
a
설명
getModule 명령은 에이전트(들)의 특정 모듈에 대한 정보를 얻습니다.
구문
getModule a=host[:port][,host[:port]]* m=module[+instance]
매개변수
a 및 m
설명
getModules 명령은 에이전트(들)의 모든 사용 가능한 모듈 목록을 얻습니다.
구문
getModules a=host[:port][,host[:port]]*
매개 변수
a
설명
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 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 매개 변수에 대한 세부 정보는 미리 정의된 매개 변수 및 플래그를 참조하십시오.
rowValues 매개 변수의 값은 쉼표로 구분된 이름-값 쌍 목록입니다. name은 행에 있는 열의 이름입니다. value는 해당 열의 값입니다.
attribute 매개 변수의 값은 해당 속성 및 값이 설정 또는 검색되는 등록 정보에 속한 쉼표로 구분된 속성 이름의 목록입니다. setAttributes 명령과 함께 사용될 때 attribute 매개 변수에 있는 각 속성 이름은 value 매개 변수에 있는 해당 값을 가져야 합니다.
value 매개 변수의 값은 attribute 매개 변수에 지정된 속성에 해당하는 값의 쉼표로 구분된 목록입니다. setAttributes 명령과 함께 사용될 때 지정된 각 속성에 대한 값이 존재해야 합니다.
다음 명령을 사용하여 개체 속성 및 속성 값을 설정 및 검색할 수 있습니다.
설명
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 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 a=host[:port][,host[:port]]* m=module[+instance] mgtObj=managedObject property=property [propInst=propertyInstance] [attribute=attribute[,attribute]*]
매개변수
a, m, mgtObj, property, propInst 및 attribute.
설명
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 (응답됨) 및 NOACK (응답되지 않음)입니다.
domain 매개 변수의 값은 관리될 경보에 대한 Sun Management Center 도메인의 이름입니다. 도메인을 지정하지 않는 경우 Default Domain이 사용됩니다.
qualifier 매개 변수의 값은 해당 경보가 관리되는 관리 대상 등록 정보와 연결된 승인자의 이름입니다.
severity 매개 변수의 값은 관리 중인 경보에 대한 심각도 값의 쉼표로 구분된 목록입니다. severity 매개 변수에 허용되는 값은 다음과 같습니다.
state 매개 변수의 값은 관리 중인 경보에 대한 상태 값의 쉼표로 구분된 목록입니다. 상태 매개 변수에 대한 유효한 값은 Open, Closed 및 Fixed입니다.
다음 명령을 사용하여 경보 값을 검토하고 경보 작업을 설정할 수 있습니다.
설명
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.
설명
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.
설명
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.
설명
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 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가 지정되지 않은 경우 기본값 161이 사용됩니다. agentPort 매개 변수는 선택 사항입니다. url 매개 변수를 지정하지 않은 경우와 기본 포트를 사용하지 않을 경우에만 이 매개 변수를 지정합니다.
domain 매개 변수의 값은 setCurrentDomain 명령에 대해 지정해야 하는 Sun Management Center 도메인의 이름입니다.
domainmode 매개 변수의 값은 follow 또는 ignore이 될 수 있습니다. 해당 값이 follow인 경우, import 명령은 파일에서 지정된 대상 도메인으로 그룹 및 도메인 정보 모두를 가져옵니다. 해당 값이 ignore인 경우, import 명령은 도메인 정보를 무시합니다.
family 매개 변수의 값은 토폴로지 개체의 개체 그룹입니다. 이것이 지정되지 않은 경우, 이것을 자동으로 얻습니다.
filename 매개 변수의 값은 파일의 이름입니다. 이 매개 변수는 export 및 import 명령에 의해 사용되어 토폴로지 데이터를 내보내고 가져옵니다.
isPolled 매개 변수의 값은 true 또는 false가 될 수 있습니다. 값이 true인 경우 엔티티는 폴링 유형(pollType)에 따라 상태 정보에 대해 폴링을 수행합니다. 기본값은 true입니다.
mode 매개 변수의 값은 append 또는 overwrite가 될 수 있습니다. 값이 append 인 경우, export 명령이 토폴로지 데이터를 파일의 끝에 추가합니다. 값이 overwrite인 경우, export 명령이 토폴로지 데이터를 사용하여 파일을 덮어 씁니다.
nodemode 매개 변수는 replace 또는 ignore가 될 수 있습니다. 파일 및 도메인의 데이터가 일치하지 않는 경우, replace 값이 도메인의 데이터를 파일의 데이터로 교체합니다. ignore 값은 데이터의 불일치를 무시합니다.
pollType 매개 변수의 값은 해당 엔티티에 대한 폴링 유형입니다. pollType 매개 변수에 허용되는 값은 다음과 같습니다.
url 매개 변수의 값은 폴링할 엔티티의 URL 입니다. url 매개 변수의 값은 다음 형식으로 지정할 수 있습니다.
ping://hostname snmp://hostname:port/oid/#.#.#.# snmp://hostname:port/[mod,sym]/path
validity 매개 변수의 값은 내보낸 토폴로지 데이터가 유효해지도록 하는 기간(수일 내)입니다. validity 매개 변수의 값은 Unlimited, 7, 15, 30 또는 90입니다.
writeInfo 매개 변수의 값은 SNMP 폴링 대상 개체에 대한 SNMPv1 쓰기 커뮤니티의 이름입니다.
설명
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]
매개변수
t, pollType, fullDesc , targetHost, agentPort, targetIp, family, isPolled, topoType, topoCfg, readInfo, writeInfo 및 url.
설명
createGroup 명령은 토폴로지 도메인 또는 그룹을 작성합니다.
구문
createGroup t=topoObject [family=base|building-view|campus-view|network-view|subnetwork-view] [fullDesc=desc]
매개변수
t, family 및 fullDesc .
생성할 엔티티가 그룹인 경우, family 매개 변수는 필수입니다.
설명
delTopoObject 명령은 관리 대상 토폴로지 계층의 관리 대상 토폴로지 개체를 삭제합니다. 지정된 토폴로지 개체 아래에 있는 모든 개체가 함께 삭제됩니다.
구문
delTopoObject t=topoObject
매개 변수
t
설명
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 명령은 토폴로지 도메인의 지정된 호스트에서 실행 중인 Sun Management Center 에이전트의 포트 번호를 반환합니다. 여러 에이전트가 존재하는 경우 포트 번호 목록이 반환됩니다.
구문
getAgentPort a=host[,host]* [t=topoObject]
매개변수
a 및 t.
설명
getAllTopoObjects 명령은 arch, family 또는 pollType 매개 변수에 의해 지정된 조건을 만족시키는 관리 대상 토폴로지 계층의 모든 관리 대상 개체 목록을 반환합니다.
구문
getAllTopoObjects t=topoObject [arch=os] [family=platform] [pollType=aview|ahost|amod|aprox|dummy|ping|snmp]
매개변수
t, arch, family 및 pollType.
설명
getCurrentDomain 명령은 현재 도메인의 이름을 반환합니다.
구문
getCurrentDomain
매개변수
없음
설명
getDomains 명령은 현재 서버 컨텍스트의 모든 관리 대상 도메인 목록을 반환합니다.
구문
getDomains
매개변수
없음
설명
getTopoObject 명령은 arch, family 또는 pollType 매개 변수에 의해 지정된 조건을 만족시키는 매개 변수 t에 의해 지정된 토폴로지 개체 아래에 바로 관리 대상 토폴로지 개체 목록을 반환합니다.
구문
getTopoObject t=topoObject [arch=os] [family=platform] [pollType=aview|ahost|amod|aprox|dummy|ping|snmp]
매개변수
t, arch, family 및 pollType.
설명
export 명령은 파일의 토폴로지 데이터를 도메인으로 가져옵니다.
구문
import filename=filename domainmode=follow|ignore nodemode=replace|ignore [domain=domain]
매개변수
filename, domainmode, nodemode 및 domain.
설명
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 |
CLI는 다음 출력 옵션을 제공합니다.
파일에 명령 실행을 기록합니다.
파일에 명령 출력을 기록합니다.
화면 상의 명령 출력 모양을 제어합니다.
출력을 일반 텍스트, XML 또는 HTML로 지정합니다.
모든 명령 및 로그 파일은 영어로만 사용할 수 있습니다. 그러나 명령 설명 및 도움말 텍스트는 영어 이외의 언어에 대한 Java 국제화 지침을 따릅니다.
기본 명령의 출력은 일반 텍스트로만 가능합니다. 기본 및 확장 명령의 설명은 CLI 명령 및 매개 변수 개요를 참조하십시오.
확장 명령의 출력은 다음 세 가지 형식이 가능합니다.
일반 텍스트
XML
HTML
출력 형식을 지정하려면 f 매개 변수를 원하는 형식의 값으로 설정합니다. 현재 지원되는 값은 plain , xml 및 html입니다.
height 매개 변수를 원하는 값으로 설정하여 명령 출력에 대한 논리적 화면 크기를 정의할 수 있습니다. 출력이 한 번에 하나의 화면에 표시되도록 more 매개 변수를 설정할 수 있습니다. 이러한 매개 변수의 설명은 미리 정의된 매개 변수 및 플래그를 참조하십시오.
다음 예는 일반 텍스트로 된 getLoadedModules 명령의 부분 출력입니다.
== getLoadedModules: Results 1/16 =============================== Module Name=Dynamic Reconfiguration Module Key=dr Description=Dynamic Reconfiguration (Sunfire) Agent Name=myhost-dev86 Agent Port=161 Version=2.0 == getLoadedModules: Results 2/16 =============================== Module Name=Config-Reader(sun4u/sun4d) Module Key=Config-Reader4u Description=Config Reader (sun4u/sun4d) Agent Name=myhost-dev86 Agent Port=161 Version=1.0 ... == getLoadedModules: Results 15/16 ============================== Module Name=DNS Synthetic Transaction [dns] Module Key=dnsST+dnstest Description=DNS Synthetic Transaction Agent Name=myhost-dev86 Agent Port=161 Version=1.0 ================================================================ |
CLI 명령을 로그 파일에 기록하려면 log 매개 변수를 명령을 기록할 파일의 이름으로 설정합니다. 실행을 위해 일괄 처리 모드에서 CLI에 로그 파일을 통과시키려면, logmode 매개 변수를 detailed, command 또는 from n으로 설정합니다. 세부 정보는 미리 정의된 매개 변수 및 플래그의 log 및 logmore를 참조하십시오.
로그 파일의 형식은 다음과 같습니다.
DATE & TIME;duration or message;command and parameters
다음 예는 이전의 getLoadedModules 명령 출력을 얻은 명령 시퀀스의 로그에서 발췌한 내용입니다.
Fri Dec 21 14:15:12 PST 2001;0 second;set o=\ /home/examples/output.3c23b455 Fri Dec 21 14:15:23 PST 2001;0 second;set f=plain Fri Dec 21 14:15:45 PST 2001;0 second;set a=smtg-dev21 Fri Dec 21 14:16:08 PST 2001;== START OF THREAD ==;getLoadedModules Fri Dec 21 14:16:08 PST 2001;2 seconds;getLoadedModules Fri Dec 21 14:16:12 PST 2001;9 seconds;print Fri Dec 21 14:21:28 PST 2001;== START OF THREAD ==;getAgentPort Fri Dec 21 14:21:28 PST 2001;0 second;getAgentPort Fri Dec 21 14:21:31 PST 2001;0 second;print Fri Dec 21 14:22:01 PST 2001;0 second;exit
설명
es-cli 명령은 CLI에 액세스하는 데 사용됩니다.
구문
es-cli [-h] [-b <filename> -i <parameter-filename>] [-i <parameter- filename>]
es-cli에 대한 매개 변수의 설명은 CLI 매개 변수를 참조하십시오.
지정된 옵션이 없는 경우, CLI는 세션 모드에서 실행됩니다.
이 절에서는 몇 가지 일반적인 CLI 프로시저에 대하여 설명합니다.
기본 /opt 디렉토리에 콘솔이 설치되지 않은 경우, CLI 응용프로그램이 실행되지 않습니다. 이런 경우, 다음 방법 중 하나를 사용하여 CLI 응용프로그램을 시작합니다.
설치 후, cli.properties 파일의 애드온 위치를 설치된 위치에 대한 올바른 지점으로 변경합니다.
/opt/SUNWsymon/cli/addons 디렉토리를 작성합니다.
대화형 세션을 시작하려면 /opt/SUNWsymon/sbin/es-cli 명령 다음에 원하는 전역 매개 변수를 입력합니다.
CLI 프롬프트(>)에 대한 응답으로 login을 입력합니다.
Host 프롬프트에 대한 응답으로 연결할 호스트의 이름을 입력합니다.
Login 및 Password 프롬프트에 대한 응답으로 로그인 이름과 암호를 입력합니다.
단계 1-4의 결과는 다음 예와 비슷합니다.
/opt/SUNWsymon/sbin/es-cli parameters > login Host: myhost Login: mylogin Password: mypassword Login is successful. > |
다음 명령을 사용하여 이전에 준비한 CLI 명령 파일을 입력으로 사용하여 일괄 처리 모드에서 CLI를 실행할 수 있습니다. /opt/SUNWsymon/sbin/es-cli -b file
Sun Management Center 콘솔 계층을 설치한 후에는 CLI 폴더에서 es-cli를 두 번 누릅니다.
CLI 화면이 표시됩니다.
login 명령을 입력합니다.
로그인 프로세스에서 사용자 로그인 이름 및 원하는 호스트 이름을 지정하라는 메시지를 표시합니다.
다음 예에서 seattle은 호스트이며 susan은 로그인 이름입니다.
> login Host: seattle Login: susan Password: > |
사용 가능한 모든 CLI 명령의 목록을 보려면 CLI 프롬프트에서 help를 입력합니다.
특정 명령에 대한 자세한 설명을 보려면 help 다음에 명령의 이름을 입력합니다.
예를 들어, getLoadedModules 명령에 대한 추가 도움말을 얻으려면 다음을 입력합니다.
> help getLoadedModules |
height 매개 변수를 표시할 줄의 수로 설정하여 화면 크기를 정의합니다.
예를 들어, 20줄의 화면을 정의하려면 다음을 입력합니다.
> set height=20 |
한 번에 한 페이지씩 출력을 볼 수 있게 하려면 more 매개 변수를 on으로 설정합니다.
> set more=on |
log 매개 변수를 명령을 기록할 파일의 이름으로 설정합니다.
> set log=/home/examples/log.3c254030 |
일단 log 매개 변수가 설정되면 모든 후속 명령은 파일에 추가됩니다. 이 파일이 존재하지 않으면 파일이 만들어집니다.
파일이 덮어쓰기가 되지 않으므로 새 레코드 집합을 원하는 경우 새 파일이 생성되는지 확인하십시오.
기록을 중지하려면 log 매개 변수와 함께 unset 명령을 사용하십시오.
> unset log |
명령 출력을 파일에 기록하려면 o 매개 변수를 출력 파일의 이름으로 설정합니다.
> set o=/home/examples/output.3c254030 |
기록을 중지하려면 o 매개 변수와 함께 unset 명령을 사용하십시오.
> unset o |
CLI 세션을 종료하려면 exit를 입력합니다.
> exit |