Sun Java 로고     이전      목차      색인      다음     

Sun 로고
Sun Java System Message Queue 3 2005Q1 관리 설명서 

8장
관리 대상 객체 관리

관리 대상 객체를 사용하면 다른 JMS 공급자에 이식할 수 있는 클라이언트 응용 프로그램을 개발할 수 있습니다. 관리 대상 객체는 공급자별 구성 및 이름 지정 정보를 캡슐화합
니다.

Message Queue 관리자는 일반적으로 클라이언트 응용 프로그램이 브로커에 연결하는 데 사용하는 관리 대상 객체를 만듭니다. 클라이언트 응용 프로그램은 연결을 사용하여 물리적 대상과 메시지를 주고 받습니다.

이 장에서는 객체 관리자 유틸리티(imqobjmgr)를 사용해서 이런 작업을 수행하는 방법을 설명합니다. 이 작업을 수행하려면 사용할 객체 저장소와 만들 관리 대상 객체의 속성을 이해하고 있어야 하므로 이 장에서 imqobjmgr을 사용하여 관리 대상 객체를 관리하는 방법을 설명하기 전에 이 두 항목에 대한 배경 정보를 제공합니다.

이 장은 다음 내용으로 구성되어 있습니다.

객체 저장소 정보

관리 대상 객체는 클라이언트 응용 프로그램에서 JNDI 조회를 통해 액세스할 수 있도록 미리 만들어진 객체 저장소에 있습니다. 사용할 수 있는 객체 저장소의 유형에는 표준 LDAP 디렉토리 서버 또는 파일 시스템 객체 저장소의 두 가지가 있습니다.

LDAP 서버 객체 저장소

LDAP 서버는 작업 메시징 시스템에 권장되는 객체 저장소입니다. LDAP 구현은 여러 공급업체에서 제공하며 분산 시스템에서 사용할 수 있도록 디자인되어 있습니다. LDAP 서버는 작업 환경에 유용한 보안 기능도 제공합니다.

Message Queue 관리 도구는 LDAP 서버의 객체 저장소를 관리할 수 있습니다. 그러나 먼저 LDAP 서버 설명서에 나와 있는 대로 java 객체를 저장하고 JNDI 조회를 수행하도록 LDAP 서버를 구성해야 합니다.

LDAP 서버를 객체 저장소로 사용하는 경우 표 8-1에 나와 있는 속성들을 지정해야 합니다. 이 속성들은 다음 범주로 구분됩니다.

파일 시스템 객체 저장소

Message Queue에서는 파일 시스템 객체 저장소 구현도 지원합니다. 파일 시스템 객체 저장소는 완전히 테스트되지 않았기 때문에 작업 시스템에는 권장되지 않지만, 개발 환경에서는 매우 사용하기가 쉽다는 장점이 있습니다. LDAP 서버를 설정할 필요 없이 로컬 파일 시스템에 디렉토리를 만들기만 하면 됩니다.

그러나 클라이언트가 여러 컴퓨터 노드에 배포된 경우 이 클라이언트들이 객체 저장소가 위치한 디렉토리에 액세스할 수 없으면 파일 시스템 저장소를 중앙 집중식 객체 저장소로 사용할 수 없습니다. 또한 해당 디렉토리에 액세스할 수 있는 모든 사용자는 Message Queue 관리 도구를 사용하여 관리 대상 객체를 만들고 관리할 수 있습니다.

파일 시스템 객체 저장소를 사용하는 경우 표 8-2에 나와 있는 속성들을 지정해야 합니다. 이 속성들은 다음 범주로 구분됩니다.

관리 대상 객체 속성 정보

Message Queue 관리 대상 객체에는 기본적으로 다음과 같은 두 가지 종류가 있습니다.

Message Queue에는 관리 대상 객체를 만들고 관리할 때 사용되는 두 개의 관리 도구가 있습니다. 하나는 명령줄 객체 관리자 유틸리티(imqobjmgr)이고 다른 하나는 GUI 관리 콘솔입니다. 이 장에서는 명령줄을 사용하는 방법에 대해서만 설명합니다.

관리 대상 객체의 속성은 속성-값 쌍을 사용해서 지정합니다.

연결 팩토리 속성

