|
| Sun ONE Message Queue, 버전 3.0.1 관리자 설명서 |
이 부록에서는 플러그 인 지속성을 사용해서 JDBC로 액세스할 수 있는 데이터 저장소에 액세스하도록 브로커를 설정하는 방법을 설명합니다.
소개
Sun™ ONE Message Queue (MQ) 브로커에는 지속성 정보의 기록과 복원을 관리하는 지속성 관리자 구성 요소가 있습니다("지속성 관리자" 참조). 지속성 관리자는 기본적으로 기본 제공되는 파일 기반 데이터 저장소에 액세스하도록 구성되어 있지만 JDBC 호환 드라이버를 통해 액세스할 수 있는 데이터 저장소를 플러그 인으로 사용하도록 재구성할 수도 있습니다.
플러그 인 지속성을 사용하도록 브로커를 구성하려면 브로커 인스턴스 구성 파일에 JDBC 관련 등록 정보를 설정해야 합니다. MQ 지속성 작업을 수행할 수 있는 적절한 데이터베이스 스키마도 만들어야 합니다. MQ에는 JDBC 드라이버와 브로커 구성 등록 정보를 사용해서 플러그 인 데이터베이스를 만들고 관리하는 데이터베이스 관리자 유틸리티(imqdbmgr)가 제공됩니다.
이 부록에 설명된 절차에서는 Java 2 SDK Enterprise Edition과 함께 제공되는 Cloudscape DBMS를 사용하는 경우를 예로 들었습니다(J2EE SDK는 java.sun.com에서 다운로드 가능). 예에서는 (클라이언트/서버 버전 대신) Cloudscape에 내장된 버전을 사용합니다. 절차의 지침에는 Cloudscape 예에 있는 경로 이름과 등록 정보를 사용했습니다. 이러한 지침은 "예:"라는 말로 구분됩니다.
다른 예는 다음 위치에 있습니다.
IMQ_HOME/demo/jdbc (Solaris의 경우 /usr/demo/imq/jdbc)
JDBC로 액세스할 수 있는 데이터 저장소 플러그 인
JDBC로 액세스할 수 있는 데이터 저장소를 플러그 인하는 작업은 단 몇 단계로 이루어집니다.
JDBC로 액세스할 수 있는 데이터 저장소를 플러그 인하는 방법
- 브로커의 구성 파일에서 JDBC 관련 등록 정보를 설정합니다.
표 A-1에 설명된 등록 정보를 참조하십시오.
- 다음 경로에 JDBC 드라이버 jar 파일의 사본 또는 심볼릭 링크를 넣습니다.
IMQ_VARHOME/lib/ext (Solaris의 경우 /usr/share/lib/imq/ext/)
복사 예(Solaris):
% cp j2sdk_install_directory/lib/cloudscape/cloudscape.jar IMQ_VARHOME/lib/ext
심볼릭 링크 예(Solaris):
% ln -s j2sdk_install_directory/lib/cloudscape/cloudscape.jar IMQ_VARHOME/lib/ext
- MQ 지속성에 필요한 데이터베이스 스키마를 만듭니다.
imqdbmgr create all 명령(내장 데이터베이스의 경우) 또는 imqdbmgr create tbl 명령(외부 데이터베이스의 경우)을 사용합니다. "데이터베이스 관리자 유틸리티(imqdbmgr)"를 참조하십시오.
예:
% cd IMQ_HOME/bin (Solaris의 경우 /usr/bin)
% imqdbmgr create all
주 내장 데이터베이스를 사용하는 경우에는 데이터베이스를 다음 디렉토리에 만드는 것이 좋습니다.
내장 데이터베이스가 사용자 아이디와 비밀번호로 보호되지 않는 경우에는 파일 시스템 권한으로 보호합니다. 브로커에서 데이터베이스를 읽고 쓸 수 있도록 하려면 브로커를 실행하는 사용자가 imqdbmgr 명령을 사용해서 내장 데이터베이스를 만든 사용자와 같아야 합니다("데이터베이스 관리자 유틸리티(imqdbmgr)" 참조).
JDBC 관련 브로커 구성 등록 정보
브로커의 인스턴스 구성 파일은 다음 위치에 있습니다.
IMQ_VARHOME/instances/brokerName/props/config.properties
(Solaris의 경우 /var/imq/instances/brokerName/props/config.properties)파일이 아직 없는 경우에는 MQ에서 파일을 만들 수 있도록 -name brokerName 옵션을 사용해서 브로커를 시작해야 합니다.
표 A-1에는 JDBC로 액세스할 수 있는 데이터 저장소를 플러그 인할 때 설정해야 하는 구성 등록 정보가 있습니다. 이 등록 정보는 각 브로커 인스턴스의 구성 파일(config.properties)에서 플러그 인 지속성을 사용하여 설정합니다. 테이블에는 Cloudscape DBMS 예에 지정할 값이 포함되어 있습니다.
표 A-1 JDBC 관련 등록 정보
등록 정보 이름
설명
imq.persist.store
파일 기반 또는 JDBC 기반 데이터 저장소를 지정합니다.
예:
jdbc
imq.persist.jdbc.brokerid
(선택 사항)
같은 데이터베이스를 영구 데이터 저장소로 사용하고 있는 브로커 인스턴스가 두 개 이상인 경우 데이터베이스 테이블 이름에 추가하여 고유한 이름으로 만들어 주는 브로커 인스턴스 식별자를 지정합니다. (보통 한 브로커 인스턴스에 대해서만 데이터를 저장하는 내장 데이터베이스에는 필요 없습니다.) 식별자는 데이터베이스에 허용되는 최대 테이블 이름 길이에서 12를 뺀 길이를 넘지 않는 영문자 및 숫자 문자열이어야 합니다.
예: Cloudscape에는 필요 없음
imq.persist.jdbc.driver
데이터베이스에 연결할 JDBC 드라이버의 Java 클래스 이름을 지정합니다.
예:
COM.cloudscape.core.JDBCDriver
imq.persist.jdbc.opendburl
기존 데이터베이스에 대한 연결을 여는 데이터베이스 URL을 지정합니다.
예:
jdbc:cloudscape:IMQ_VARHOME/
instances/brokerName/dbstore/imqdb
(Solaris의 경우 jdbc:cloudscape:var/imq...)
imq.persist.jdbc.createdburl
(선택 사항)
데이터베이스를 만들기 위해 연결을 여는 데이터베이스 URL을 지정합니다. (imqdbmgr을 사용해서 데이터베이스를 만드는 경우에만 지정합니다.)
예:
jdbc:cloudscape:IMQ_VARHOME/
instances/brokerName/dbstore/
imqdb;create=true
(Solaris의 경우 jdbc:cloudscape:var/imq...)
imq.persist.jdbc.closedburl
(선택 사항)
브로커를 종료할 때 현재 데이터베이스 연결을 종료하는 데이터베이스 URL을 지정합니다.
예(Cloudscape에 필요):
jdbc:cloudscape:;shutdown=true
imq.persist.jdbc.user
(선택 사항)
필요한 경우 데이터베이스 연결을 열 때 사용되는 사용자 아이디를 지정합니다. 보안상의 이유로 명령줄 옵션을 사용해서 값을 지정할 수도 있습니다.
imqbrokerd -dbuser
및 imqdbmgr -uimq.persist.jdbc.needpassword
(선택 사항)
브로커에 액세스할 때 데이터베이스에 비밀번호가 필요한지 여부를 지정합니다. true 값은 비밀번호가 필요하다는 것을 의미합니다. 비밀번호는 다음과 같은 명령줄 옵션을 사용해서 지정할 수 있습니다.
imqbrokerd -dbpassword
imqdbmgr -p명령줄 옵션과 passfile ("Passfile 사용" 참조) 중 어느 것으로도 비밀번호를 제공하지 않은 경우 브로커는 비밀번호를 묻는 프롬프트를 표시합니다.
imq.persist.jdbc.password
(선택 사항)
필요한 경우 데이터베이스 연결을 열 때 사용되는 비밀번호를 지정합니다. passfile에만 지정될 수 있습니다("Passfile 사용" 참조). 보안을 강화하려면 브로커가 비밀번호를 묻는 프롬프트를 표시하게 하거나 다음 명령줄 옵션을 사용하여 비밀번호를 지정합니다.
imqbrokerd -dbpassword
imqdbmgr -p브로커 구성 등록 정보와 마찬가지로, -D 명령줄 옵션을 사용해서 값을 설정할 수 있습니다. 데이터베이스에 데이터베이스 특정 등록 정보를 설정해야 하는 경우에도 브로커(imqbrokerd) 또는 데이터베이스 관리자 유틸리티(imqdbmgr)를 시작할 때 -D 명령줄 옵션을 사용하여 설정할 수 있습니다.
예:
Cloudscape 내장 데이터베이스의 예에서는 데이베이스 연결 URL에 데이터베이스 절대 경로를 지정하는 대신(표 A-1 예 참조), -D 명령줄 옵션을 사용해서 Cloudscape 시스템 디렉토리를 정의할 수 있습니다.
-Dcloudscape.system.home=IMQ_VARHOME/instances/brokerName/dbstore
이 경우 데이터베이스를 만들고 여는 URL을 다음과 같이 간단하게 지정할 수 있습니다.
imq.persist.jdbc.createdburl=jdbc:cloudscape:imqdb;create=true
그리고
imq.persist.jdbc.opendburl=jdbc:cloudscape:imqdb
가 각각 적용됩니다.
데이터베이스 관리자 유틸리티(imqdbmgr)
MQ에는 지속성에 필요한 스키마를 설정하는 데이터베이스 관리자 유틸리티(imqdbmgr)가 포함되어 있습니다. 이 유틸리티는 테이블이 손상되거나 데이터 저장소로 다른 데이터베이스를 사용하는 경우에 MQ 데이터베이스 테이블을 삭제하는 용도로도 사용할 수 있습니다.
주 브로커 인스턴스가 비정상적으로 중단하면 참조되지 않은 지속성 정보가 데이터 저장소에 남을 수 있습니다. 브로커를 시작한 후 종료하면 보통은 데이터 저장소가 지워집니다.
이 절에서는 기본 imqdbmgr 명령 구문을 설명하고, 하위 명령 목록을 제공하고, imqdbmgr 명령 옵션을 요약합니다.
명령 구문
imqdbmgr 명령의 일반 구문은 다음과 같습니다.
imqdbmgr subcommand argument [options]
imqdbmgr -h|-help
imqdbmgr -v|-version-v 또는 -h 옵션을 지정하는 경우 명령줄에 지정된 하위 명령이 실행되지 않습니다. 예를 들어, 다음 명령을 입력하면 버전 정보는 표시되지만 create 하위 명령은 실행되지 않습니다.
imqdbmgr create all -v
imqdbmgr 하위 명령
데이터베이스 관리자 유틸리티(imqdbmgr)에는 표 A-2에 나열된 하위 명령이 포함되어 있습니다.
imqdbmgr 명령 옵션 요약
표 A-3에는 imqdbmgr 명령의 옵션이 나열되어 있습니다.