test

Sun Java System Application Server Enterprise Edition 8.1 2005Q2 관리 설명서

4장 JMS(Java Message Service) 자원 구성

이 장에서는 JMS(Java Message Service) API를 사용하는 응용 프로그램의 자원 구성 방법에 대해 설명합니다. 이 장은 다음 내용으로 구성되어 있습니다.

JMS 자원 정보

Application Server의 JMS 공급자

Application Server는 Sun Java System Message Queue(이전의 Sun ONE Message Queue) 소프트웨어를 Application Server에 통합하여 JMS(Java Message Service) API를 구현합니다. 기본적인 JMS API 관리 작업에는 Application Server 관리 콘솔을 사용합니다. Message Queue 클러스터 관리를 포함한 고급 작업에는 MQ-install-dir/imq/bin 디렉토리에 제공된 도구를 사용합니다.

Message Queue 관리에 대한 자세한 내용은 Message Queue 관리 설명서를 참조하십시오.

JMS 자원

JMS(Java Message Service) API에서는 두 종류의 관리 대상 객체를 사용합니다.

이러한 객체는 관리상의 목적으로 만들며 객체를 만드는 방법은 JMS 구현마다 다릅니다. Application Server에서 다음 작업을 수행합니다.

JMS 응용 프로그램에서는 JNDI API를 사용하여 연결 팩토리와 대상 자원에 액세스합니다. JMS 응용 프로그램은 대개 최소한 연결 팩토리 하나와 대상 하나를 사용합니다. 만들 자원을 알아보려면 응용 프로그램을 살펴보거나 응용 프로그램 개발자에게 문의하십시오.

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

대상에는 다음과 같은 두 가지 종류가 있습니다.