연결 팩토리 구성은 연결 팩토리가 클라이언트 응용 프로그램을 대신하여 만드는 모든 연결에 전달됩니다. 메시지를 보내거나 받을 때 포함되는 대상을 정의하고 클라이언트 런타임에서 메시지 흐름을 처리하는 방법을 지정하며 연결을 통해 보낸 모든 메시지에 대한 특정 정보를 자동으로 설정하도록 연결을 구성합니다.

연결 팩토리 객체에는 다음과 같은 두 가지 유형이 있습니다.

ConnectionFactory와 XAConnectionFactory 객체는 동일한 속성 집합을 공유합니다.

연결 팩토리 객체는 관리자 또는 응용 프로그램(프로토타입 제작 또는 테스트용)에서 만들고 구성할 수 있습니다. imqobjmgr 도구 또는 관리 콘솔을 사용하여 연결 팩토리 속성을 설정합니다.

이 절에서는 연결 팩토리 속성에 대해 설명하며 속성의 영향을 받는 동작을 기준으로
다음 내용으로 구성됩니다.

여기에서 주로 고려해야 할 속성은 imqAddressList로 클라이언트가 연결을 설정할 브로커를 지정하는 데 사용됩니다. 연결 팩토리 추가에서는 객체 저장소에 연결 팩토리 관리 대상 객체를 추가할 때 속성을 지정하는 방법을 설명합니다.

연결 팩토리 속성에 대한 자세한 내용은 16장, "관리 대상 객체 속성 참조" 및 JavaDoc API 설명서의 Message Queue 클래스 com.sun.messaging.ConnectionConfiguration 부분을 참조하십시오.

연결 처리

연결 처리 속성을 사용하여 연결할 메시지 서버 주소를 지정하고 다시 연결해야 하는 경우 재연결 시도 횟수와 시도 간격을 지정합니다.

클라이언트는 imqAddressList 속성 값으로 지정된 메시지 서버 주소에 있는 메시지 서버에 연결합니다. 메시지 서버 주소는 브로커 호스트 이름, 포트 번호 및 연결 서비스 유형으로 구성됩니다.

포트 번호는 브로커의 포트 매퍼가 있는 포트 또는 특정 연결 서비스가 있는 포트입니다. 포트 매퍼 포트를 지정하면 포트 매퍼가 연결 포트 번호를 동적으로 할당합니다. 메시지 서버 주소 지정에 대한 자세한 내용은 imqAddressList 속성 값 구문을 참조하십시오.

자동 재연결

단일 브로커 환경이나 멀티 브로커 클러스터 환경에서 연결이 실패할 경우 클라이언트가 브로커에 자동으로 다시 연결하도록 해주는 연결 처리 속성을 설정할 수 있습니다. 재연결 프로세스를 구성할 수도 있습니다.

재연결 기능에서는 연결 페일오버는 제공하지만 데이터 페일오버는 제공하지 않으므로 클라이언트가 다른 브로커 인스턴스에 다시 연결되는 경우 실패했거나 연결이 끊어진 브로커에 보관된 지속성 메시지 및 기타 상태 정보는 손실될 수 있습니다.

자동 재연결이 가능한 경우 Message Queue는 연결에 실패하면 클라이언트가 다시 연결하여 액세스할 수 있기 때문에 임시 대상을 지속합니다. 클라이언트가 다시 연결하여 이러한 대상을 사용할 수 있는 시간을 준 다음 브로커는 해당 대상을 삭제합니다.

재연결 처리 방법은 클라이언트가 단일 브로커에 연결되는지 클러스터에 속한 브로커에 연결되는지에 따라 달라집니다. 다음 절에서는 이러한 각각의 가능성에 대해 설명합니다.

단일 브로커에 재연결     연결에 실패할 경우 클라이언트가 브로커에 자동으로 다시 연결하게 하려면 다음과 같은 연결 팩토리 속성을 설정합니다.

이러한 속성에 대한 자세한 내용은 연결 처리를 참조하십시오.

클러스터 내의 브로커에 재연결     멀티 브로커 클러스터 환경에서 imqAddressList 속성에 여러 주소를 지정한 경우 브로커 목록을 통해 자동 재연결이 반복됩니다. 목록에 있는 모든 브로커가 Message Queue Enterprise Edition을 설치해야 합니다.

