|
| Sun ONE Message Queue, 버전 3.0.1 관리자 설명서 |
이 장에서는 브로커 및 제공 서비스 관리에 관련된 작업을 수행하는 방법을 설명합니다. 작업 중 일부는 특정 클라이언트 응용 프로그램에 대해 독립적이며 다음이 포함됩니다.
- 브로커의 상태 제어: 브로커를 일시 중지하고, 다시 시작하고, 종료하고, 처음부터 다시 시작할 수 있습니다.
- 브로커 등록 정보 쿼리 및 업데이트
- 연결 서비스 쿼리 및 업데이트
- 자원 할당 및 관리
- 연결 서비스 관리
기타 브로커 작업은 특정 응용 프로그램을 대신하여 수행합니다. 여기에는 물리적 대상 관리, 영구 가입, 트랜잭션이 포함됩니다.
- MQ 메시지는 브로커 대상을 통해 수신기 또는 가입자에게 라우팅됩니다. 브로커에서 이러한 대상을 만드는 것은 관리자의 책임입니다.
- MQ는 영구 가입이 있는 클라이언트가 비활성화되어 있는 동안에도 영구 가입자의 자원을 할당 및 관리합니다. 영구 가입에 대한 정보를 얻고 영구 가입을 완전 삭제하거나 메시지를 제거하여 MQ 자원을 확보하려면 MQ 명령 도구를 사용합니다.
- MQ 트랜잭션과 분산 트랜잭션은 브로커에 의해 추적됩니다. 오류가 발생하면 트랜잭션을 수동으로 완결 또는 롤백해야 할 수도 있습니다.
이 장에서는 명령 유틸리티(imqcmd)를 사용해서 이 모든 작업을 수행하는 방법을 설명합니다. MQ 메시지 서버의 그래픽 인터페이스인 관리 콘솔을 사용하면 이와 같은 여러 작업을 수행할 수 있습니다. 자세한 내용은 4장, "관리 콘솔 자습서"를 참조하십시오.
명령 유틸리티
명령 유틸리티를 사용하면 브로커와 브로커가 제공하는 서비스를 관리할 수 있습니다. 이 절에서는 기본 imqcmd 명령 구문을 설명하고, 하위 명령 목록을 제공하고, imqcmd 옵션을 요약합니다. 다음 절에서는 이런 명령을 사용하여 특정 작업을 수행하는 방법에 대해 설명합니다.
명령 구문
imqcmd 명령의 일반 구문은 다음과 같습니다.
imqcmd subcommand argument [options]
imqcmd -h|H
imqcmd -v-v, -h 또는 -H 옵션을 지정하는 경우 명령줄에 지정된 하위 명령이 실행되지 않습니다. 예를 들어, 다음 명령을 입력하면 버전 정보는 표시되지만 restart 하위 명령은 실행되지 않습니다.
imqcmd restart bkr -v
imqcmd 하위 명령
명령 유틸리티(imqcmd)에는 표 6-1에 나열된 하위 명령이 포함되어 있습니다.
imqcmd 옵션 요약
표 6-2에 imqcmd 명령의 옵션이 나열되어 있습니다. 사용 설명은 다음의 작업 기반 절을 참조하십시오.
표 6-2 imqcmd 옵션
옵션
설명
-b hostName:port
브로커의 호스트 이름과 해당 포트 번호를 지정합니다. 기본값은 localhost:7676입니다.
포트만 지정하려면: -b :7878
이름만 지정하려면: -b somehost-c clientID
주제에 영구 가입의 아이디를 지정합니다. 자세한 내용은 "영구 가입 관리"를 참조하십시오.
-d topicName
주제의 이름을 지정합니다. list dur 및 destroy dur 하위 명령에 사용됩니다. "영구 가입 관리"를 참조하십시오.
-f
사용자의 확인 없이 작업을 수행합니다.
-h
사용 도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-H
사용 도움말, 속성 목록 및 예를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-int interval
imqcmd에서 브로커 메트릭을 표시하는 간격을 초 단위로 지정합니다. (metrics 하위 명령에 사용됩니다.)
-javahome
Java 2와 호환할 수 있는 대체 런타임을 지정하여 사용합니다(기본값은 제품과 함께 제공되는 런타임 사용).
-m metricType
표시할 메트릭 정보의 유형을 지정합니다. 유형은 다음 중 하나가 될 수 있습니다.
ttl 브로커 내부 및 외부의 모든 메시지(기본값)
rts ttl과 같은 정보를 제공하지만 초당 메시지 수를 지정합니다.
cxn 연결, 가상 메모리 힙, 스레드
이 옵션은 metrics bkr 또는 metrics svc 하위 명령에 사용됩니다. 다음 명령은 기본 브로커에 대해 5초마다 cxn 유형의 메트릭을 표시합니다.
imqcmd metrics bkr -m cxn -int 5
-n argumentName
하위 명령 인수의 이름을 지정합니다. 하위 명령에 따라 서비스나 물리적 대상, 영구 가입의 이름일 수도 있고 트랜잭션 아이디일 수도 있습니다.
-o attribute=value
속성의 값을 지정합니다. 하위 명령 인수에 따라 브로커("브로커 등록 정보 쿼리 및 업데이트" 참조), 서비스("연결 서비스 관리" 참조) 또는 대상("대상 관리" 참조)의 속성이 될 수 있습니다.
-secure
ssladmin 연결 서비스를 사용해서 브로커에 대한 보안 관리 연결을 지정합니다("명령 유틸리티(imqcmd)"에서 "4단계. SSL기반 클라이언트 구성 및 실행," 참조).
-p password
자신(관리자)의 비밀번호를 지정합니다. 이 값을 생략하면 값을 묻는 메시지가 표시됩니다.
-s
비대화형 모드입니다. 출력이 표시되지 않습니다.
-t destinationType
대상의 유형을 지정합니다. t (주제) 또는 q (대기열).
-tmp
임시 대상을 표시합니다.
-u name
자신(관리자)의 이름을 지정합니다. 이 값을 생략하면 값을 묻는 메시지가 표시됩니다.
-v
버전 정보를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
imqcmd 하위 명령을 실행할 때마다 호스트 이름 및 포트 번호(-b), 사용자 아이디 (-u), 비밀번호(-p), 보안 연결(-secure) 옵션을 지정해야 합니다. 호스트 이름과 포트 번호를 지정하지 않으면 기본값이 사용됩니다. 사용자 아이디 및 비밀번호 정보를 지정하지 않으면 입력 프롬프트가 표시됩니다. -secure를 지정하지 않으면 연결에 보안이 적용되지 않습니다.
imqcmd 사용의 전제 조건
imqcmd 명령을 사용해서 브로커를 관리하려면 다음을 수행해야 합니다.
- imqbrokerd 명령을 사용해서 브로커를 시작합니다.
"브로커 시작"를 참조하십시오. 명령 유틸리티는 이미 실행 중인 브로커의 관리에만 사용할 수 있으며 이 유틸리티를 사용해서 브로커를 시작할 수는 없습니다.
- 브로커가 로컬 호스트의 포트 7676에서 실행 중인 경우가 아니면 -b 옵션을 사용해서 대상 브로커를 지정합니다.
- 적절한 관리자 사용자 아이디와 비밀번호를 지정합니다. 이를 지정하지 않으면 입력 프롬프트가 표시됩니다. 어떤 방법을 사용해도, imqcmd를 사용해서 수행하는 모든 작업은 사용자 저장소에 대해 인증됩니다.
MQ를 설치하면 기본 플랫 파일 사용자 저장소가 설치됩니다. 파일의 이름은 IMQ_HOME/etc/passwd (Solaris의 경우 /etc/imq/passwd)입니다. 저장소에는 admin 사용자와 guest 사용자 각각에 대해 하나씩 두 개의 항목이 있습니다. 이러한 항목을 통해 추가 작업을 하지 않고도 브로커에 연결할 수 있습니다. 예를 들어, MQ를 테스트만 하는 경우에는 기본 사용자 아이디와 비밀번호(admin/admin)를 사용해서 유틸리티를 실행할 수 있습니다.
작업 시스템을 설정하는 경우에는 추가 작업을 통해 사용자를 인증하고 권한을 부여해야 합니다. 사용자 저장소에 기존 LDAP 디렉토리 서버를 사용할 수도 있습니다. 자세한 내용은 "사용자 인증"을 참조하십시오.
예
다음 명령은 localhost의 포트 7676에서 실행 중인 브로커의 등록 정보를 나열합니다.
imqcmd query bkr -u admin -p admin
다음 명령은 myserver의 포트 1564에서 실행 중인 브로커의 등록 정보를 나열합니다. 사용자 아이디는 alladin, 사용자 비밀번호는 abracadabra입니다.
imqcmd query bkr -b myserver:1564 -u alladin -p abracadabra
사용자 아이디 alladin이 admin 그룹에 할당되어 있으면 지정한 브로커에 admin 클라이언트로 연결할 수 있습니다.
브로커 상태 제어
브로커를 시작한 후에는 다음 imqcmd 하위 명령을 사용하여 브로커의 상태를 제어할 수 있습니다.
- 브로커 일시 중지
브로커를 일시 중지하면 브로커의 서비스 스레드가 지연되고 브로커에서는 포트 수신을 중지합니다. 그리고 나면 브로커에 대한 메시지의 흐름을 규제하는 관리 작업을 수행할 수 있습니다. 예를 들어, 특정 대상으로 메시지가 폭주하는 경우에는 브로커를 일시 중지한 후 메시지 소스 추적, 대상 크기 제한, 대상 완전 삭제 등의 작업 중 하나를 수행하여 문제 해결을 도울 수 있습니다.
다음 명령은 myhost의 포트 1588에서 실행 중인 브로커를 일시 중지합니다.
imqcmd pause bkr -b myhost:1588
- 브로커 다시 시작
브로커를 다시 시작하면 브로커의 서비스 스레드가 다시 활성화되고 브로커가 다시 포트 수신을 시작합니다. 다음 명령은 localhost의 포트 7676에서 실행 중인 브로커를 다시 시작합니다.
imqcmd resume bkr
- 브로커 종료
브로커를 종료하면 브로커 프로세스가 종료됩니다. 이것은 유예 기간이 있는 종료 방법으로, 브로커는 새 연결과 메시지의 수신을 멈추고, 기존 메시지의 전달을 완료한 다음 브로커 프로세스를 종료합니다. 다음 명령은 ctrlsrv의 포트 1572에서 실행 중인 브로커를 종료합니다.
imqcmd shutdown bkr -b ctrlsrv:1572
- 브로커를 처음부터 다시 시작
브로커를 종료한 후 처음부터 다시 시작합니다. 다음 명령은 localhost의 포트 7676에서 실행 중인 브로커를 처음부터 다시 시작합니다.
imqcmd restart bkr
표 6-3에서는 브로커의 제어에 사용되는 imqcmd 하위 명령을 요약합니다. localhost의 포트 7676에서 실행 중인 브로커가 대상이 아닌 경우에는 브로커 호스트 이름과 포트 번호를 지정해야 합니다.
브로커 등록 정보 쿼리 및 업데이트
명령 유틸리티에는 브로커에 대한 정보를 얻고 브로커 등록 정보를 업데이트할 때 사용할 수 있는 하위 명령이 포함되어 있습니다. 표 6-4에 이러한 하위 명령이 나열되어 있습니다.
표 6-4 정보를 얻고 브로커를 업데이트할 때 사용되는 imqcmd 하위 명령
하위 명령 구문
설명
query bkr -b hostName:port
기본 브로커 또는 지정한 호스트 및 포트의 브로커에 해당하는 현재 등록 정보 설정을 나열합니다. 지정한 브로커에 연결된 실행 중인 브로커(브로커가 여러 개인 클러스터에서)의 목록도 표시합니다.
reload cls
브로커 클러스터에만 적용됩니다. 클러스터에 있는 모든 브로커에서 imq.cluster.brokerlist 등록 정보를 다시 로드하고 클러스터 정보를 업데이트하도록 합니다. 자세한 내용은 "클러스터에 브로커 추가"를 참조하십시오.
update bkr [-b hostName:port]
-o attribute=value
[-o attribute=value1]...
기본 브로커 또는 지정한 호스트 및 포트의 브로커에 해당하는 지정된 속성을 변경합니다.
metrics bkr [-b hostName:port]
[-m metricType]
[-int interval]
기본 브로커 또는 지정한 호스트 및 포트의 브로커 메트릭을 표시합니다.
-m 옵션을 사용하여 표시할 메트릭 유형을 지정합니다.
ttl 브로커 내부 및 외부의 모든 메시지(기본값)
rts ttl과 같은 정보를 제공하지만 초당 메시지의 수를
지정합니다.cxn 연결, 가상 메모리 힙, 스레드
-int 옵션을 사용하여 메트릭 표시 간격(초)을 지정합니다. 기본값은 5초입니다.
localhost의 포트 7676에서 실행 중인 브로커가 대상이 아닌 경우에는 표 6-4에 나열된 하위 명령을 사용할 때 브로커 호스트 이름과 포트 번호를 지정해야 합니다.
브로커 쿼리
단일 브로커에 대한 정보를 쿼리 및 표시하려면 query 하위 명령을 사용합니다. 예를 들면 다음과 같습니다.
imqcmd query bkr
다음과 같은 출력이 표시됩니다.
%imqcmd query bkr
Querying the broker specified by:
-------------------------
Host Primary Port
-------------------------
localhost 7676
Auto Create Queues true
Auto Create Topics true
Auto Created Queue Delivery Policy Round Robin
Cluster Broker List (active) myhost/192.18.116.221:7676
Cluster Broker List (configured)
Cluster Master Broker
Cluster URL
Current Number of Messages in System 0
Current Size of Messages in System 0
Instance Name imqbroker
Log Level INFO
Log Rollover Interval (seconds) 604800
Log Rollover Size (bytes) 0 (unlimited)
Max Message Size 70m
Max Number of Messages in System 0 (unlimited)
Max Size of Messages in System 0 (unlimited)
Primary Port 7676
Version 3.0
Successfully queried the broker.
브로커 업데이트
update 하위 명령을 사용하면 표 6-5에 나열된 브로커 등록 정보를 업데이트할 수 있습니다. 브로커에서 업데이트된 사항은 브로커의 인스턴스 구성 파일에 자동으로 기록됩니다.
표 6-5 브로커 등록 정보
등록 정보
설명
imq.autocreate.queue
브로커에 대기열 대상 자동 작성이 허용되는지 여부를 지정합니다. 기본값은 True입니다.
imq.autocreate.topic
브로커에 주제 대상의 자동 작성이 허용되는지 여부를 지정합니다. 기본값은 True입니다.
imq.queue.deliverypolicy
자동 작성된 대기열의 기본 전달 정책을 지정합니다. 값은 s(단일), r(라운드 로빈) 또는 f(페일오버)입니다. 기본값은 s입니다.
imq.cluster.url
클러스터 구성 파일의 위치를 지정합니다. 자세한 내용은 "클러스터 구성 등록 정보"를 참조하십시오.
imq.log.level
로그 수준을 NONE, ERROR, WARNING, INFO 중 하나로 지정합니다. 기본값은 INFO입니다.
imq.log.file.rolloversecs
로그 파일을 롤오버할 때까지의 시간(초)입니다. 값 0은 파일 시간을 기준으로 한 롤오버가 없음을 의미합니다. 기본값은 604800 (7일)입니다.
imq.log.file.rolloverbytes
로그 파일을 롤오버하기 전에 최대 로그 파일 크기를 지정합니다. 값 0은 파일 크기를 기준으로 한 롤오버가 없음을 의미합니다. 기본값은 0입니다.
imq.message.max_size
메시지의 최대 크기를 바이트 단위로 지정합니다. 기본값은 70m입니다.
imq.system.max_count
메모리와 디스크의 최대 메시지 수를 지정합니다. 값 0은 제한이 없음을 의미합니다. 기본값은 0입니다.
imq.system.max_size
메모리와 디스크의 최대 전체 메시지 크기를 지정합니다. 값 0은 제한이 없음을 의미합니다. 기본값은 0입니다.
imq.portmapper.port
포트 매퍼 포트의 번호를 지정합니다. 기본값은 7676입니다.
예를 들어, 다음 명령은 대기열의 기본 전달 정책을 단일에서 라운드 로빈으로 변경합니다.
imqcmd update bkr -o "imq.queue.deliverypolicy=r"
연결 서비스 관리
명령 유틸리티에는 다음을 수행할 수 있는 여러 하위 명령이 포함되어 있습니다.
- 사용 가능한 연결 서비스를 나열합니다.
- 특정 서비스에 대한 정보를 표시합니다.
- 서비스의 속성을 업데이트합니다.
- 서비스를 일시 중지하고 다시 시작합니다.
MQ 연결 서비스에 대한 개요는 "연결 서비스"를 참조하십시오.
표 6-6에 연결 서비스를 제어하는 imqcmd 하위 명령이 나열되어 있습니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 localhost, 7676인 것으로 가정합니다.
표 6-6 연결 서비스 관리에 사용되는 imqcmd 하위 명령
하위 명령 구문
설명
list svc [-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 브로커에 있는 모든 연결 서비스를 나열합니다.
metrics svc -n serviceName
[-b hostName:port]
[-m metricType] [-int interval]
기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 지정된 서비스의 메트릭을 나열합니다.
-m 옵션을 사용하여 표시할 메트릭 유형을 지정합니다.
ttl 브로커 내부 및 외부의 모든 메시지(기본값)
rts ttl과 같은 정보를 제공하지만 초당 메시지 수를 지정합니다.
cxn 연결, 가상 메모리 힙, 스레드
-int 옵션을 사용하여 메트릭 표시 간격(초)을 지정합니다. 기본값은 5초입니다.
query svc -n serviceName
[-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 서비스에서 실행 중인, 지정된 서비스에 대한 정보를 표시합니다.
pause svc -n serviceName
[-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 실행 중인, 지정된 서비스를 일시 중지합니다. 관리 서비스는 일시 중지할 수 없습니다.
resume svc -n serviceName
[-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트에서 실행 중인, 지정된 서비스를 다시 시작합니다.
update svc -n serviceName
[-b hostName:port]
-o attribute=value
[-o attribute=value1]...
기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 실행 중인, 지정된 서비스의 지정된 속성을 업데이트합니다. 서비스 속성에 대한 설명은 표 6-8을 참조하십시오.
브로커는 응용 프로그램 클라이언트 및 관리 클라이언트 모두와의 통신을 지원합니다. 현재 MQ 브로커에서 사용할 수 있는 연결 서비스가 표 6-7에 표시되어 있습니다. 서비스 이름 열에 있는 값은 -n 옵션의 서비스 이름을 지정할 때 사용되는 값입니다.
(표에 있는 것과 같이 각 서비스는 NORMAL (JMS) 또는 ADMIN 중에서 사용하는 서비스 유형과 전송 계층에 따라 지정됩니다.)
연결 서비스 나열
브로커에서 사용할 수 있는 연결 서비스를 나열하려면 다음과 같은 명령을 사용합니다.
imqcmd list svc [-b hostName:portNumber]
예를 들어, 다음 명령은 MyServer 호스트의 포트 6565에서 실행 중인 브로커에서 사용할 수 있는 서비스를 나열합니다.
imqcmd list svc -b MyServer:6565
다음 명령은 localhost의 포트 7676에서 실행 중인 브로커의 모든 서비스를 나열합니다.
imqcmd list svc
이 명령은 다음과 같은 정보를 출력합니다.
Listing all the services on the broker specified by:
Host Primary Port
localhost 7676
Service Name Port Number Service State
admin 33984 (dynamic) RUNNING
httpjms UNKNOWN
httpsjms - UNKNOWN
jms 33983 (dynamic) RUNNING
ssladmin dynamic UNKNOWN
ssljms dynamic UNKNOWN
Successfully listed services.
서비스 등록 정보 쿼리 및 업데이트
단일 서비스에 대한 정보를 쿼리 및 표시하려면 query 하위 명령을 사용합니다. 예를 들면 다음과 같습니다.
imqcmd query svc -n jms
다음과 같은 출력이 표시됩니다.
Querying the service where:
Service Name
jms
On the broker specified by:
Host Primary Port
localhost 7676
Current Number of Allocated Threads 120
Current Number of Connections 20
Max Number of Threads 1000
Min Number of Threads 50
Port Number 42019 (dynamic)
Service Name jms
Service State RUNNING
Successfully queried the service.
update 하위 명령을 사용해서 표 6-8에 나열된 서비스 속성 중 하나 이상을 변경할 수 있습니다.
표 6-8 연결 서비스 속성
속성
설명
port
업데이트할 서비스에 할당된 포트입니다(httpjms 또는 httpsjms에는 적용되지 않음).
minThreads
서비스에 할당된 최소 스레드 수입니다.
maxThreads
서비스에 할당된 최대 스레드 수입니다.
다음 명령은 jms 서비스에 할당된 최소 스레드 수를 20으로 변경합니다.
imqcmd update svc -n jms -o "minThreads=20"
서비스 일시 중지 및 다시 시작
관리 서비스(일시 중지 불가)를 제외한 다른 서비스를 일시 중지하려면 다음과 같은 명령을 사용합니다.
imqcmd pause svc -n serviceName
서비스를 다시 시작하려면 다음과 같은 명령을 사용합니다.
imqcmd resume svc -n serviceName
대상 관리
모든 MQ 메시지는 특정 브로커에 작성되는 대상, 대기열 및 주제를 통해 사용자 클라이언트로 라우팅됩니다. 브로커에서 이러한 대상을 관리하는 것은 관리자의 책임입니다. 여기에는 명령 유틸리티를 사용해서 대상을 만들고 완전 삭제하고, 대상을 나열하고, 대상 관련 정보를 표시하고, 메시지를 제거하는 작업이 해당됩니다. 대상에 대한 소개는 "물리적 대상"을 참조하십시오.
표 6-9에서는 imqcmd 대상 하위 명령을 요약합니다. 기본(localhost:7676) 브로커가 아닌 경우 브로커의 호스트 이름과 포트를 지정해야 합니다.
표 6-9 대상 관리에 사용되는 imqcmd 하위 명령
하위 명령
설명
list dst [-tmp]
대상을 모두 나열합니다. 임시 대상을 함께 나열할 수도 있습니다("임시 대상" 참조).
create dst -t type
-n destName
[-o attribute=value]
[-o attribute=value1]...
지정한 유형의 대상을 지정한 이름과 지정한 속성을 사용하여 만듭니다. 대상 이름은 영문자와 숫자만 포함할 수 있으며(공백 없음) 영문자 또는 "_" 문자로 시작할 수 있습니다.
destroy dst -t type
-n destName
지정한 유형과 이름의 대상을 완전 삭제합니다.
purge dst -t type
-n destName
지정한 유형과 이름의 대상에서 메시지를 제거합니다.
query dst -t type
-n destName
지정한 유형과 이름의 대상에 대한 정보를 나열합니다.
update dst -t type
-n destName
-o attribute=value
[-o attribute=value1]...
지정한 대상에서 지정한 속성의 값을 업데이트합니다.
속성 이름에는 표 6-10에 설명된 속성을 사용할 수 있습니다.
대상 만들기
대상을 만들 때에는 유형(주제 또는 대기열)을 지정하고, 필요한 경우 대상의 속성 값을 지정해야 합니다. 이 속성의 기본값은 브로커의 구성 파일("구성 파일" 참조)에서 설정합니다.
대상을 완전 삭제하면 대상에 있는 모든 메시지가 제거되고 대상이 브로커에서 제거됩니다. 이 작업은 다시 되돌릴 수 없습니다.
표 6-10에서는 대상을 만들 때 각 대상 유형에 설정할 수 있는 속성에 대해 설명합니다.
- 대기열 대상을 만들려면 다음과 같이 명령을 입력합니다.
imqcmd create dst -n myQueue -t q -o "queueDeliveryPolicy=f"
대상 이름은 유효한 Java 식별자여야 합니다.
- 주제 대상을 만들려면 다음과 같이 명령을 입력합니다.
imqcmd create dst -n myTopic -t t -o "maxBytesPerMsg=5000"
대상 관련 정보 얻기
대상 속성의 현재 값에 대한 정보를 얻으려면 다음과 같은 명령을 사용합니다.
imqcmd query dst -t q -n XQueue
그런 다음 update imqcmd 하위 명령을 사용해서 하나 이상의 속성 값을 변경할 수 있습니다.
myHost의 포트 4545에서 실행 중인 브로커와 같은 특정 브로커의 모든 대상을 나열하려면 다음과 같은 명령을 사용합니다.
imqcmd list dst -b myHost:4545
선택에 따라 list 명령에 임시 대상을 포함할 수도 있습니다(-tmp 옵션 사용). 이러한 임시 대상은 다른 클라이언트로 보낸 메시지의 답장을 받는 대상이 필요한 클라이언트 응용 프로그램에서 만듭니다("임시 대상" 참조). 이 대상은 사용자가 완전 삭제할 수 없습니다. 이 대상은 활성 메시지 사용자가 더 이상 없을 때 클라이언트 응용 프로그램에서 수행한 API 호출을 통해서만 완전 삭제할 수 있습니다.
대상 업데이트
update dst 하위 명령에 업데이트할 속성을 지정하는 -o 옵션을 사용하여 대상의 속성을 변경할 수 있습니다. 업데이트할 속성이 두 개 이상인 경우에는 -o 옵션을 두 번 이상 사용할 수 있습니다. 예를 들어, 다음 명령은 maxBytesPerMsg 속성을 1000으로 변경하고 MaxNumMsgs 속성을 2000으로 변경합니다.
imqcmd update dst -t q -n myQueue -o "maxBytesPerMsg=1000"
-o maxNumMsgs=2000업데이트할 수 있는 속성의 목록을 보려면 표 6-10을 참조하십시오.
update dst 하위 명령을 사용해서 대상의 유형을 업데이트하거나 대기열의 대기열 전달 정책을 업데이트할 수 없습니다.
대상 제거
현재 대상의 대기열에 들어 있는 모든 메시지를 제거할 수 있습니다. 대상을 제거하는 것은 물리적 대상의 대기열에 들어 있는 모든 메시지를 삭제하는 것을 의미합니다. 대상에 누적된 메시지가 시스템의 자원을 너무 많이 차지하는 경우에 메시지를 제거할 수 있습니다. 이런 상황은 대기열에 등록된 사용자 클라이언트가 없는 상태에서 너무 많은 메시지를 받으면 발생할 수 있습니다. 주제의 비활성 영구 가입자가 활성화되지 않는 경우에도 발생할 수 있습니다. 두 경우 모두 불필요한 메시지가 보존됩니다.
대상에서 메시지를 제거하려면 다음과 같이 명령을 입력합니다.
imqcmd purge dst -n myQueue -t q
imqcmd purge dst -n myTopic -t t
브로커를 종료했다가 다시 시작할 때 오래된 메시지가 전달되지 않게 하려면 imqbrokerd 명령의 reset 하위 명령을 사용해서 오래된 메시지를 제거합니다. 예를 들면 다음과 같습니다.
imqbrokerd -reset messages
그러면 브로커를 다시 시작한 후에 대상을 제거할 필요가 없습니다.
대상 완전 삭제
대상을 완전 삭제하려면 다음과 같이 명령을 입력합니다.
imqcmd destroy dst -t q -n myQueue
영구 가입 관리
imqcmd 하위 명령을 사용해서 브로커의 영구 가입을 관리할 수 있습니다. 영구 가입은 클라이언트에 영구로 등록된 주제에 가입하는 것입니다. 여기에는 고유한 아이디가 있으며, 사용자가 비활성 상태인 동안에도 브로커에서 가입에 해당하는 메시지를 보존해야 합니다. 보통 브로커는 메시지가 만료될 때 영구 가입자에 대해 보존된 메시지만 삭제할 수 있습니다.
표 6-12에서는 imqcmd 영구 가입 하위 명령을 요약합니다. 기본(localhost:7676) 브로커가 아닌 경우 브로커의 호스트 이름과 포트를 지정해야 합니다.
표 6-11 영구 가입 관리에 사용되는 imqcmd 하위 명령
하위 명령
설명
list dur -d destination
지정한 대상의 모든 영구 가입을 나열합니다.
destroy dur -n subscrName
-c client_id
지정한 클라이언트 식별자에 해당하는 지정된 영구 가입을 완전 삭제합니다("클라이언트 식별자" 참조).
purge dur -n subscrName
-c client_id
지정한 클라이언트 식별자에 해당하는 모든 메시지를 제거합니다("클라이언트 식별자" 참조).
예를 들어, 다음 명령은 SPQuotes 주제의 모든 영구 가입을 나열합니다.
imqcmd list dur -d SPQuotes
list 하위 명령은 주제의 각 영구 가입에 대해 영구 가입의 이름과 사용자의 클라이언트 아이디, 이 주제의 대기열에 들어 있는 메시지의 수, 영구 가입 상태(활성/비활성)를 반환합니다. 예를 들면 다음과 같습니다.
Listing all the durable subscriptions on the topic myTopic
on the broker specified by:
-------------------------
Host Primary Port
-------------------------
localhost 7676
Name Client ID Number of Durable Sub
Messages State
----------------------------------------------------------------
myDurable myClientID 1 INACTIVE
Successfully listed durable subscriptions.
list 명령에서 반환된 정보를 사용하여 완전 삭제하거나 메시지를 제거할 영구 가입을 확인할 수 있습니다. 가입 이름과 클라이언트 아이디를 사용하여 가입을 확인합니다. 예를 들면 다음과 같습니다.
imqcmd destroy dur -n myDurable -c myClientID
트랜잭션 관리
클라이언트 응용 프로그램에서 시작하는 모든 트랜잭션은 브로커에서 추적됩니다. 이는 단순한 MQ 트랜잭션일 수도 있고 XA 자원 관리자가 관리하는 분산 트랜잭션일 수도 있습니다("로컬 트랜잭션" 참조). 모든 트랜잭션에는 브로커의 트랜잭션을 고유하게 나타내는 64비트 숫자, 즉 MQ 트랜잭션 아이디가 있습니다. 분산 트랜잭션에도 분산 트랜잭션 관리자가 할당하는 최대 128 바이트의 분산 트랜잭션 아이디(XID)가 있습니다. MQ에서는 MQ 트랜잭션 아이디와 XID 사이의 연결을 보존합니다.
분산 트랜잭션에 오류가 발생하면 그 트랜잭션은 PREPARED 상태로 남아 완결되지 않을 수도 있습니다. 따라서 관리자는 준비된 상태로 남아 있는 트랜잭션을 모니터하고 롤백 또는 완결해야 합니다.
표 6-12에서는 imqcmd 트랜잭션 하위 명령을 요약합니다. 기본(localhost:7676) 브로커가 아닌 경우 브로커의 호스트 이름과 포트를 지정해야 합니다.
예를 들어, 다음 명령은 브로커에 있는 모든 트랜잭션을 나열합니다.
imqcmd list txn
list 하위 명령은 각 트랜잭션에 대해 트랜잭션 아이디, 상태, 사용자 아이디, 메시지 또는 확인 응답의 수, 작성 시간을 반환합니다. 예를 들면 다음과 같습니다.
Listing all the transactions on the broker specified by:
-------------------------
Host Primary Port
-------------------------
localhost 7676
---------------------------------------------------------------
Transaction ID State User name # Msgs/ Creation time
# Acks
---------------------------------------------------------------
64248349708800 PREPARED guest 4/0 1/30/02 10:08:31 AM
64248371287808 PREPARED guest 0/4 1/30/02 10:09:55 AM
Successfully listed transactions.
명령은 브로커에 있는 로컬 및 분산 트랜잭션을 모두 표시합니다. PREPARED 상태인 트랜잭션만을 완결 또는 롤백할 수 있습니다. 트랜잭션이 오류로 인해 준비 상태에 있고 분산 트랜잭션 관리자에서 완결을 진행하고 있지 않다는 것이 확인된 경우에만 완결 또는 롤백할 수 있습니다.
예를 들어, 브로커의 자동 롤백 등록 정보가 false로 설정되어 있으면(표 2-4 참조) 브로커를 시작할 때 PREPARED 상태인 트랜잭션을 수동으로 완결 또는 롤백해야 합니다.
list 하위 명령도 트랜잭션에서 생성된 메시지의 수와 트랜잭션에서 확인 응답된(#Msgs/#Acks) 메시지의 수를 표시합니다. 트랜잭션이 완결될 때까지는 이런 메시지가 전달되지 않으며 확인 응답이 처리되지도 않습니다.
query 하위 명령을 사용하면 같은 정보와 클라이언트 아이디, 연결 아이디, 분산 트랜잭션 아이디(XID) 등의 여러 추가 값을 볼 수 있습니다. 예를 들면 다음과 같습니다.
imqcmd query txn -n 64248349708800
다음과 같이 출력됩니다.
Querying the transaction where:
-------------------------
Transaction ID
-------------------------
64248349708800
On the broker specified by:
-------------------------
Host Primary Port
-------------------------
localhost 7676
Client ID
Connection guest@192.18.116.219:62209->jms:62195
Creation time 1/30/02 10:08:31 AM
Number of acknowledgements 0
Number of messages 4
State PREPARED
Transaction ID 64248349708800
User name guest
XID
6469706F6C7369646577696E6465723130313234313431313030373230
Successfully queried the transaction.
commit 및 rollback 하위 명령은 분산 트랜잭션을 완결 또는 롤백할 때 사용할 수 있습니다. 앞에서 설명한 것과 같이, PREPARED 상태에 있는 트랜잭션만 완결 또는 롤백할 수 있습니다. 예를 들면 다음과 같습니다.
imqcmd commit txn -n 64248349708800
브로커를 시작할 때 PREPARED 상태에 있는 트랜잭션을 자동으로 롤백하도록 브로커를 구성할 수도 있습니다. 자세한 내용은 표 2-4의 imq.transaction.autorollback 등록 정보를 참조하십시오.