J2EE 1.4 Tutorial의 JMS 장에서는 이 두 가지 통신 유형과 JMS의 기타 요소를 자세히 설명합니다(http://java.sun.com/j2ee/1.4/docs/tutorial/doc/index.html 참조).

자원을 만드는 순서는 상관이 없습니다.

2EE 응용 프로그램의 경우 Application Server 배포 설명자에서 다음과 같이 연결 팩토리와 대상 자원을 지정합니다.

JMS 자원과 커넥터 자원 간의 관계

Application Server는 jmsra라고 하는 시스템 자원 어댑터를 사용하여 JMS를 구현합니다. 사용자가 JMS 자원을 만들면 Application Server가 커넥터 자원을 자동으로 만들며 이는 관리 콘솔의 트리 보기에 있는 커넥터 노드에 표시됩니다.

사용자가 만든 JMS 연결 팩토리마다 Application Server가 커넥터 연결 풀과 연결 자원을 만듭니다. 사용자가 만든 JMS 대상마다 Application Server가 관리 객체 자원을 만듭니다. 사용자가 JMS 자원을 삭제하면 Application Server에서 커넥터 자원을 자동으로 삭제합니다.

JMS 자원 노드 대신 관리 콘솔의 커넥터 노드를 사용하여 JMS 시스템 자원 어댑터에 대한 커넥터 자원을 만들 수 있습니다. 자세한 내용은 7 장, 커넥터 자원을 참조하십시오.

JMS 연결 팩토리의 관리 콘솔 작업

ProcedureJMS 연결 팩토리 자원을 만드는 방법

  1. 트리 구성 요소에서 자원 노드를 확장한 다음 JMS 자원 노드를 확장합니다.

  2. 연결 팩토리 노드를 선택합니다.

  3. JMS 연결 팩토리 페이지에서 새로 만들기를 누릅니다.

    JMS 연결 팩토리 만들기 페이지가 나타납니다.

  4. JNDI 이름 필드에서 연결 팩토리 이름을 입력합니다.

    JMS 자원에 대해 이름 지정 하위 컨텍스트 접두어 jms/ 를 사용하는 것이 좋습니다. 예를 들면 다음과 같습니다. jms/ConnectionFactory1

  5. 유형 드롭다운 목록에서 javax.jms.ConnectionFactory , javax.jms.QueueConnectionFactory 또는 javax.jms.TopicConnectionFactory를 선택합니다.

  6. 런타임에서 자원을 활성화하려면 사용 가능 확인란을 선택합니다.

  7. 고급 영역에서 연결 팩토리 속성에 필요한 대로 값을 변경합니다.

    이 속성에 대한 자세한 내용은 JMS 연결 팩토리 자원을 편집하는 방법을 참조하십시오. Application Server는 연결 팩토리용으로 만든 커넥터 연결 풀에 이 속성을 적용합니다.

  8. JMS 연결 팩토리 자원에 대해 다음과 같이 트랜잭션 지원 값을 지정합니다.

    • 트랜잭션 범위 내에서 두 개 이상의 자원 사용이 요구되는 트랜잭션에 사용할 수 있는 자원에 대해 XATransaction(기본값)을 지정합니다.

      예를 들어, 이 자원과 JDBC 자원, 커넥터 자원 또는 JMS 연결 팩토리 자원입니다. 이 값은 최고의 융통성을 제공합니다. XATransaction으로 구성된 자원은 2단계 커밋 작업에 참여합니다.

    • 트랜잭션 범위 내에서 한 자원만 필요로 하는 트랜잭션에 사용하거나 두 개 이상의 XA 자원이 필요한 분산 트랜잭션의 마지막 에이전트로 사용할 수 있는 자원에 대해 LocalTransaction을 지정합니다.

      이 값을 사용하면 성능이 훨씬 향상됩니다. LocalTransaction으로 구성된 자원은 2단계 커밋 작업에 사용되지 않습니다.

    • 트랜잭션에 절대 참여할 수 없는 자원에 대해 NoTransaction을 지정합니다.

      이 설정은 JMS 응용 프로그램에서 제한적으로 사용됩니다.

  9. 추가 등록 정보 영역에서 응용 프로그램에 필요한 등록 정보 값을 제공합니다. 다음 표에서는 사용 가능한 등록 정보를 나열합니다.

    등록 정보 이름 

    설명 

    ClientId

    영구 가입자가 사용하는 연결 팩토리에 대해 클라이언트 아이디를 지정합니다. 

    AddressList

    응용 프로그램이 통신하는 인스턴스 또는 메시지 브로커 인스턴스의 이름(필요에 따라 포트 번호)을 지정합니다. 목록의 각 주소는 연결에 대한 호스트 이름(필요에 따라 호스트 포트와 연결 서비스)을 지정합니다. 예를 들어, 값은 earth 또는 earth:7677이 될 수 있습니다. 기본값(7676) 이외의 포트에서 메시지 브로커를 실행할 경우 포트 번호를 지정합니다.클러스터링된 환경에서 등록 정보 설정이 여러 호스트 및 포트를 지정할 경우 AddressListBehavior 등록 정보가 RANDOM으로 설정되어 있지 않는 한, 목록에서 사용 가능한 첫 번째 호스트가 사용됩니다.

    자세한 내용은 Java 클라이언트용 Message Queue 개발자 안내서를 참조하십시오.

    기본값: 로컬 호스트 및 기본 포트 번호(7676)입니다. 클라이언트는 로컬 호스트의 포트 7676에서 브로커에 연결을 시도합니다. 

    MessageServiceAddressList

    AddressList와 동일합니다. 이 등록 정보 이름은 더 이상 사용되지 않습니다. 대신 AddressList를 사용합니다.

    UserName

    연결 팩토리에 대한 사용자 이름입니다. 

    기본값: guest

    Password

    연결 팩토리에 대한 비밀번호입니다. 

    기본값: guest

    ReconnectEnabled

    활성화한 경우(값 = true), 연결이 끊어지면 클라이언트 런타임에서 메시지 서버(또는 AddressList의 주소 목록)에 다시 연결하도록 지정합니다.

    기본값: true 

    ReconnectAttempts

    클라이언트 런타임에서 AddressList 의 주소에 연결(또는 재연결)을 몇 번 시도한 후 목록에 있는 다음 주소로 연결을 시도하는지를 지정합니다. 값 -1은 재연결 시도 횟수에 제한이 없음을 나타냅니다. 클라이언트 런타임은 성공할 때까지 첫 번째 주소에 연결을 시도합니다.

    기본값: 3 

    ReconnectInterval

    재연결 시도 간 간격(밀리초)을 지정합니다. AddressList의 각 주소에 대한 재연결 시도와 목록의 연속된 주소에 이 값이 적용됩니다. 간격이 너무 짧을 경우 브로커가 복구할 시간이 없습니다. 너무 길 경우에는 지연이 지나치게 길게 느껴질 수 있습니다.

    기본값: 30000 

    AddressListBehavior

    연결 시도가 AddressList 속성의 주소 순서(PRIORITY)인지 임의의 순서(RANDOM)인지 지정합니다.

    RANDOM은 재연결할 때 AddressList에서 임의의 주소를 선택한다는 것을 의미합니다. 여러 클라이언트에서 동일한 연결 팩토리를 사용하여 연결할 가능성이 큰 경우 이 값을 사용하면 모든 클라이언트가 동일한 주소에 연결하는 것을 방지할 수 있습니다.

    PRIORITY는 재연결 시 항상 AddressList의 첫 번째 서버 주소에 연결하고 첫 번째 브로커를 사용할 수 없는 경우에만 다른 주소를 사용한다는 것을 의미합니다.

    기본값: RANDOM

    AddressListIterations

    연결을 설정하거나 재설정할 때 클라이언트 런타임이 AddressList를 반복하는 횟수를 지정합니다. 값 -1은 횟수에 제한이 없음을 나타냅니다.

    기본값: 3 

  10. 대상 영역에서 다음 작업을 수행합니다.

    1. 사용 가능한 열에서 배포할 자원을 사용하는 응용 프로그램에 해당하는 대상을 선택합니다.

      사용 가능한 대상은 기본 서버 인스턴스인 server 뿐만 아니라 사용 가능한 클러스터 및 서버 인스턴스를 포함합니다.

    2. 추가를 눌러 대상을 선택한 열로 이동합니다.

  11. 확인을 눌러 연결 팩토리를 저장합니다.

해당 asadmin 명령

create-jms-resource

ProcedureJMS 연결 팩토리 자원을 편집하는 방법

  1. 트리 구성 요소에서 자원 노드를 확장한 다음 JMS 자원 노드를 확장합니다.

  2. 연결 팩토리 노드를 확장합니다.

  3. 편집할 연결 팩토리를 선택합니다.

  4. JMS 연결 팩토리 편집 페이지에서 다음 작업을 수행할 수 있습니다.

    • 설명 필드의 텍스트를 수정합니다.

    • 자원을 활성화하거나 비활성화하려면 사용 가능 확인란을 선택하거나 선택 해제합니다.

    • 고급 영역에서 속성 값을 변경합니다.

    • 등록 정보를 추가, 제거 또는 수정합니다.

  5. 필요에 따라 대상 탭을 눌러 JMS 연결 팩토리 자원 대상 페이지로 이동합니다. 이 페이지에서 다음 작업을 수행합니다.

    1. 대상 관리를 눌러 자원 대상 관리 페이지를 엽니다.

      이 페이지에서 사용 가능한 열과 선택한 열에 대상을 이동합니다. 선택한 열에 배포할 자원을 사용하는 응용 프로그램에 해당하는 대상을 넣어야 합니다. 사용 가능한 대상은 기본 서버 인스턴스인 server 뿐만 아니라 사용 가능한 클러스터 및 서버 인스턴스를 포함합니다. 확인을 눌러 변경 사항을 저장합니다.

    2. 대상에 대한 확인란을 선택한 다음 활성화를 눌러 해당 대상의 자원을 활성화하거나, 비활성화를 눌러 해당 대상의 자원을 비활성화합니다.

  6. 저장을 눌러 변경 사항을 저장합니다.

ProcedureJMS 연결 팩토리 자원을 삭제하는 방법

  1. 트리 구성 요소에서 자원 노드를 확장한 다음 JMS 자원 노드를 확장합니다.

  2. 연결 팩토리 노드를 선택합니다.

  3. JMS 연결 팩토리 페이지에서 삭제할 연결 팩토리 이름 옆에 있는 확인란을 선택합니다.

  4. 삭제를 누릅니다.

해당 asadmin 명령

delete-jms-resource

JMS 대상 자원을 위한 관리 콘솔 작업

ProcedureJMS 대상 자원을 만드는 방법

  1. 트리 구성 요소에서 자원 노드를 확장한 다음 JMS 자원 노드를 확장합니다.

  2. 대상 자원 노드를 선택합니다.

  3. JMS 대상 자원 페이지에서 새로 만들기를 누릅니다. JMS 대상 자원 만들기 페이지가 나타납니다.

  4. JNDI 이름 필드에서 자원 이름을 입력합니다.

    JMS 자원에 대해 이름 지정 하위 컨텍스트 접두어 jms/를 사용하는 것이 좋습니다. 예를 들면 다음과 같습니다. jms/Queue.

  5. 유형 드롭다운 목록에서 javax.jms.Topic 또는 javax.jms.Queue를 선택합니다.

  6. 런타임에서 자원을 활성화하려면 사용 가능 확인란을 선택합니다.

  7. 추가 등록 정보 영역에서 등록 정보 값을 제공합니다.

    다음 표에서는 사용 가능한 등록 정보를 나열합니다.

    등록 정보 이름 

    설명 

    Name

    (필수) 자원이 참조하는 물리적 대상 이름입니다.  

    Description

    물리적 대상에 대한 설명입니다. 

  8. 대상 영역에서 다음 작업을 수행합니다.

    1. 사용 가능한 열에서 배포할 자원을 사용하는 응용 프로그램에 해당하는 대상을 선택합니다.

      사용 가능한 대상은 기본 서버 인스턴스인 server 뿐만 아니라 사용 가능한 클러스터 및 서버 인스턴스를 포함합니다.

    2. 추가를 눌러 대상을 선택한 열로 이동합니다.

  9. 확인을 누릅니다.

해당 asadmin 명령

create-jms-resource

ProcedureJMS 대상 자원을 편집하는 방법

  1. 트리 구성 요소에서 자원 노드를 확장한 다음 JMS 자원 노드를 확장합니다.

  2. 대상 자원 노드를 확장합니다.

  3. 편집할 대상 자원을 선택합니다.

  4. JMS 대상 자원 편집 페이지에서 다음 작업을 수행할 수 있습니다.

    • 자원 유형을 변경합니다.

    • 설명 필드의 텍스트를 수정합니다.

    • 자원을 활성화하거나 비활성화하려면 사용 가능 확인란을 선택하거나 선택 해제합니다.

    • 또는 등록 정보를 추가, 제거 또는 수정합니다.

  5. 저장을 눌러 변경 사항을 저장합니다.

  6. 필요에 따라 대상 탭을 눌러 JMS 대상 자원 대상 페이지로 이동합니다. 이 페이지에서 다음 작업을 수행합니다.

    1. 대상 관리를 눌러 자원 대상 관리 페이지를 엽니다.

      이 페이지에서 사용 가능한 열과 선택한 열에 대상을 이동합니다. 선택한 열에 배포할 자원을 사용하는 응용 프로그램에 해당하는 대상을 넣어야 합니다. 사용 가능한 대상은 기본 서버 인스턴스인 server 뿐만 아니라 사용 가능한 클러스터 및 서버 인스턴스를 포함합니다. 확인을 눌러 변경 사항을 저장합니다.

    2. 대상에 대한 확인란을 선택한 다음 활성화를 눌러 해당 대상의 자원을 활성화하거나, 비활성화를 눌러 해당 대상의 자원을 비활성화합니다.

ProcedureJMS 대상 자원을 삭제하는 방법

  1. 트리 구성 요소에서 자원 노드를 확장한 다음 JMS 자원 노드를 확장합니다.

  2. 대상 자원 노드를 선택합니다.

  3. JMS 대상 자원 페이지에서 삭제할 대상 자원 이름 옆에 있는 확인란을 선택합니다.

  4. 삭제를 누릅니다.

해당 asadmin 명령

delete-jms-resource

JMS 물리적 대상을 위한 관리 콘솔 작업

ProcedureJMS 물리적 대상을 만드는 방법

작업 목적을 위해 항상 물리적인 대상을 만듭니다. 그러나 개발 및 테스트 단계 중에는 이 단계가 필요하지 않습니다. 응용 프로그램에서 처음 대상 자원에 액세스할 때 대상 자원의 등록 정보에서 지정한 물리적 대상을 Message Queue에서 자동으로 만듭니다. 물리적 대상은 임시적이며 Message Queue 구성 등록 정보에서 지정한 기간 후에는 만료됩니다.

  1. 트리 구성 요소에서 구성 노드를 확장한 다음, Java Message Service 노드를 확장합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. 물리적 대상 노드를 선택합니다.

  4. 물리적 대상 페이지에서 새로 만들기를 누릅니다.

    물리적 대상 만들기 페이지가 표시됩니다.

  5. 물리적 대상 이름 필드에 대상 이름(예: PhysicalQueue)을 입력합니다.

  6. 유형 드롭다운 목록에서 topic 또는 queue를 선택합니다.

  7. 추가 등록 정보 영역에서 등록 정보 추가를 눌러 등록 정보를 추가합니다.

    다음 표에서는 현재 사용 가능한 등록 정보를 나열합니다.

    등록 정보 이름 

    설명 

    maxNumActiveConsumers

    대기열 대상의 로드 균형 조정된 전달에서 활성화할 수 있는 최대 사용자 수입니다. 값 -1은 수에 제한이 없음을 의미합니다. 기본값은 대상을 독립 실행형 서버 인스턴스에 대해 만들 경우 1이고 클러스터에 대해 만들 경우 -1입니다. 

    이 등록 정보 값을 수정하거나 다른 물리적 대상 등록 정보를 지정하려면 MQ-install-dir /imq/bin/imqcmd 명령을 사용합니다. 자세한 내용은 Message Queue 관리 안내서를 참조하십시오.

  8. 확인을 누릅니다.

해당 asadmin 명령

create-jmsdest

시스템 대상

물리적 대상 페이지에서는 만료되거나 전달할 수 없는 메시지가 리디렉션되는 시스템 대상(mq.sys.dmq라는 대기열)을 보여줍니다. 이 대상에 대한 대상 자원, 사용자 및 브라우저를 만들 수 있습니다. 그러나 이 대상을 삭제하거나 이 대상에 메시지를 보낼 수 없습니다.

ProcedureJMS 물리적 대상을 삭제하는 방법

  1. 트리 구성 요소에서 구성 노드를 확장한 다음, Java Message Service 노드를 확장합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. 물리적 대상 노드를 선택합니다.

  4. 물리적 대상 페이지에서 삭제할 대상 이름 옆에 있는 확인란을 선택합니다.

  5. 삭제를 누릅니다.

    시스템 대상 mq.sys.dmq를 삭제할 경우 오류 메시지가 표시됩니다.

해당 asadmin 명령

delete-jmsdest

JMS 공급자를 위한 관리 콘솔 작업

ProcedureJMS 공급자를 위한 일반 등록 정보를 구성하는 방법

JMS 서비스 페이지를 사용하여 모든 JMS 연결에서 사용하는 등록 정보를 구성합니다.

JMS 서비스를 구성하는 방법에 대한 자세한 내용은 Application Server Developer’s Guide를 참조하십시오.

  1. 트리 구성 요소에서 구성 노드를 선택합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. JMS(Java Message Service) 노드를 선택하여 JMS 서비스 페이지를 엽니다.

  4. 시작 시간 초과 필드의 값을 편집하여 시작을 중단하기 전에 Application Server에서 JMS 서비스가 시작할 때까지 대기하는 시간을 변경합니다.

    느리거나 오버로드된 시스템에서는 기본값(60)에서 값을 늘립니다.

  5. 유형 드롭다운 목록에서 다음을 수행합니다.

    • 로컬 호스트에서 JMS 서비스에 액세스하려면 LOCAL( server-config 구성에 대한 기본값)을 선택합니다. JMS 서비스는 Application Server가 시작하고 관리합니다.

    • 다른 시스템또는 클러스터에 있는 JMS 서비스에 액세스하려면 REMOTE(default-config 구성에 대한 기본값)를 선택합니다. REMOTE를 선택하면 다음에 서버가 시작할 때 Application Server에서 JMS 서비스를 시작하지 않습니다. 대신, Message Queue를 통해 JMS 서비스를 시작하거나 관리하므로 Message Queue 브로커를 별도로 시작해야 합니다. 브로커 시작에 대한 자세한 내용은 Message Queue 관리 안내서를 참조하십시오. 이 값을 선택하고 원격 호스트를 사용할 경우 JMS 호스트를 편집하는 방법의 지침에 따라 원격 호스트 이름을 지정합니다.

  6. 시작 인수 필드에서 JMS 서비스 시작을 사용자 정의하는 인수를 입력합니다.

    MQ-install-dir /imq/bin/imqbrokerd 명령을 통해 사용할 수 있는 인수를 사용합니다.

  7. 연결이 끊어진 경우 서비스에서 메시지 서버 또는 AddressList의 주소 목록에 다시 연결할지 여부를 지정하려면 다시 연결 확인란을 사용합니다.

    기본적으로 다시 연결이 활성화되어 있습니다.

  8. 다시 연결 간격 필드에서 다시 연결을 시도하는 간격(초)을 입력합니다.

    AddressList의 각 주소에 대한 재연결 시도와 목록의 연속된 주소에 이 값이 적용됩니다. 이 시간 간격이 너무 짧을 경우 브로커가 복구할 시간이 없습니다. 너무 길 경우에는 지연이 지나치게 길게 느껴질 수 있습니다.

    기본값은 60초입니다.

  9. 클라이언트 런타임에서 목록의 다음 주소를 사용하기 전에 AddressList의 각 주소에 대해 연결 또는 재연결을 시도하는 횟수를 다시 연결 시도 필드에 입력합니다.

    값 -1은 재연결 시도 횟수에 제한이 없음을 나타냅니다. 클라이언트 런타임은 성공할 때까지 첫 번째 주소에 연결을 시도합니다. 기본값은 3입니다.

  10. 기본 JMS 호스트 드롭다운 목록에서 호스트를 선택합니다. 기본값은 default_JMS_host입니다.

  11. 주소 목록 동작 드롭다운 목록에서 AddressList의 주소 순서대로(priority) 다시 연결을 시도할지 아니면 임의의 순서대로(random) 다시 연결을 시도할지 선택합니다.

    priority는 재연결 시 항상 AddressList의 첫 번째 서버 주소에 연결하고 첫 번째 브로커를 사용할 수 없는 경우에만 다른 서버 주소를 사용한다는 것을 의미합니다.

    동일한 연결 팩토리를 사용하여 연결을 시도하는 클라이언트가 많을 경우 random을 지정하여 클라이언트가 동일한 주소에 모두 연결되지 못하도록 합니다.

    기본값은 random입니다.

  12. 주소 목록 반복 필드에 연결을 설정하거나 재설정할 때 JMS 서비스가 AddressList를 반복하는 횟수를 입력합니다.

    값 -1은 횟수에 제한이 없음을 나타냅니다.

    기본값은 3입니다.

  13. 기본값이 아닌 체계나 서비스를 사용할 경우 MQ 체계 및 MQ 서비스 필드에 Message Queue 주소 체계 이름과 Message Queue 연결 서비스 이름을 입력합니다.

    메시지 서비스 주소에 대한 전체 구문은 다음과 같습니다.


    scheme://address-syntax

    scheme과 address-syntax는 아래 표에서 자세히 설명합니다.

    다음 표의 처음 두 열에 표시된 값이 MQ 체계와 MQ 서비스입니다.

    체계 이름 

    연결 서비스 

    설명 

    주소 구문 

    mq

    jms 및 ssljms

    Message Queue 클라이언트 런타임은 지정한 호스트와 포트에서 MQ 포트 매퍼에 연결합니다. 포트 매퍼는 동적으로 설정된 연결 서비스 포트 목록을 반환하고 Message Queue 클라이언트 런타임에서 지정한 연결 서비스를 호스트하는 포트에 연결합니다. 

    [hostName][: port][/serviceName ]

    기본값: hostName = localhost, port = 7676, serviceName = jms

    기본값은 jms 연결 서비스에만 적용됩니다. ssljms 연결 서비스의 경우 모든 변수를 지정해야 합니다.

    예: mq:MyHost:7677/ssljms

    mqtcp

    jms

    Message Queue 클라이언트 런타임은 MQ 포트 매퍼를 무시하고 지정된 호스트와 포트에 TCP 연결을 설정하여 연결합니다. 

    hostName:port/jms

    예: mqtcp:localhost:7676/jms

    mqssl

    ssljms

    Message Queue 클라이언트 런타임은 MQ 포트 매퍼를 무시하고 지정된 호스트와 포트에 보안 SSL 연결을 설정하여 연결합니다. 

    hostName:port/ssljms

    예: mqssl:localhost:7676/ssljms

    http

    httpjms

    Message Queue 클라이언트 런타임은 지정된 URL에서 Message Queue 터널 서블릿에 HTTP 연결을 설정합니다. (Message Queue Administrator’s Guide에 설명된 대로 브로커를 HTTP 터널 서블릿에 액세스하도록 구성해야 합니다.)

    hostName:port/contextRoot/tunnel

    여러 브로커 인스턴스에서 동일한 터널 서블릿을 사용할 경우 임의로 선택된 브로커 인스턴스 대신 특정 브로커 인스턴스에 연결하는 구문은 다음과 같습니다. http://hostName: port/contextRoot/tunnel?serverName =hostName:instanceName

    https

    httpsjms

    Message Queue 클라이언트 런타임은 지정된 Message Queue 터널 서블릿 URL에 보안 HTTPS 연결을 설정합니다. (Message Queue Administrator’s Guide에 설명된 대로 브로커를 HTTPS 터널 서블릿에 액세스하도록 구성해야 합니다.)

    hostName:port/contextRoot/tunnel

    여러 브로커 인스턴스에서 동일한 터널 서블릿을 사용할 경우 임의로 선택된 브로커 인스턴스 대신 특정 브로커 인스턴스에 연결하는 구문은 다음과 같습니다. http://hostName: port/contextRoot/tunnel?serverName =hostName:instanceName

  14. 추가 등록 정보 영역에서 등록 정보 추가를 눌러 등록 정보를 추가합니다.

    다음 표에서는 사용 가능한 Sun Java System Message Queue 브로커 구성 등록 정보를 나열합니다.

    등록 정보 이름 

    설명 

    instance-name

    전체 Message Queue 브로커 인스턴스 이름을 지정합니다. 기본값은 imqbroker입니다.

    instance-name-suffix

    전체 Message Queue 브로커 인스턴스 이름에 추가할 접미어를 지정합니다. 접미어와 인스턴스 이름은 밑줄 문자(_ )로 구분합니다. 예를 들어, 인스턴스 이름이imqbroker일 경우 xyz 접미어를 추가하면 인스턴스 이름이 imqbroker_xyz로 바뀝니다.

    append-version

    true일 경우 전체 Message Queue 브로커 인스턴스 이름 뒤에 주 버전과 부 버전 번호가 밑줄 문자(_)로 구분되어 추가됩니다. 예를 들어, 인스턴스 이름이 imqbroker일 경우 버전 번호를 추가하면 인스턴스 이름이 imqbroker_8_0으로 바뀝니다. 기본값은 false입니다.

  15. 저장을 눌러 변경 사항을 저장하거나 기본값 로드를 눌러 서비스에 대한 기본값을 복원합니다.

원격 서버 액세스

공급자와 호스트를 원격 시스템으로 변경하면 모든 JMS 응용 프로그램이 원격 서버에서 실행됩니다. 로컬 서버와 하나 이상의 원격 서버를 모두 사용하려면 원격 서버에 액세스하는 연결을 만드는 AddressList 등록 정보를 사용하여 연결 팩토리 자원을 만듭니다. JMS 연결 팩토리 자원을 만드는 방법을 참조하십시오.

ProcedureJMS 서비스 설정을 확인하는 방법

  1. 트리 구성 요소에서 구성 노드를 선택합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. JMS(Java Message Service) 노드를 선택하여 JMS 서비스 페이지를 엽니다.

  4. 핑을 누릅니다.

    JMS 서비스가 실행 중이면 메시지 “Ping succeeded: JMS service is running”이 표시됩니다.

해당 asadmin 명령

jms-ping

ProcedureJMS 호스트를 만드는 방법

Application Server Platform Edition는 기본 이름이 default_JMS_host인 JMS 호스트가 정확히 한 개 있다고 예상합니다. 추가 호스트를 만들 수는 있지만 Application Server가 이를 알 수 있는 방법은 없습니다.

  1. 트리 구성 요소에서 구성 노드를 확장합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. Java Message Service 노드를 확장합니다.

  4. JMS 호스트 노드를 선택합니다.

  5. JMS 호스트 페이지에서 새로 만들기를 누릅니다. JMS 호스트 만들기 페이지가 표시됩니다.

  6. 이름 필드에서 호스트 이름을 입력합니다. 예를 들면 다음과 같습니다.


    NewJmsHost

  7. 호스트 필드에서 JMS 호스트가 실행되는 시스템의 이름이나 IP(인터넷 프로토콜) 주소를 입력합니다(localhost 또는 로컬 또는 원격 시스템의 이름).

  8. 포트 필드에서 JMS 서비스의 포트 번호를 입력합니다.

    사용할 JMS 서비스가 기본이 아닌 포트에서 실행 중인 경우에만 이 필드를 변경합니다. 기본 포트는 7676입니다.

  9. 관리자 이름 및 관리 비밀번호 필드에서 Message Queue 브로커 사용자 이름과 비밀번호를 입력합니다.

    이는 Application Server 사용자 이름 및 비밀번호와 다릅니다. Message Queue 브로커 값을 MQ-install-dir/imq/bin/imqusermgr 명령을 사용하여 변경한 경우에만 이 필드를 편집합니다. 기본값은 admin과 admin입니다.

  10. 확인을 누릅니다.

해당 asadmin 명령

create-jms-host

ProcedureJMS 호스트를 편집하는 방법

  1. 트리 구성 요소에서 구성 노드를 확장합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. Java Message Service 노드를 확장합니다.

  4. JMS 호스트 노드를 선택합니다.

  5. JMS 호스트 페이지에서 편집할 호스트를 선택합니다.

  6. JMS 호스트 편집 페이지에서 다음 작업을 수행할 수 있습니다.

    • 호스트 필드의 호스트 이름 또는 인터넷 프로토콜(IP) 주소를 변경합니다.

      • 포트 필드에서 JMS 서비스의 포트 번호를 변경합니다.

      • 관리자 사용자 이름 필드와 관리 비밀번호 필드의 값을 변경합니다.

  7. 저장을 눌러 변경 사항을 저장하거나 기본값 로드를 눌러 호스트에 대한 기본값을 복원합니다.

ProcedureJMS 호스트를 삭제하는 방법

  1. 트리 구성 요소에서 구성 노드를 확장합니다.

  2. 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. Java Message Service 노드를 확장합니다.

  4. JMS 호스트 노드를 선택합니다.

  5. JMS 호스트 페이지에서 삭제할 호스트 이름 옆에 있는 확인란을 선택합니다.

  6. 삭제를 누릅니다.

    주의 – 주의 –

    모든 JMS 호스트를 삭제하지는 마십시오. 그러면 Application Server가 다시 시작되지 않습니다. 최소한 하나의 JMS 호스트를 남겨 두어야 합니다.

해당 asadmin 명령

delete-jms-host