목록의 첫 번째 주소에 대한 클라이언트 연결이 실패할 경우 클라이언트 런타임은 클라이언트를 목록의 다른 브로커에 다시 연결하려고 시도합니다. 이 시도도 실패할 경우 클라이언트 런타임은 클라이언트를 다시 연결할 수 있을 때까지 목록에 있는 브로커를 차례로 연결합니다.

모든 시도가 실패할 경우 사용 가능한 브로커를 찾거나 찾기에 실패할 때까지 클라이언트 런타임은 목록을 지정된 횟수만큼 순환합니다. imqAddressListBehavior 속성 설정에 따라 다시 연결할 때 주소 목록에 제공된 주소 순서로 다음 브로커를 선택할지 아니면 해당 목록에서 임의로 선택할지 여부를 결정합니다.

클라이언트가 클러스터 내의 브로커에 다시 연결하게 하려면 다음 속성을 사용합니다.

이러한 속성에 대한 자세한 내용은 연결 처리를 참조하십시오.

연결 핑

imqPingInterval 속성은 클라이언트 런타임에서 브로커로의 핑 작업 빈도를 지정합니다. 클라이언트 런타임은 연결을 주기적으로 테스트하여 실패한 연결을 우선적으로 감지할 수 있습니다. 핑 작업이 실패할 경우 클라이언트 런타임은 클라이언트 응용 프로그램의 예외 수신기 객체에 대해 예외를 발생시킵니다. 응용 프로그램에 예외 수신기가 없는 경우 응용 프로그램의 다음 연결 사용 시도가 실패합니다.

메시지 수신을 대기하는 동안 메시지를 보내지 않는 사용자 클라이언트 응용 프로그램에서는 반드시 핑을 사용해야 합니다. 그러한 응용 프로그램에서 핑을 사용하지 않을 경우 연결이 실패해도 알 수 없습니다. 또한 이 기능을 사용하면 실패한 연결을 미리 처리하게 되어 메시지를 보낼 필요가 없어지므로 클라이언트가 메시지를 거의 생성하지 않아도 된다는 장점이 있습니다.

기본적으로 핑 간격은 30초로 설정됩니다. 값을 -1로 설정하면 핑 작업을 안 하게 됩니다.

끊어진 연결에 대한 응답은 운영 체제별로 다릅니다. 예를 들어, 일부 운영 체제에서는 핑마다 실패를 즉시 보고하기도 하고 다른 운영 체제에서는 핑이 성공하거나 버퍼 오버플로가 발생할 때까지 연속적으로 핑을 버퍼링하여 브로커에 대한 연결을 계속해서 시도하기도 합니다.

imqPingInterval 속성에 대한 자세한 내용은 연결 처리를 참조하십시오.

클라이언트 아이디

Message Queue는 영구 가입자에게 필요한 고유 클라이언트 아이디 설정과 클라이언트 인증을 지원하도록 연결 팩토리 속성 집합을 정의합니다.

브로커 연결을 시도하는 클라이언트는 인증되어야 합니다. 클라이언트가 연결할 때 아이디 또는 비밀번호를 지정하지 않을 경우 다음 중 하나가 발생합니다.

이 인증 방법에서는 모든 사용자의 연결을 허용하므로 개발 및 테스트 작업에 편리합니다. 작업 시스템에서는 사용자 저장소에 추가된 사용자로 연결 액세스를 제한해야 합니다.

연결을 요청하는 클라이언트의 브로커 인증 이외에 JMS 사양에서는 클라이언트에 대한 상태를 유지하도록 연결 시 고유 클라이언트 식별자를 제공해야 합니다. Message Queue에서는 클라이언트 아이디를 사용하여 영구 가입자를 추적합니다. 영구 가입자가 비활성 상태인 경우 브로커는 해당 가입자에 대한 메시지를 보관하였다가 가입자가 다시 활성화되면 메시지를 전달합니다. 브로커는 클라이언트 아이디로 가입자를 식별합니다.

클라이언트 아이디는 사용자가 관리상 설정하거나 클라이언트가 프로그래밍 방식으로 설정할 수 있습니다. 여러 클라이언트가 동일한 연결 팩토리 객체로부터 연결하는 경우 연결 팩토리에 대한 클라이언트 아이디를 설정합니다. 그러면 Message Queue가 해당 팩토리로부터 설정되는 각 연결에 대해 고유한 클라이언트 아이디를 제공할 수 있습니다.

고유한 클라이언트 아이디 값을 보장하려면 다음과 같은 형식으로 imqConfiguredClientID 속성을 설정합니다.

imqConfiguredClientID=${u}string

${u}는 속성 값의 처음 네 문자입니다. "u" 이외의 문자가 있는 경우 연결할 때 JMS 예외가 발생합니다.

string 값은 이 연결 팩토리에서 생성된 연결과 연관시킬 수 있는 모든 값(예: Xconn)입니다. 사용자 인증 단계에서 Message Queue는 u를 u:userName으로 대체합니다. 예를 들어, 연결에 연관된 사용자가 Athena이고 연결에 지정된 문자열이 ${u}Xconn인 경우 클라이언트 아이디는 u:AthenaXconn이 됩니다.

이 방법을 사용하면 모든 다른 방법과 마찬가지로 연결 팩토리에 의해 생성되는 연결마다 고유한 클라이언트 아이디를 갖게 됩니다.

이 방법이 적용되지 않는 한 가지 경우는 두 클라이언트가 guest와 같은 기본 아이디를 사용하여 연결하는 경우로 각 클라이언트는 동일한 ${u} 구성 요소가 있는 클라이언트 아이디를 갖게 됩니다. 런타임에서는 MQ가 고유하지 않은 클라이언트 아이디로 연결을 생성할 수 없으므로 연결을 먼저 요청하는 클라이언트는 연결되지만 나중에 요청하는 클라이언트는 연결되지 않습니다.

연결 팩토리를 사용하는 클라이언트가 구성된 클라이언트 아이디를 프로그래밍 방식으로 변경하지 못하도록 imqDisableSetClientID 속성을 설정할 수 있습니다.

응용 프로그램 코드에서 setClientId() 메소드를 사용하지 않는 경우 영구 가입을 위해 imqConfiguredClientID 속성을 설정해야 합니다.

요컨대 다음은 클라이언트 아이디에 영향을 미치는 속성입니다.

이러한 속성에 대한 자세한 내용은 클라이언트 아이디를 참조하십시오.

안정성 및 흐름 제어

클라이언트가 주고 받는 메시지와 Message Queue에 사용되는 제어 메시지는 동일한 클라이언트-브로커 연결을 통해 전달됩니다. 따라서 JMS 메시지 전달에 의해 브로커 확인과 같은 제어 메시지가 일시적으로 중단되어 전달이 지연될 수 있습니다.

클라이언트 메시지의 흐름에 따라 제어 메시지의 흐름을 관리할 수 있도록 연결 팩토리 속성을 설정할 수 있습니다. 두 가지 유형의 메시지 흐름 제어는 안정성과 처리 능력의 절충과 관련됩니다. 이러한 속성을 사용하여 흐름 제어와 안정성을 관리하는 방법은 클라이언트 런타임 메시지 흐름 조정을 참조하십시오.

다음 속성은 클라이언트 및 제어 메시지의 흐름에 영향을 줍니다.

이러한 속성에 대한 자세한 내용은 안정성 및 흐름 제어를 참조하십시오.

대기열 브라우저 동작 및 서버 세션

클라이언트 대기열 찾아보기에 영향을 주는 속성은 다음과 같습니다.

이러한 속성에 대한 자세한 내용은 대기열 브라우저 동작 및 서버 세션을 참조하십시오.

JMS 정의 등록 정보 지원

연결 팩토리 속성을 사용하여 연결에서 생성하는 메시지에 대한 JMS 정의 등록 정보를 자동으로 설정할 수 있습니다. JMS 등록 정보는 http://java.sun.com/products/jms/docs.html에 있는 JMS 사양에 정의됩니다.

다음 속성을 사용하여 JMS 정의 등록 정보를 설정합니다.

이러한 속성에 대한 자세한 내용은 JMS 정의 등록 정보 지원을 참조하십시오.

메시지 헤더 무시

연결 팩토리 속성을 설정하여 메시지의 지속성, 수명 및 우선 순위를 지정하는 JMS 메시지 헤더 필드를 무시할 수 있습니다. 이러한 설정은 연결 팩토리에서 가져온 연결에서 생성된 모든 메시지에 사용됩니다.

다음 JMS 필드의 값은 무시할 수 있습니다.

이러한 필드에 대한 자세한 내용은 http://java.sun.com/products/jms/docs.html의 JMS 사양을 참조하십시오.

메시지 헤더를 무시하면 응용 프로그램 요구 사항에 위배될 수 있으므로 이 기능을 사용할 경우 응용 프로그램 사용자 또는 설계자와 반드시 상의하십시오.

다음 목록에는 메시지 무시를 처리하는 연결 팩토리 속성이 포함되어 있습니다. 이러한 속성은 대부분 쌍으로 구성됩니다. 각 쌍에서 첫 번째 속성은 지정된 헤더 필드를 무시할 수 있는지 여부를 지정하고 두 번째 속성은 무시하는 값을 지정합니다.

이러한 속성에 대한 자세한 내용은 메시지 헤더 무시를 참조하십시오.

대상 관리 대상 객체 속성

물리적 주제 또는 대기열 대상을 나타내는 대상 관리 대상 객체는 표 16-1에 나열된 것과 같은 속성을 갖습니다. 주제 또는 대기열 추가 절에서는 객체 저장소에 대상 관리 대상 객체를 추가할 때 이런 속성을 지정하는 방법을 설명합니다.

여기에서 주로 고려해야 할 속성은 imqDestinationName입니다. 이 속성은 주제 또는 대기열 관리 대상 객체에 해당하는 물리적 대상에 지정하는 이름입니다. 대상에 설명을 입력해 두면 여러 응용 프로그램을 지원하기 위해 만드는 다른 대상과 구분하기가 쉽습니다.

자세한 내용은 JavaDoc API 설명서에서 Message Queue 클래스 com.sun.messaging.DestinationConfiguration 부분을 참조하십시오.

객체 관리자 유틸리티(imqobjmgr) 사용

객체 관리자 유틸리티를 사용하면 Message Queue 관리 대상 객체를 만들고 관리할 수 있습니다. 이 유틸리티를 사용하여 다음 작업을 수행할 수 있습니다.

imqobjmgr 명령의 구문, 하위 명령 및 옵션에 대한 자세한 내용은 13장, "명령 참조"를 참조하십시오. 다음 절에서는 imqobjmgr 하위 명령으로 작업할 때 제공해야 하는 정보에 대해 설명합니다.

필요한 정보

관리 대상 객체와 관련된 대부분의 작업을 수행할 때 imqobjmgr 하위 명령의 옵션으로 다음 정보를 지정해야 합니다.

명령 파일 사용

imqobjmgr 명령을 사용하면 imqobjmgr 하위 명령 절의 일부 또는 전부에 Java 등록 정보 파일 구문을 사용하는 명령 파일의 이름을 지정할 수 있습니다.

객체 관리자 유틸리티(imqobjmgr)에 명령 파일을 사용하면 여러 imqobjmgr 실행에서 동일하게 사용되면서 입력할 내용이 많은 객체 저장소 속성을 지정할 때 유용합니다. 명령 파일을 사용하면 명령줄에 허용된 최대 문자 수를 초과하는 상황을 방지할 수도 있습니다.

imqobjmgr 명령 파일의 일반 구문은 다음과 같습니다(버전 등록 정보는 Message Queue 제품이 아니라 명령 파일의 버전을 나타내며(명령줄 옵션이 아님), 그 값을 2.0으로 설정해야 함).

 

 version=2.0

 cmdtype=[ add | delete | list | query | update ]

 obj.type=[ q | t | qf | tf | cf | xqf | xtf | xcf | e ]

 obj.lookupName=lookup name

 obj.attrs.objAttrName1=value1

 obj.attrs.objAttrName2=value2

 obj.attrs.objAttrNameN=valueN

 ...

 objstore.attrs.objStoreAttrName1=value1

 objstore.attrs.objStoreAttrName2=value2

 objstore.attrs.objStoreAttrNameN=valueN

 ...

 

아래에서는 imqobjmgr 명령을 예로 들어 명령 파일의 사용 방법을 설명합니다.

 

imqobjmgr add

       -t qf

       -l "cn=myQCF"

        -o "imqAddressList=mq://foo:777/jms"

       -j "java.naming.factory.initial=

                com.sun.jndi.ldap.LdapCtxFactory"

       -j "java.naming.provider.url=

                ldap://mydomain.com:389/o=imq"

       -j "java.naming.security.principal=

                uid=fooUser, ou=People, o=imq"

       -j "java.naming.security.credentials=fooPasswd"

       -j "java.naming.security.authentication=simple"

 

이 명령은 다음과 같은 내용을 가진 MyCmdFile과 같은 파일에 캡슐화할 수 있습니다.

 

    version=2.0

    cmdtype=add

    obj.type=qf

    obj.lookupName=cn=myQCF

    obj.attrs.imqAddressList=mq://foo:777/jms

    objstore.attrs.java.naming.factory.initial=\

       com.sun.jndi.ldap.LdapCtxFactory

    objstore.attrs.java.naming.provider.url=\

       ldap://mydomain.com:389/o=imq

   objstore.attrs.java.naming.security.principal=\

       uid=fooUser, ou=People, o=imq

   objstore.attrs.java.naming.security.credentials=fooPasswd

   objstore.attrs.java.naming.security.authentication=simple

 

-i 옵션을 사용하면 이 파일을 객체 관리자 유틸리티(imqobjmgr)로 전달할 수 있습니다.

imqobjmgr -i MyCmdFile

명령 파일에 몇 가지 옵션을 지정하고 명령줄을 사용해서 또 다른 옵션을 지정할 수도 있습니다. 이 경우 하위 명령 절 중 유틸리티가 실행될 때마다 동일하게 유지되는 부분을 지정하는 데 명령 파일을 사용할 수 있습니다. 예를 들어, 다음 명령은 관리 대상 객체의 저장 위치를 제외하고 연결 팩토리 관리 대상 객체를 추가할 때 필요한 모든 옵션을 지정합니다.

 

imqobjmgr add

       -t qf

      -l "cn=myQCF"

       -o "imqAddressList=mq://foo:777/jms"

       -i MyCmdFile

 

이 경우 MyCmdFile 파일에는 다음과 같은 정의가 포함됩니다.

 

    version=2.0

    objstore.attrs.java.naming.factory.initial=\

       com.sun.jndi.ldap.LdapCtxFactory

    objstore.attrs.java.naming.provider.url=\

       ldap://mydomain.com:389/o=imq

   objstore.attrs.java.naming.security.principal=\

       uid=fooUser, ou=People, o=imq

   objstore.attrs.java.naming.security.credentials=fooPasswd

   objstore.attrs.java.naming.security.authentication=simple

 

다음 위치에서 명령 파일의 예를 추가로 확인할 수 있습니다.

관리 대상 객체 추가 및 삭제

이 절에서는 연결 팩토리 및 주제 또는 대기열 대상의 관리 대상 객체를 객체 저장소에 추가하는 방법을 설명합니다.

주

객체 관리자 유틸리티(imqobjmgr)는 Message Queue 관리 대상 객체만을 나열하고 표시합니다. 객체 저장소에 추가할 관리 대상 객체와 동일한 조회 이름을 가진 비 Message Queue 객체를 포함해야 하는 경우에 이 객체를 추가하려고 하면 오류 메시지가 표시됩니다.

연결 팩토리 추가

클라이언트 응용 프로그램에서 브로커에 대한 연결을 설정할 수 있게 하려면 클라이언트 응용 프로그램에서 원하는 연결 유형(주제 연결 팩토리 또는 대기열 연결 팩토리)을 나타내는 관리 대상 객체를 추가합니다.

대기열 연결 팩토리를 추가하려면 다음과 같은 명령을 사용합니다.

 

imqobjmgr add

 -t qf

 -l "cn=myQCF"

 -o "imqAddressList=mq://myHost:7272/jms"

 -j "java.naming.factoryinitial=

       com.sun.jndi.ldap.LdapCtxFactory"

 -j  "java.naming.provider.url=ldap://mydomain.com:389/o=imq"

 -j "java.naming.security.principal=

    uid=fooUser, ou=People, o=imq"

 -j "java.naming.security.credentials=fooPasswd"

 -j "java.naming.security.authentication=simple"

 

이전 명령은 조회 이름이 cn=myQCF이고 myHost에서 실행 중인 브로커에 연결하여 포트 7272를 수신하는 관리 대상 객체를 만듭니다. 관리 대상 객체는 LDAP 서버에 저장됩니다. imqobjmgr 명령의 인수로 명령 파일을 지정해도 같은 결과를 얻을 수 있습니다. 자세한 내용은 명령 파일 사용을 참조하십시오.

주

이름 지정 규약: LDAP 서버를 사용하여 관리 대상 객체를 저장할 경우 위 예에서처럼 접두어 "cn="에 있는 조회 이름을 지정해야 합니다(cn=myQCF). -l 옵션을 사용하여 조회 이름을 지정합니다. 파일 시스템 객체 저장소를 사용하는 경우 cn 접두어를 사용할 필요가 없습니다. 그러나 "/"가 포함된 조회 이름은 사용하지 마십시오. 표 8-3을 참조하십시오.

표 8-3 이름 지정 규약 예

객체 저장소 유형

올바른 이름

잘못된 이름

LDAP 서버

cn=myQCF

myQCF

파일 시스템

myTopic

myObjects/myTopic

주제 또는 대기열 추가

클라이언트 응용 프로그램에서 브로커의 물리적 대상에 액세스할 수 있게 하려면 이 대상에 해당하는 관리 대상 객체를 객체 저장소에 추가합니다.

객체 저장소에 해당 관리 대상 객체를 추가하기 전에 물리적 대상을 먼저 만드는 것이 좋습니다. 명령 유틸리티(imqcmd)를 사용하여 브로커에 객체 저장소의 대상 관리 대상 객체에 해당하는 물리적 위치를 만듭니다. 물리적 대상을 만드는 자세한 내용은 연결 정보 얻기를 참조하십시오.

다음 명령은 조회 이름이 myTopic이고 물리적 대상 이름이 TestTopic인 주제 대상에 해당하는 관리 대상 객체를 추가합니다. 관리 대상 객체는 LDAP 서버에 저장됩니다.

 

    imqobjmgr add

    -t t

    -l "cn=myTopic"

    -o "imqDestinationName=TestTopic"

    -j "java.naming.factory.initial=

      com.sun.jndi.ldap.LdapCtxFactory"

    -j "java.naming.provider.url=

      ldap://mydomain.com:389/o=imq"

    -j "java.naming.security.principal=

        uid=fooUser, ou=People, o=imq"

    -j "java.naming.security.credentials=fooPasswd"

    -j "java.naming.security.authentication=simple"

 

같은 명령이지만 관리 대상 객체만 Solaris 파일 시스템에 저장됩니다.

 

imqobjmgr add

      -t t

      -l "cn=myTopic"

      -o "imqDestinationName=TestTopic"

      -j "java.naming.factory.initial=

       com.sun.jndi.fscontext.RefFSContextFactory"

      -j "java.naming.provider.url=

       file:///home/foo/imq_admin_objects"

 

예를 들어, LDAP 서버 사례에서 명령 파일 MyCmdFile을 사용하여 하위 명령 절을 지정할 수 있습니다. 파일에는 다음과 같은 텍스트가 포함됩니다.

 

    version=2.0

    cmdtype=add

    obj.type=t

    obj.lookupName=cn=myTopic

    obj.attrs.imqDestinationName=TestTopic

    objstore.attrs.java.naming.factory.initial=

      com.sun.jndi.fscontext.RefFSContextFactory

    objstore.attrs.java.naming.provider.url=

      file:///home/foo/imq_admin_objects

   objstore.attrs.java.naming.security.principal=

      uid=fooUser, ou=People, o=imq

   objstore.attrs.java.naming.security.credentials=fooPasswd

   objstore.attrs.java.naming.security.authentication=simple

 

-i 옵션을 사용해서 해당 파일을 imqobjmgr 명령에 전달합니다.

imqobjmgr -i MyCmdFile

주

LDAP 서버를 사용하여 관리 대상 객체를 저장할 경우 위 예에서처럼 접두어 "cn="이 있는 조회 이름을 지정해야 합니다. -l 옵션을 사용하여 조회 이름을 지정합니다. 파일 시스템 객체 저장소를 사용하는 경우 이 접두어를 사용하지 않아도 됩니다.

-t 옵션에 q를 지정한다는 점만 제외하면 대기열 객체를 추가하는 것도 이와 같습니다.

관리 대상 객체 삭제

관리 대상 객체를 삭제하려면 delete 하위 명령을 사용합니다. 객체의 조회 이름과 유형, 위치를 지정해야 합니다.

다음 명령은 조회 이름이 cn=myTopic이고 LDAP 서버에 저장되는 주제의 관리 대상 객체를
삭제합니다.

 

imqobjmgr delete

    -t t

    -l "cn=myTopic"

    -j "java.naming.factory.initial=

      com.sun.jndi.ldap.LdapCtxFactory"

    -j "java.naming.provider.url=

      ldap://mydomain.com:389/o=imq"

  -j "java.naming.security.principal=

        uid=fooUser, ou=People, o=imq"

  -j "java.naming.security.credentials=fooPasswd"

  -j "java.naming.security.authentication=simple"

 

관리 대상 객체 나열

모든 관리 대상 객체의 목록을 보거나 특정 유형에 해당하는 모든 관리 대상 객체의 목록을 보려면 list 하위 명령을 사용합니다. 다음 샘플 코드에서는 관리 대상 객체가 LDAP 서버에 저장되어 있다고 가정합니다.

다음 명령은 모든 객체를 나열합니다.

 

imqobjmgr list

  -j "java.naming.factory.initial=

      com.sun.jndi.ldap.LdapCtxFactory"

  -j "java.naming.provider.url=

      ldap://mydomain.com:389/o=imq"

  -j "java.naming.security.principal=

        uid=fooUser, ou=People, o=imq"

  -j "java.naming.security.credentials=fooPasswd"

  -j "java.naming.security.authentication=simple"

 

다음 명령은 queue 유형의 모든 객체를 나열합니다.

 

imqobjmgr list

 -t q

 -j "java.naming.factory.initial=

      com.sun.jndi.ldap.LdapCtxFactory"

 -j "java.naming.provider.url=

      ldap://mydomain.com:389/o=imq"

 -j "java.naming.security.principal=

        uid=fooUser, ou=People, o=imq"

 -j "java.naming.security.credentials=fooPasswd"

 -j "java.naming.security.authentication=simple"

 

단일 객체 관련 정보 얻기

특정 관리 대상 객체에 대한 정보를 얻으려면 query 하위 명령을 사용합니다. 객체의 조회 이름과 관리 대상 객체를 포함하는 객체 저장소의 속성(초기 컨텍스트, 위치 등)을 지정해야 합니다.

다음 예에서는 query 하위 명령을 사용하여 조회 이름이 cn=myTopic인 객체에 관련된 정보를 표시합니다.

 

imqobjmgr query

 -l "cn=myTopic"

 -j "java.naming.factory.initial=

     com.sun.jndi.ldap.LdapCtxFactory"

 -j "java.naming.provider.url=

      ldap://mydomain.com:389/o=imq"

 -j "java.naming.security.principal=

      uid=fooUser, ou=People, o=imq"

 -j "java.naming.security.credentials=fooPasswd"

  -j "java.naming.security.authentication=simple"

 

관리 대상 객체 업데이트

관리 대상 객체의 속성을 수정하려면 update 명령을 사용합니다. 조회 이름과 객체 위치를 지정해야 합니다. 속성 값을 수정하려면 -o 옵션을 사용합니다.

이 명령은 주제 연결 팩토리를 나타내는 관리 대상 객체의 속성을 변경합니다.

 

imqobjmgr update

-t tf

-l "cn=MyTCF"

-o imqReconnectAttempts=3

-j "java.naming.factory.initial=

    com.sun.jndi.ldap.LdapCtxFactory"

-j "java.naming.provider.url=

    ldap://mydomain.com:389/o=imq"

-j "java.naming.security.principal=

    uid=fooUser, ou=People, o=imq"

-j "java.naming.security.credentials=fooPasswd"

-j "java.naming.security.authentication=simple"

 



이전      목차      색인      다음     

부품 번호: 819-2218.   Copyright 2005 Sun Microsystems, Inc. 모든 권리는 저작권자의 소유입니다.