AMQ Broker 구성

1. 브로커는 현재 가상 호스팅을 지원하지 않으므로 CONNECT 프레임의 호스트 헤더가 무시됩니다.
2. 메시지 확인은 트랜잭션이 아닙니다. ACK 프레임은 트랜잭션의 일부가 될 수 없으며 트랜잭션 헤더가 설정되면 무시됩니다.The ACK frame cannot be part of a transaction, and it is ignored if its transaction header is set.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.
2. 다음 예와 같이 STOMP 연결에 사용되는 수락자에 대해 stompEnableMessageId 매개변수를 true 로 설정합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.
2. 다음 예와 같이 STOMP 연결에 사용되는 수락 자의 URI에 connectionTTL 매개변수를 추가합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.
2. connection-ttl-override 특성을 추가하고 새 기본값에 대한 값(밀리초)을 제공합니다. 아래처럼 &lt ;core&gt; 스탠자에 속합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 아래 예제 와 같이 <wildcard-addresses > 섹션을 구성에 추가합니다.

   <configuration>
     <core>
       ...
       <wildcard-addresses> //
         <enabled>true</enabled> //
         <delimiter>,</delimiter> //
         <any-words>@</any-words> //
         <single-word>$</single-word>
       </wildcard-addresses>
       ...
     </core>
   </configuration>

   enabled

   true 로 설정하면 브로커에 사용자 지정 설정을 사용하도록 지시합니다.

   구분 기호

   기본값 대신 구분자로 사용할 사용자 지정 문자를 제공합니다 ..

   any-words

   모든 단어의 값으로 제공되는 문자는 '가장 이상의 단어 시퀀스와 일치'을 의미하는 데 사용되며 기본값 # 을 대체합니다. 표현식 끝에 이 문자를 사용합니다.

   single-word

   단일 단어의 값으로 제공되는 문자는 '단어 일치'를 의미하는 데 사용되며 기본값 * 를 대체합니다. 표현 내의 어디에서나 이 문자를 사용하십시오.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 주소의 선택한 큐 요소 주위에 임의의cast 구성 요소를 래핑합니다. address 및 queue 요소의 name 속성 값이 모두 같은지 확인합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.anycast.destination">
         <anycast>
           <queue name="my.anycast.destination"/>
         </anycast>
       </address>
     </core>
   </configuration>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. address 요소의 큐 요소 주위에 모든cast 구성 요소를 래핑합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.anycast.destination">
         <anycast>
           <queue name="q1"/>
           <queue name="q2"/>
         </anycast>
       </address>
     </core>
   </configuration>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 선택한 큐에 내구성 있는 구성 요소를 추가합니다. true 값을 설정합니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.durable.address">
         <multicast>
           <queue name="q1">
             <durable>true</durable>
           </queue>
         </multicast>
       </address>
     </core>
   </configuration>

   참고

   큐는 내구성 요소를 포함하여 기본적으로 내구성이 있기 때문에 값을 true 로 설정하는 것은 내구성된 큐를 만드는 데 엄격하게 필요하지 않습니다. 그러나 요소를 명시적으로 포함하면 필요한 경우 나중에 큐의 동작을 불가능한 것으로 변경할 수 있습니다.However, explicitly including the element enables you to later change the behavior of the queue to non-durable, if necessary.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 선택한 각 큐에 내구성 구성 요소를 추가합니다. true 값을 설정합니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.non.shared.durable.address">
         <multicast>
           <queue name="orders1">
             <durable>true</durable>
           </queue>
           <queue name="orders2">
             <durable>true</durable>
           </queue>
         </multicast>
       </address>
     </core>
   </configuration>

   참고

   큐는 내구성 요소를 포함하여 기본적으로 내구성이 있기 때문에 값을 true 로 설정하는 것은 내구성된 큐를 만드는 데 엄격하게 필요하지 않습니다. 그러나 요소를 명시적으로 포함하면 필요한 경우 나중에 큐의 동작을 불가능한 것으로 변경할 수 있습니다.However, explicitly including the element enables you to later change the behavior of the queue to non-durable, if necessary.

3. 선택한 각 큐에 max-consumers 속성을 추가합니다. 값 1 을 설정합니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.non.shared.durable.address">
         <multicast>
           <queue name="orders1" max-consumers="1">
             <durable>true</durable>
           </queue>
           <queue name="orders2" max-consumers="1">
             <durable>true</durable>
           </queue>
         </multicast>
       </address>
     </core>
   </configuration>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 선택한 각 큐에 purge-on-no-consumers 속성을 추가합니다. true 값을 설정합니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.non.durable.address">
           <multicast>
               <queue name="orders1" purge-on-no-consumers="true"/>
           </multicast>
       </address>
     </core>
   </configuration>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 자동 생성 및 삭제를 위해 address-setting 을 구성합니다. 다음 예제에서는 이전 표에 언급된 모든 구성 요소를 사용합니다.

   <configuration ...>
    <core ...>
     ...
     <address-settings>
       <address-setting match="activemq.#">
         <auto-create-addresses>true</auto-create-addresses>
         <auto-delete-addresses>true</auto-delete-addresses>
         <auto-create-queues>true</auto-create-queues>
         <auto-delete-queues>true</auto-delete-queues>
         <default-address-routing-type>ANYCAST</default-address-routing-type>
       </address-setting>
     </address-settings>
     ...
    </core>
   </configuration>

   address-setting

   address-setting 요소의 구성은 와일드카드 주소 typical .#과 일치하는 모든 주소 또는 큐에 적용됩니다.

   auto-create-addresses

   클라이언트가 아직 존재하지 않는 주소에 연결을 요청하면 브로커가 주소를 생성합니다.

   auto-delete-addresses

   큐가 더 이상 연결되어 있지 않으면 자동으로 생성된 주소가 삭제됩니다.

   auto-create-queues

   클라이언트가 아직 존재하지 않는 큐에 연결을 요청하면 브로커가 큐를 생성합니다.

   auto-delete-queues

   자동 생성된 큐는 더 이상 소비자 또는 메시지가 없는 경우 삭제됩니다.

   default-address-routing-type

   연결할 때 클라이언트가 라우팅 유형을 지정하지 않으면 브로커가 메시지를 주소로 전달할 때 ANYCAST 를 사용합니다. 기본값은 MULTICAST 입니다.

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 지정된 큐의 경우 last-value-key 키를 추가하고 사용자 지정 값을 지정합니다. 예를 들면 다음과 같습니다.

   <address name="my.address">
       <multicast>
           <queue name="prices1" last-value-key="stock_ticker"/>
       </multicast>
   </address>

3. 또는 _AMQ_LVQ_NAME 의 기본 마지막 값 키 이름을 사용하는 마지막 값 큐를 구성할 수 있습니다. 이렇게 하려면 지정된 큐에 last-value 키를 추가합니다. 값을 true 로 설정합니다. 예를 들면 다음과 같습니다.

   <address name="my.address">
       <multicast>
           <queue name="prices1" last-value="true"/>
       </multicast>
   </address>

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. address-setting 요소에서 일치하는 주소에 대해 default-last-value-key 를 추가합니다. 사용자 정의 값을 지정합니다. 예를 들면 다음과 같습니다.

   <address-setting match="lastValue">
      <default-last-value-key>stock_ticker</default-last-value-key>
   </address-setting>

   이전 구성에 따라 lastValue 주소와 연결된 모든 큐는 마지막 값 키 stock_ticker 를 사용합니다. 기본적으로 default-last-value-key 값은 설정되지 않습니다.

3. 주소 집합에 대한 마지막 값 대기열을 구성하려면 주소 와일드카드를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

   <address-setting match="lastValue.*">
      <default-last-value-key>stock_ticker</default-last-value-key>
   </address-setting>

4. 또는 주소 또는 주소 세트 와 연결된 모든 큐를 구성하여 기본 마지막 값 키 이름 _AMQ_LVQ_NAME 을 사용할 수 있습니다. 이렇게 하려면 default-last-value-key 대신 default-last-value-queue 를 추가합니다. 값을 true 로 설정합니다. 예를 들면 다음과 같습니다.

   <address-setting match="lastValue">
      <default-last-value-queue>true</default-last-value-queue>
   </address-setting>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 이전에 큐를 마지막 값 큐로 구성한 경우 파괴적이지 않은 키를 추가합니다. 값을 true 로 설정합니다. 예를 들면 다음과 같습니다.

   <address name="my.address">
      <multicast>
         <queue name="orders1" last-value-key="stock_ticker" non-destructive="true" />
      </multicast>
   </address>

3. 이전에 마지막 값 큐에 대한 주소 또는 주소 세트 를 구성한 경우 default-non-destructive 키를 추가합니다. 값을 true 로 설정합니다. 예를 들면 다음과 같습니다.

   <address-setting match="lastValue">
      <default-last-value-key>stock_ticker </default-last-value-key>
      <default-non-destructive>true</default-non-destructive>
   </address-setting>

   참고

   기본적으로 default-non-destructive 값은 false 입니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. core 요소에서 message-expiry-scan-period 를 설정하여 만료된 메시지에 대한 브로커 검색 빈도를 지정합니다.

   <configuration ...>
      <core ...>
         ...
         <message-expiry-scan-period>1000</message-expiry-scan-period>
         ...

   이전 구성에 따라 브로커는 1000밀리초마다 만료된 메시지의 대기열을 검사합니다.

3. 일치하는 주소 또는 주소 세트 의 address-setting 요소에서 만료 주소를 지정합니다. 또한 메시지 만료 시간을 설정합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="stocks">
               ...
               <expiry-address>ExpiryAddress</expiry-address>
               <expiry-delay>10</expiry-delay>
               ...
            </address-setting>
            ...
         <address-settings>
   <configuration ...>

   expiry-address

   일치하는 주소 또는 주소의 만료 주소입니다. 이전 예에서 브로커는 주식 주소에 대한 만료된 메시지를 ExpiryAddress 라는 만료 주소로 보냅니다.

   expiry-delay

   브로커가 기본 만료 시간을 사용하는 메시지에 적용되는 만료 시간(밀리초)입니다. 기본적으로 메시지의 만료 시간은 0이며 만료되지 않음을 의미합니다.By default, messages have an expiration time of 0, meaning that they don't expire. 만료 시간이 기본값보다 크면 expiration -delay 가 적용되지 않습니다.

   예를 들어 위 예에 표시된 대로 주소에서 expiry-delay 를 10 으로 설정했다고 가정합니다. 기본 만료 시간이 0 인 메시지가 이 주소에서 큐에 도달하면 브로커는 메시지의 만료 시간을 0 에서 10 으로 변경합니다. 그러나 20 의 만료 시간을 사용하는 다른 메시지가 도착하면 만료 시간은 변경되지 않습니다. expiry-delay를 -1 로 설정하면 이 기능이 비활성화됩니다. 기본적으로 expiry-delay 는 -1 로 설정됩니다.

4. 또는 expiry-delay 에 값을 지정하는 대신 최소 및 최대 만료 지연 값을 지정할 수 있습니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="stocks">
               ...
               <expiry-address>ExpiryAddress</expiry-address>
               <min-expiry-delay>10</min-expiry-delay>
               <max-expiry-delay>100</max-expiry-delay>
               ...
            </address-setting>
            ...
         <address-settings>
   <configuration ...>

   min-expiry-delay

   브로커가 메시지에 적용되는 최소 만료 시간(밀리초)입니다.

   max-expiry-delay

   브로커가 메시지에 적용되는 최대 만료 시간(밀리초)입니다.

   브로커는 다음과 같이 min-expiry-delay 및 max-expiry-delay 값을 적용합니다.

   • 기본 만료 시간이 0 인 메시지의 경우 브로커는 만료 시간을 max-expiry-delay 의 지정된 값으로 설정합니다. max-expiry-delay 의 값을 지정하지 않은 경우 브로커는 만료 시간을 min-expiry-delay 로 설정합니다. min-expiry-delay 에 대한 값을 지정하지 않은 경우 브로커는 메시지의 만료 시간을 변경하지 않습니다.
   • max-expiry-delay 보다 높은 만료 시간이 있는 메시지의 경우 브로커는 만료 시간을 max-expiry-delay 의 지정된 값으로 설정합니다.
   • min-expiry-delay 값 아래에 만료 시간이 있는 메시지의 경우 브로커는 만료 시간을 min-expiry-delay 로 설정합니다.
   • min-expiry-delay 및 max-expiry-delay 값 간에 만료되는 메시지의 경우 브로커는 메시지의 만료 시간을 변경하지 않습니다.
   • expiry-delay (즉, 기본값 -1이 아닌)의 값을 지정하면 min-expiry-delay 및 max-expiry-delay 에 지정된 모든 값이 재정의됩니다.
   • min-expiry-delay 및 max-expiry-delay 의 기본값은 -1 입니다(즉, 비활성화됨).

5. 구성 파일의 addresses 요소에서 expiry-address 에 대해 이전에 지정된 주소를 구성합니다. 이 주소에서 큐를 정의합니다. 예를 들면 다음과 같습니다.

   <addresses>
       ...
       <address name="ExpiryAddress">
           <anycast>
               <queue name="ExpiryQueue"/>
           </anycast>
       </address>
       ...
   </addresses>

   앞의 예제 구성은 만료 큐인 ExpiryQueue 를 만료 주소 ExpiryAddress 와 연결합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 이전에 구성 파일에 추가한 < address-setting > 요소를 찾아 일치하는 주소 또는 주소 세트 의 만료 주소를 정의합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
   
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="stocks">
               ...
               <expiry-address>ExpiryAddress</expiry-address>
               ...
            </address-setting>
            ...
         <address-settings>
   <configuration ...>

3. < address-setting > 요소에서 브로커에 만료 리소스(즉, 주소 및 큐)를 자동으로 생성하고 이러한 리소스의 이름을 지정하는 방법을 브로커에 지시하는 구성 항목을 추가합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="stocks">
               ...
               <expiry-address>ExpiryAddress</expiry-address>
               <auto-create-expiry-resources>true</auto-create-expiry-resources>
               <expiry-queue-prefix>EXP.</expiry-queue-prefix>
               <expiry-queue-suffix></expiry-queue-suffix>
               ...
            </address-setting>
            ...
         <address-settings>
   <configuration ...>

   auto-create-expiry-resources

   브로커가 만료된 메시지를 수신할 만료 주소 및 큐를 자동으로 생성하는지 여부를 지정합니다. 기본값은 false입니다.

   매개변수 값이 true 로 설정되면 브로커는 만료 주소 및 관련 만료 큐를 정의하는 <address> 요소를 자동으로 생성합니다. 자동으로 생성된 < address > 요소의 name 값은 에 <expiry-address> 지정된 name 값과 일치합니다.

   자동 생성된 만료 큐에는 멀티 캐스트 라우팅 유형이 있습니다. 기본적으로 브로커는 만료된 메시지가 원 래 전송된 주소(예: 주식)와 일치하도록 만료 큐의 이름을 지정합니다.

   브로커는 또한 _AMQ_ORIG_ADDRESS 속성을 사용하는 만료 대기열에 대한 필터를 정의합니다. 이 필터를 사용하면 만료 큐가 해당 원래 주소로 전송된 메시지만 수신됩니다.

   expiry-queue-prefix

   브로커가 자동으로 생성된 만료 큐의 이름에 적용되는 접두사입니다. 기본값은 EXP입니다.

   접두사 값을 정의하거나 기본값을 유지할 때 만료 큐의 이름은 접두사와 원래 주소(예: EXP.stocks )의 연결입니다.

   expiry-queue-suffix

   브로커가 자동으로 생성된 만료 큐의 이름에 적용되는 접미사입니다. 기본값은 정의되지 않습니다(즉, 브로커는 접미사가 적용되지 않음).

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 대기열 이름과 일치하는 < address-setting > 요소에서 dead letter 주소 이름 및 최대 전달 시도 수에 대한 값을 설정합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   match

   브로커가 이 address-setting 섹션의 구성을 적용하는 주소입니다. < address-setting > 요소의 match 특성에 와일드카드 식을 지정할 수 있습니다. 와일드카드 표현식을 사용하는 것은 < address-setting > 요소에 구성된 dead letter 설정을 일치하는 주소 집합 과 연결하려는 경우 유용합니다.

   dead-letter-address

   배달 못 한 주소의 이름입니다. 이 예에서 브로커는 배달되지 않은 메시지를 대기열 exampleQueue 에서 dead letter address인 DLA 로 이동합니다.

   max-delivery-attempts

   배달되지 않은 메시지를 구성된 배달 주소로 이동하기 전에 브로커가 수행한 최대 전송 시도 횟수입니다. 이 예에서 브로커는 전달되지 않은 메시지를 세 가지 실패한 전달 시도 후 배달되지 않은 주소로 이동합니다. 기본값은 10 입니다. 브로커가 무한한 수의 재전송 시도 횟수를 제한하도록 하려면 -1 값을 지정합니다.

3. addresses 섹션에서 dead letter address 인 DLA 에 대한 address 요소를 추가합니다. dead letter 큐를 dead letter 주소와 연결하려면 큐 의 이름 값을 지정합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <addresses>
            <address name="DLA">
               <anycast>
                  <queue name="DLQ" />
               </anycast>
            </address>
         ...
         </addresses>
      </core>
   </configuration>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 일치하는 큐 또는 큐 세트에 대한 dead letter 주소를 정의하기 위해 이전에 추가한 <address-setting > 요소를 찾습니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

3. < address-setting > 요소에서 브로커에 배달 못 한 문자 리소스(즉, 주소 및 큐)를 자동으로 생성하고 이러한 리소스의 이름을 지정하는 방법을 브로커에 지시하는 구성 항목을 추가합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
               <auto-create-dead-letter-resources>true</auto-create-dead-letter-resources>
               <dead-letter-queue-prefix>DLQ.</dead-letter-queue-prefix>
               <dead-letter-queue-suffix></dead-letter-queue-suffix>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   auto-create-dead-letter-resources

   브로커가 배달되지 않은 메시지를 수신할 배달 못 한 주소 및 큐를 자동으로 생성할지 여부를 지정합니다. 기본값은 false입니다.

   auto-create-dead-letter-resources 가 true 로 설정된 경우 브로커는 dead letter 주소 와 관련 dead letter 큐를 정의하는 <address> 요소를 자동으로 생성합니다. 자동으로 생성된 < address > 요소의 이름은 < dead-letter-address >에 지정하는 name 값과 일치합니다.

   브로커가 자동 생성된 < address > 요소에서 정의하는 dead letter 큐에는 멀티캐스트 라우팅 유형이 있습니다. 기본적으로 브로커는 배달되지 않은 메시지의 원래 주소와 일치하도록 dead letter 큐의 이름을 지정합니다(예: stocks ).

   브로커는 또한 _AMQ_ORIG_ADDRESS 속성을 사용하는 dead letter 큐에 대한 필터를 정의합니다. 이 필터를 사용하면 dead letter queue가 해당 원래 주소로 전송된 메시지만 수신됩니다.

   dead-letter-queue-prefix

   브로커가 자동으로 생성된 배달 못 한 큐의 이름에 적용되는 접두사입니다. 기본값은 DLQ입니다.

   접두사 값을 정의하거나 기본값을 유지할 때 dead letter queue의 이름은 접두사와 원래 주소(예: DLQ.stocks )의 연결입니다.

   dead-letter-queue-suffix

   브로커가 자동으로 생성된 dead letter 큐에 적용되는 접미사입니다. 기본값은 정의되지 않습니다(즉, 브로커는 접미사가 적용되지 않음).

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 지정된 큐의 경우 전용 키를 추가합니다. 값을 true 로 설정합니다.

   <configuration ...>
     <core ...>
       ...
       <address name="my.address">
         <multicast>
           <queue name="orders1" exclusive="true"/>
         </multicast>
       </address>
     </core>
   </configuration>

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. address-setting 요소에서 일치하는 주소에 대해 default-exclusive-queue 키를 추가합니다. 값을 true 로 설정합니다.

   <address-setting match="myAddress">
       <default-exclusive-queue>true</default-exclusive-queue>
   </address-setting>

   이전 구성에 따라 myAddress 주소와 연결된 모든 대기열은 배타적입니다. 기본적으로 default-exclusive-queue 값은 false 입니다.

3. 주소 세트에 대한 전용 대기열을 구성하려면 주소 와일드카드를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

   <address-setting match="myAddress.*">
       <default-exclusive-queue>true</default-exclusive-queue>
   </address-setting>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 명시적 링 크기가 설정되지 않은 일치하는 주소에 있는 모든 큐의 기본 링 크기를 정의하려면 address-setting 요소에 default-ring-size 값을 지정합니다. 예를 들면 다음과 같습니다.

   <address-settings>
      <address-setting match="ring.#">
         <default-ring-size>3</default-ring-size>
      </address-setting>
   </address-settings>

   default-ring-size 매개변수는 자동 생성된 큐의 기본 크기를 정의하는 데 특히 유용합니다. default-ring-size 의 기본값은 -1 입니다(즉, 크기 제한은 없음).

3. 특정 큐에서 링 크기를 정의하려면 ring-size 키를 queue 요소에 추가합니다. 값을 지정합니다. 예를 들면 다음과 같습니다.

   <addresses>
      <address name="myRing">
         <anycast>
            <queue name="myRing" ring-size="5" />
         </anycast>
      </address>
   </addresses>

1. 생산자는 ring-size="3" 으로 구성된 링 큐로 세 개의 메시지를 보냅니다.

2. 모든 메시지는 사용자에게 즉시 전달됩니다.

   이 시점에서 messageCount= 3 및 deliveringCount= 3.

3. 생산자는 대기열에 다른 메시지를 보냅니다. 그런 다음 메시지가 소비자에게 디스패치됩니다.

   이제 messageCount = 4 및 deliveringCount = 4. 메시지 수 4 는 구성된 링 크기 3 보다 큽니다. 그러나 브로커는 대기열에서 수신되지 않은 메시지를 제거할 수 없기 때문에 이 상황을 허용해야 합니다.

4. 이제 소비자가 메시지를 인정하지 않고 종료한다고 가정합니다.

   이 경우 네 개의 배달되지 않은 메시지가 브로커로 다시 취소되고 소비된 순서로 큐의 헤드에 추가됩니다. 이 작업을 수행하면 구성된 링 크기에 큐가 배치됩니다. 링 큐는 헤드의 메시지 위에 대기열의 메시지에서 메시지를 선호하기 때문에 큐는 생산자가 보낸 첫 번째 메시지를 큐의 헤드에 다시 추가했기 때문에 큐에서 보낸 첫 번째 메시지를 삭제합니다. 트랜잭션 또는 핵심 세션 롤백은 동일한 방식으로 처리됩니다.

1. 12:00에서 생산자는 ring-size="3" 으로 구성된 링 큐로 메시지 A 를 보냅니다. 이 메시지는 12:05로 예정되어 있습니다.

   이 시점에서 messageCount= 1 및 scheduledCount= 1.

2. 12:01에서 생산자는 B 메시지를 동일한 링 대기열로 보냅니다.

   이제 messageCount= 2 및 scheduledCount= 1.

3. 12:02에서 생산자는 메시지 C 를 동일한 링 대기열로 보냅니다.

   이제 messageCount= 3 및 scheduledCount= 1.

4. 12:03에서 생산자는 D 메시지를 동일한 링 대기열로 보냅니다.

   이제 messageCount= 4 및 scheduledCount= 1.

   대기열의 메시지 수가 이제 4 이고, 구성된 링 크기 3 보다 1배 더 큽니다. 그러나 예약된 메시지는 기술적으로 대기열에 있지 않습니다(즉, 브로커에 있으며 큐에 배치하도록 예약됨). 12:05의 예정된 전달 시간에 브로커는 메시지를 대기열의 헤드에 배치합니다. 그러나 링 큐의 구성된 크기에 이미 도달했으므로 예약된 메시지 A 가 즉시 제거됩니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < feder ation> 요소를 포함하는 새 <federations > 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
     <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
     </federation>
   </federations>

   name

   페더레이션 구성의 이름입니다. 이 예에서 name은 로컬 브로커의 이름에 해당합니다.

   user

   업스트림 브로커에 연결하기 위한 공유 사용자 이름입니다.

   암호

   업스트림 브로커와의 연결에 대한 공유 암호입니다.

   참고

   원격 브로커에 대해 사용자 및 암호 자격 증명이 다른 경우 구성에 추가할 때 해당 브로커의 인증 정보를 별도로 지정할 수 있습니다. 이 내용은 이 절차의 뒷부분에서 설명합니다.

3. 페더레이션 요소 내에서 &lt; address-policy&gt; 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <address-policy name="news-address-federation" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" enable-divert-bindings="false" max-hops="1" transformer-ref="news-transformer">
           </address-policy>
   
       </federation>
   </federations>

   name

   주소 정책의 이름입니다. 브로커에 구성된 모든 주소 정책에는 고유한 이름이 있어야 합니다.

   자동 삭제

   주소 페더레이션 중에 로컬 브로커는 동적으로 원격 주소에 영구 큐를 생성합니다. auto-delete 속성의 값은 로컬 브로커의 연결이 끊어지면 원격 큐와 auto-delete- delay 및 auto-delete -message-count 속성에도 도달했는지 여부를 지정합니다. 동적으로 생성된 큐의 정리를 자동화하려는 경우 이 옵션이 유용합니다. 또한 로컬 브로커의 연결이 끊어진 경우 원격 브로커에서 메시지를 빌드하지 않으려는 경우에도 유용합니다. 그러나 연결이 끊긴 동안 메시지가 항상 로컬 브로커에 대해 큐에 남아 있도록 하려면 이 옵션을 false 로 설정하여 로컬 브로커에서 메시지 손실을 방지할 수 있습니다.

   auto-delete-delay

   로컬 브로커의 연결이 끊어진 후 이 속성의 값은 동적으로 생성된 원격 큐를 자동으로 삭제하기 전에 시간(밀리초)을 지정합니다.

   auto-delete-message-count

   로컬 브로커의 연결이 끊어진 후 이 속성의 값은 큐를 자동으로 삭제할 수 있기 전에 동적으로 생성된 원격 큐에 있을 수 있는 최대 메시지 수를 지정합니다.

   enable-divert-bindings

   이 속성을 true 로 설정하면 개별 바인딩이 요청에 대해 수신 대기됩니다. 주소 정책의 포함된 주소와 일치하는 주소가 포함된 다양한 바인딩이 있는 경우, 요약의 전달 주소와 일치하는 큐 바인딩은 수요가 생성됩니다. 기본값은 false입니다.

   max-hops

   페더레이션 중에 메시지를 만들 수 있는 최대 홉 수입니다. 특정 토폴로지에는 이 속성에 대한 특정 값이 필요합니다. 이러한 요구 사항에 대한 자세한 내용은 4.22.2절. “주소 연합을 위한 공통 토폴로지” 을 참조하십시오.

   transformer-ref

   변환기 구성의 이름입니다. 연합 메시지 전송 중에 메시지를 변환하려면 변환기 구성을 추가할 수 있습니다. Transformer 구성은 이 절차의 뒷부분에서 설명합니다.

4. < address-policy > 요소 내에서 주소 정책에서 주소를 포함 및 제외하는 address-matching 패턴을 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <address-policy name="news-address-federation" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" enable-divert-bindings="false" max-hops="1" transformer-ref="news-transformer">
   
               <include address-match="queue.bbc.new" />
               <include address-match="queue.usatoday" />
               <include address-match="queue.news.#" />
   
               <exclude address-match="queue.news.sport.#" />
           </address-policy>
   
       </federation>
   </federations>

   include

   이 요소의 address-match 속성 값은 주소 정책에 포함할 주소를 지정합니다. 정확한 주소(예: queue.bbc.new 또는 queue.usatoday )를 지정할 수 있습니다. 또는 와일드카드 식을 사용하여 일치하는 주소 집합 을 지정할 수 있습니다. 이전 예에서 address 정책에는 문자열 queue.news 로 시작하는 모든 주소 이름도 포함되어 있습니다.

   exclude

   이 요소의 address-match 속성 값은 주소 정책에서 제외할 주소를 지정합니다. 정확한 주소 이름을 지정하거나 와일드카드 식을 사용하여 일치하는 주소 집합 을 지정할 수 있습니다. 이전 예에서 address 정책은 string queue.news.sport 로 시작하는 모든 주소 이름을 제외합니다.

5. (선택 사항) 페더레이션 요소에서 사용자 지정 변환기 구현을 참조하는 변환기 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <address-policy name="news-address-federation" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" enable-divert-bindings="false" max-hops="1" transformer-ref="news-transformer">
   
               <include address-match="queue.bbc.new" />
               <include address-match="queue.usatoday" />
               <include address-match="queue.news.#" />
   
               <exclude address-match="queue.news.sport.#" />
           </address-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
   </federations>

   name

   변환기 구성의 이름입니다. 이 이름은 로컬 브로커에서 고유해야 합니다. 이는 주소 정책의 transformer-ref 속성에 대한 값으로 지정하는 이름입니다.

   class-name

   org.apache.activemq.artemis.core.server.transformer.Transformer 인터페이스를 구현하는 사용자 정의 클래스의 이름입니다.

   transformer의 transform() 메서드는 메시지를 전송하기 전에 메시지와 함께 호출됩니다. 이를 통해 메시지 헤더 또는 본문이 통합되기 전에 변환할 수 있습니다.

   속성

   특정 변환기 구성에 대해 키-값 쌍을 유지하는 데 사용됩니다.

6. 페더레이션 요소 내에서 하나 이상의 업스트림 요소를 추가합니다. 각 업스트림 요소는 원격 브로커와 해당 연결에 적용할 정책을 정의합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <upstream name="eu-east-1">
               <static-connectors>
                   <connector-ref>eu-east-connector1</connector-ref>
               </static-connectors>
               <policy ref="news-address-federation"/>
           </upstream>
   
           <upstream name="eu-west-1" >
               <static-connectors>
                   <connector-ref>eu-west-connector1</connector-ref>
               </static-connectors>
               <policy ref="news-address-federation"/>
           </upstream>
   
           <address-policy name="news-address-federation" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" enable-divert-bindings="false" max-hops="1" transformer-ref="news-transformer">
   
               <include address-match="queue.bbc.new" />
               <include address-match="queue.usatoday" />
               <include address-match="queue.news.#" />
   
               <exclude address-match="queue.news.sport.#" />
           </address-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
   </federations>

   static-connectors

   로컬 브로커의 broker.xml 구성 파일에서 정의된 커넥터 요소를 참조하는 connector -ref 요소 목록이 포함되어 있습니다. 커넥터는 발신 연결에 사용할 전송(TCP, SSL, HTTP 등) 및 서버 연결 매개 변수(host, port 등)를 정의합니다. 이 절차의 다음 단계에서는 static-connectors 요소에서 참조되는 커넥터를 추가하는 방법을 보여줍니다.

   policy-ref

   업스트림 브로커에 적용되는 다운스트림 브로커에 구성된 주소 정책의 이름입니다.

   업스트림 요소에 대해 지정할 수 있는 추가 옵션은 아래에 설명되어 있습니다.

   name

   업스트림 브로커 구성의 이름입니다. 이 예에서 이름은 eu-east-1 및 eu-west-1 이라는 업스트림 브로커에 해당합니다.

   user

   업스트림 브로커에 대한 연결을 생성할 때 사용할 사용자 이름입니다. 지정하지 않으면 페더레이션 요소의 구성에 지정된 공유 사용자 이름이 사용됩니다.

   암호

   업스트림 브로커에 대한 연결을 생성할 때 사용할 암호입니다. 지정하지 않으면 페더레이션 요소의 구성에 지정된 공유 암호가 사용됩니다.

   call-failover-timeout

   call-timeout 과 유사하지만 장애 조치(failover) 시도 중에 호출이 수행됩니다. 기본값은 -1 이며, 이는 시간 초과가 비활성화됨을 의미합니다.

   call-timeout

   페더레이션 연결은 차단 호출인 패킷을 전송할 때 원격 브로커의 응답을 대기하는 시간(밀리초)입니다. 이 시간이 경과하면 연결에서 예외가 발생합니다. 기본값은 30000 입니다.

   check-period

   로컬 브로커가 원격 브로커로 보내는 연속 "보통" 메시지 사이의 기간(밀리초)은 페더레이션 연결의 상태를 확인합니다. 페더레이션 연결이 정상이면 원격 브로커는 각 keep-alive 메시지에 응답합니다. 연결이 비정상인 경우 다운스트림 브로커가 업스트림 브로커에서 응답을 수신하지 못하면 회로 차단기 라는 메커니즘을 사용하여 페더레이션 소비자를 차단합니다. 자세한 내용은 circuit-breaker-timeout 매개변수에 대한 설명을 참조하십시오. check-period 매개변수의 기본값은 30000 입니다.

   circuit-breaker-timeout

   다운스트림과 업스트림 브로커 간의 단일 연결은 많은 연합 큐와 주소 소비자에 의해 공유될 수 있습니다. 브로커 간의 연결이 손실되는 경우 각 연합 소비자는 동시에 다시 연결을 시도할 수 있습니다. 이를 방지하기 위해 회로 차단기 라는 메커니즘은 소비자를 차단합니다. 지정된 시간 초과 값이 경과하면 회로 차단기가 연결을 다시 만듭니다. 성공하면 소비자는 차단 해제됩니다. 그렇지 않으면 회로 차단기가 다시 적용됩니다.

   connection-ttl

   원격 브로커에서 메시지 수신을 중지하면 페더레이션 연결이 활성 상태로 유지됩니다. 기본값은 60000 입니다.

   discovery-group-ref

   업스트림 브로커에 대한 연결에 대한 정적 커넥터를 정의하는 대신 이 요소를 사용하여 broker.xml 구성 파일의 다른 곳에서 이미 구성된 검색 그룹을 지정할 수 있습니다. 특히 이 요소의 discovery-group-name 속성에 대한 값으로 기존 검색 그룹을 지정합니다. 검색 그룹에 대한 자세한 내용은 14.1.5절. “브로커 검색 방법” 을 참조하십시오.

   ha

   업스트림 브로커 연결에 대해 고가용성을 활성화할지 여부를 지정합니다. 이 매개변수의 값이 true 로 설정된 경우 로컬 브로커는 업스트림 클러스터에서 사용 가능한 모든 브로커에 연결할 수 있으며 라이브 업스트림 브로커가 종료되면 백업 브로커로 자동으로 실패합니다. 기본값은 false입니다.

   initial-connect-attempts

   다운스트림 브로커가 업스트림 브로커에 연결하려고 하는 초기 시도 수입니다. 연결이 설정되지 않은 경우 업스트림 브로커는 영구적으로 오프라인 상태로 간주됩니다. 다운스트림 브로커는 더 이상 메시지를 업스트림 브로커로 라우팅하지 않습니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다.

   max-retry-interval

   원격 브로커에 연결할 때 후속 재시도 시도 사이의 최대 시간(밀리초)입니다. 기본값은 2000 입니다.

   reconnect-attempts

   다운스트림 브로커가 연결에 실패한 경우 업스트림 브로커에 다시 연결을 시도하는 횟수입니다. 연결을 재설정하지 않고 이 값에 도달하면 업스트림 브로커는 영구적으로 오프라인 상태로 간주됩니다. 다운스트림 브로커는 더 이상 메시지를 업스트림 브로커로 라우팅하지 않습니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다.

   retry-interval

   원격 브로커에 대한 연결이 실패한 경우 후속 재시도 시도 사이의 기간(밀리초)입니다. 기본값은 500 입니다.

   retry-interval-multiplier

   retry-interval 매개 변수의 값에 적용되는 요인을 곱합니다. 기본값은 1 입니다.

   share-connection

   동일한 브로커에 대해 다운스트림 및 업스트림 연결이 모두 구성된 경우 다운스트림 및 업스트림 구성 모두 이 매개 변수의 값을 true 로 설정하는 경우 동일한 연결이 공유됩니다. 기본값은 false입니다.

7. 로컬 브로커에서 원격 브로커에 커넥터를 추가합니다. 이는 연합 주소 구성의 정적 연결 요소에서 참조되는 커넥터 입니다. 예를 들면 다음과 같습니다.

   <connectors>
      <connector name="eu-west-1-connector">tcp://localhost:61616</connector>
      <connector name="eu-east-1-connector">tcp://localhost:61617</connector>
   </connectors>

절차

1. 로컬 브로커에서 < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < feder ation> 요소를 포함하는 <federations > 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
       </federation>
   </federations>

3. 주소 정책 구성을 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       ...
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <address-policy name="news-address-federation" max-hops="1" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" transformer-ref="news-transformer">
   
               <include address-match="queue.bbc.new" />
               <include address-match="queue.usatoday" />
               <include address-match="queue.news.#" />
   
               <exclude address-match="queue.news.sport.#" />
           </address-policy>
   
       </federation>
     ...
   </federations>

4. 전송 전에 메시지를 변환하려면 변환기 구성을 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       ...
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <address-policy name="news-address-federation" max-hops="1" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" transformer-ref="news-transformer">
   
               <include address-match="queue.bbc.new" />
               <include address-match="queue.usatoday" />
               <include address-match="queue.news.#" />
   
               <exclude address-match="queue.news.sport.#" />
           </address-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
     ...
   </federations>

5. 각 원격 브로커에 대해 downstream 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       ...
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <downstream name="eu-east-1">
                   <static-connectors>
                       <connector-ref>eu-east-connector1</connector-ref>
                   </static-connectors>
                   <transport-connector-ref>netty-connector</transport-connector-ref>
                   <policy ref="news-address-federation"/>
           </downstream>
   
           <downstream name="eu-west-1" >
                   <static-connectors>
                       <connector-ref>eu-west-connector1</connector-ref>
                   </static-connectors>
                   <transport-connector-ref>netty-connector</transport-connector-ref>
                   <policy ref="news-address-federation"/>
           </downstream>
   
           <address-policy name="news-address-federation" max-hops="1" auto-delete="true" auto-delete-delay="300000" auto-delete-message-count="-1" transformer-ref="news-transformer">
               <include address-match="queue.bbc.new" />
               <include address-match="queue.usatoday" />
               <include address-match="queue.news.#" />
   
               <exclude address-match="queue.news.sport.#" />
           </address-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
     ...
   </federations>

   이전 구성에 표시된 대로 원격 브로커는 이제 로컬 브로커의 다운스트림으로 간주됩니다. 다운스트림 브로커는 구성의 연결 정보를 사용하여 로컬(즉, 업스트림) 브로커에 다시 연결합니다.

6. 로컬 브로커에서 로컬 및 원격 브로커가 사용하는 커넥터 및 수락자를 추가하여 페더레이션 연결을 설정합니다. 예를 들면 다음과 같습니다.

   <connectors>
      <connector name="netty-connector">tcp://localhost:61616</connector>
      <connector name="eu-west-1-connector">tcp://localhost:61616</connector>
      <connector name="eu-east-1-connector">tcp://localhost:61617</connector>
   </connectors>
   
   <acceptors>
      <acceptor name="netty-acceptor">tcp://localhost:61616</acceptor>
   </acceptors>

   connector name="netty-connector"

   로컬 브로커가 원격 브로커로 전송하는 커넥터 구성입니다. 원격 브로커는 이 구성을 사용하여 다시 로컬 브로커에 연결합니다.

   connector name="eu-west-1-connector", connector name="eu-east-1-connector"

   원격 브로커에 연결합니다. 로컬 브로커는 이러한 커넥터를 사용하여 원격 브로커에 연결하고 원격 브로커가 로컬 브로커에 다시 연결하는 데 필요한 구성을 공유합니다.

   acceptor name="netty-acceptor"

   원격 브로커가 로컬 브로커에 다시 연결하는 데 사용하는 커넥터에 해당하는 로컬 브로커의 수락입니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 새로운 < federations > 요소 내에서 < federation> 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
     <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
     </federation>
   </federations>

   name

   페더레이션 구성의 이름입니다. 이 예에서 name은 downstream 브로커의 이름에 해당합니다.

   user

   업스트림 브로커에 연결하기 위한 공유 사용자 이름입니다.

   암호

   업스트림 브로커와의 연결에 대한 공유 암호입니다.

   참고
   • 업스트림 브로커에 대해 사용자 및 암호 인증 정보가 다른 경우 구성에 추가할 때 해당 브로커의 인증 정보를 별도로 지정할 수 있습니다. 이 내용은 이 절차의 뒷부분에서 설명합니다.

3. 페더레이션 요소 내에서 &lt; queue-policy&gt; 요소를 추가합니다. < queue-policy> 요소의 속성에 대한 값을 지정합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <queue-policy name="news-queue-federation" include-federated="true" priority-adjustment="-5" transformer-ref="news-transformer">
           </queue-policy>
   
       </federation>
   </federations>

   name

   큐 정책의 이름입니다. 브로커에 구성된 모든 큐 정책에는 고유한 이름이 있어야 합니다.

   include-federated

   이 속성의 값이 false 로 설정되면 구성이 이미 제공된 소비자(즉, 페더레이션 대기열의 소비자)를 다시 변형시키지 않습니다. 이를 통해 대칭 또는 폐쇄 루프 토폴로지의 경우 작동하지 않는 소비자가 없으며 메시지는 시스템 전체에서 무한대로 흐르는 상황을 방지할 수 있습니다.

   닫기 루프 토폴로지가 없는 경우 이 속성의 값을 true 로 설정할 수 있습니다.You might set the value of this property to true if you do not have a closed-loop topology. 예를 들어 BrokerA 및 BrokerC 의 생산자가 있는 3개의 브로커, BrokerA,BrokerB 및 BrokerC 체인이 있다고 가정합니다. 이 경우 BrokerB 에서 소비자를 BrokerA 에 다시 제공하려고 합니다.

   priority-adjustment

   소비자가 큐에 연결할 때 해당 우선 순위는 업스트림 소비자(즉, 페더레이션) 소비자가 생성될 때 사용됩니다. 연합 소비자의 우선 순위는 우선 순위 속성의 값에 의해 조정 됩니다. 이 속성의 기본값은 -1 이며, 이는 부하 분산 중에 로컬 소비자가 페더레이션 소비자보다 우선 순위를 지정할 수 있습니다. 그러나 필요에 따라 우선순위 조정의 값을 변경할 수 있습니다.

   transformer-ref

   변환기 구성의 이름입니다. 연합 메시지 전송 중에 메시지를 변환하려면 변환기 구성을 추가할 수 있습니다. Transformer 구성은 이 절차의 뒷부분에서 설명합니다.

4. < queue-policy > 요소 내에서 큐 정책에서 주소를 포함 및 제외하는 address-matching 패턴을 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <queue-policy name="news-queue-federation" include-federated="true" priority-adjustment="-5" transformer-ref="news-transformer">
   
               <include queue-match="#" address-match="queue.bbc.new" />
               <include queue-match="#" address-match="queue.usatoday" />
               <include queue-match="#" address-match="queue.news.#" />
   
               <exclude queue-match="#.local" address-match="#" />
   
           </queue-policy>
   
       </federation>
   </federations>

   include

   이 요소의 address-match 속성 값은 큐 정책에 포함할 주소를 지정합니다. 정확한 주소(예: queue.bbc.new 또는 queue.usatoday )를 지정할 수 있습니다. 또는 와일드카드 식을 사용하여 일치하는 주소 집합 을 지정할 수 있습니다. 이전 예에서 큐 정책에는 문자열 queue.news 로 시작하는 모든 주소 이름도 포함되어 있습니다.

   address-match 속성과 함께 queue-match 속성을 사용하여 큐 정책의 해당 주소에 특정 큐를 포함할 수 있습니다. address-match 속성과 마찬가지로 정확한 대기열 이름을 지정하거나 와일드카드 표현식을 사용하여 큐 세트 를 지정할 수 있습니다. 앞의 예제에서 숫자 기호(#) 와일드카드 문자는 각 주소 또는 주소 세트의 모든 큐가 큐 정책에 포함됨을 의미합니다.

   exclude

   이 요소의 address-match 속성 값은 큐 정책에서 제외할 주소를 지정합니다. 정확한 주소를 지정하거나 와일드카드 식을 사용하여 일치하는 주소 집합 을 지정할 수 있습니다. 앞의 예제에서 숫자 기호(#) 와일드카드 문자는 모든 주소에서 queue-match 속성과 일치하는 모든 큐가 제외됨을 의미합니다. 이 경우 .local 문자열로 끝나는 모든 큐는 제외됩니다. 이는 특정 대기열이 로컬 대기열로 유지되며 통합되지 않음을 나타냅니다.

5. 페더레이션 요소 내에서 사용자 지정 변환기 구현을 참조하기 위해 변환기 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <queue-policy name="news-queue-federation" include-federated="true" priority-adjustment="-5" transformer-ref="news-transformer">
   
               <include queue-match="#" address-match="queue.bbc.new" />
               <include queue-match="#" address-match="queue.usatoday" />
               <include queue-match="#" address-match="queue.news.#" />
   
               <exclude queue-match="#.local" address-match="#" />
   
           </queue-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
   </federations>

   name

   변환기 구성의 이름입니다. 이 이름은 해당 브로커에서 고유해야 합니다. 이 이름을 주소 정책의 transformer-ref 속성에 대한 값으로 지정합니다.

   class-name

   org.apache.activemq.artemis.core.server.transformer.Transformer 인터페이스를 구현하는 사용자 정의 클래스의 이름입니다.

   transformer의 transform() 메서드는 메시지를 전송하기 전에 메시지와 함께 호출됩니다. 이를 통해 메시지 헤더 또는 본문이 통합되기 전에 변환할 수 있습니다.

   속성

   특정 변환기 구성에 대해 키-값 쌍을 유지하는 데 사용됩니다.

6. 페더레이션 요소 내에서 하나 이상의 업스트림 요소를 추가합니다. 각 업스트림 요소는 해당 연결에 적용할 업스트림 브로커 연결 및 정책을 정의합니다. 예를 들면 다음과 같습니다.

   <federations>
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <upstream name="eu-east-1">
               <static-connectors>
                   <connector-ref>eu-east-connector1</connector-ref>
               </static-connectors>
               <policy ref="news-queue-federation"/>
           </upstream>
   
           <upstream name="eu-west-1" >
               <static-connectors>
                   <connector-ref>eu-west-connector1</connector-ref>
               </static-connectors>
               <policy ref="news-queue-federation"/>
           </upstream>
   
           <queue-policy name="news-queue-federation" include-federated="true" priority-adjustment="-5" transformer-ref="news-transformer">
   
               <include queue-match="#" address-match="queue.bbc.new" />
               <include queue-match="#" address-match="queue.usatoday" />
               <include queue-match="#" address-match="queue.news.#" />
   
               <exclude queue-match="#.local" address-match="#" />
   
           </queue-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
   </federations>

   static-connectors

   로컬 브로커의 broker.xml 구성 파일에서 정의된 커넥터 요소를 참조하는 connector -ref 요소 목록이 포함되어 있습니다. 커넥터는 발신 연결에 사용할 전송(TCP, SSL, HTTP 등) 및 서버 연결 매개 변수(host, port 등)를 정의합니다. 이 절차의 다음 단계에서는 페더레이션 대기열 구성의 정적 연결 요소에서 참조한 커넥터 를 추가하는 방법을 보여줍니다.

   policy-ref

   업스트림 브로커에 적용되는 다운스트림 브로커에 구성된 큐 정책의 이름입니다.

   업스트림 요소에 대해 지정할 수 있는 추가 옵션은 아래에 설명되어 있습니다.

   name

   업스트림 브로커 구성의 이름입니다. 이 예에서 이름은 eu-east-1 및 eu-west-1 이라는 업스트림 브로커에 해당합니다.

   user

   업스트림 브로커에 대한 연결을 생성할 때 사용할 사용자 이름입니다. 지정하지 않으면 페더레이션 요소의 구성에 지정된 공유 사용자 이름이 사용됩니다.

   암호

   업스트림 브로커에 대한 연결을 생성할 때 사용할 암호입니다. 지정하지 않으면 페더레이션 요소의 구성에 지정된 공유 암호가 사용됩니다.

   call-failover-timeout

   call-timeout 과 유사하지만 장애 조치(failover) 시도 중에 호출이 수행됩니다. 기본값은 -1 이며, 이는 시간 초과가 비활성화됨을 의미합니다.

   call-timeout

   페더레이션 연결은 차단 호출인 패킷을 전송할 때 원격 브로커의 응답을 대기하는 시간(밀리초)입니다. 이 시간이 경과하면 연결에서 예외가 발생합니다. 기본값은 30000 입니다.

   check-period

   로컬 브로커가 원격 브로커로 보내는 연속 "보통" 메시지 사이의 기간(밀리초)은 페더레이션 연결의 상태를 확인합니다. 페더레이션 연결이 정상이면 원격 브로커는 각 keep-alive 메시지에 응답합니다. 연결이 비정상인 경우 다운스트림 브로커가 업스트림 브로커에서 응답을 수신하지 못하면 회로 차단기 라는 메커니즘을 사용하여 페더레이션 소비자를 차단합니다. 자세한 내용은 circuit-breaker-timeout 매개변수에 대한 설명을 참조하십시오. check-period 매개변수의 기본값은 30000 입니다.

   circuit-breaker-timeout

   다운스트림과 업스트림 브로커 간의 단일 연결은 많은 연합 큐와 주소 소비자에 의해 공유될 수 있습니다. 브로커 간의 연결이 손실되는 경우 각 연합 소비자는 동시에 다시 연결을 시도할 수 있습니다. 이를 방지하기 위해 회로 차단기 라는 메커니즘은 소비자를 차단합니다. 지정된 시간 초과 값이 경과하면 회로 차단기가 연결을 다시 만듭니다. 성공하면 소비자는 차단 해제됩니다. 그렇지 않으면 회로 차단기가 다시 적용됩니다.

   connection-ttl

   원격 브로커에서 메시지 수신을 중지하면 페더레이션 연결이 활성 상태로 유지됩니다. 기본값은 60000 입니다.

   discovery-group-ref

   업스트림 브로커에 대한 연결에 대한 정적 커넥터를 정의하는 대신 이 요소를 사용하여 broker.xml 구성 파일의 다른 곳에서 이미 구성된 검색 그룹을 지정할 수 있습니다. 특히 이 요소의 discovery-group-name 속성에 대한 값으로 기존 검색 그룹을 지정합니다. 검색 그룹에 대한 자세한 내용은 14.1.5절. “브로커 검색 방법” 을 참조하십시오.

   ha

   업스트림 브로커 연결에 대해 고가용성을 활성화할지 여부를 지정합니다. 이 매개변수의 값이 true 로 설정된 경우 로컬 브로커는 업스트림 클러스터에서 사용 가능한 모든 브로커에 연결할 수 있으며 라이브 업스트림 브로커가 종료되면 백업 브로커로 자동으로 실패합니다. 기본값은 false입니다.

   initial-connect-attempts

   다운스트림 브로커가 업스트림 브로커에 연결하려고 하는 초기 시도 수입니다. 연결이 설정되지 않은 경우 업스트림 브로커는 영구적으로 오프라인 상태로 간주됩니다. 다운스트림 브로커는 더 이상 메시지를 업스트림 브로커로 라우팅하지 않습니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다.

   max-retry-interval

   원격 브로커에 연결할 때 후속 재시도 시도 사이의 최대 시간(밀리초)입니다. 기본값은 2000 입니다.

   reconnect-attempts

   다운스트림 브로커가 연결에 실패한 경우 업스트림 브로커에 다시 연결을 시도하는 횟수입니다. 연결을 재설정하지 않고 이 값에 도달하면 업스트림 브로커는 영구적으로 오프라인 상태로 간주됩니다. 다운스트림 브로커는 더 이상 메시지를 업스트림 브로커로 라우팅하지 않습니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다.

   retry-interval

   원격 브로커에 대한 연결이 실패한 경우 후속 재시도 시도 사이의 기간(밀리초)입니다. 기본값은 500 입니다.

   retry-interval-multiplier

   retry-interval 매개 변수의 값에 적용되는 요인을 곱합니다. 기본값은 1 입니다.

   share-connection

   동일한 브로커에 대해 다운스트림 및 업스트림 연결이 모두 구성된 경우 다운스트림 및 업스트림 구성 모두 이 매개 변수의 값을 true 로 설정하는 경우 동일한 연결이 공유됩니다. 기본값은 false입니다.

7. 로컬 브로커에서 원격 브로커에 커넥터를 추가합니다. 이는 연합 주소 구성의 정적 연결 요소에서 참조되는 커넥터 입니다. 예를 들면 다음과 같습니다.

   <connectors>
      <connector name="eu-west-1-connector">tcp://localhost:61616</connector>
      <connector name="eu-east-1-connector">tcp://localhost:61617</connector>
   </connectors>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < feder ation> 요소를 포함하는 <federations > 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
     <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
     </federation>
   </federations>

3. 큐 정책 구성을 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       ...
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <queue-policy name="news-queue-federation" priority-adjustment="-5" include-federated="true" transformer-ref="new-transformer">
   
               <include queue-match="#" address-match="queue.bbc.new" />
               <include queue-match="#" address-match="queue.usatoday" />
               <include queue-match="#" address-match="queue.news.#" />
   
               <exclude queue-match="#.local" address-match="#" />
   
           </queue-policy>
   
       </federation>
     ...
   </federations>

4. 전송 전에 메시지를 변환하려면 변환기 구성을 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       ...
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <queue-policy name="news-queue-federation" priority-adjustment="-5" include-federated="true" transformer-ref="news-transformer">
   
               <include queue-match="#" address-match="queue.bbc.new" />
               <include queue-match="#" address-match="queue.usatoday" />
               <include queue-match="#" address-match="queue.news.#" />
   
               <exclude queue-match="#.local" address-match="#" />
   
           </queue-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
     ...
   </federations>

5. 각 원격 브로커에 대해 downstream 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <federations>
       ...
       <federation name="eu-north-1" user="federation_username" password="32a10275cf4ab4e9">
   
           <downstream name="eu-east-1">
               <static-connectors>
                   <connector-ref>eu-east-connector1</connector-ref>
               </static-connectors>
               <transport-connector-ref>netty-connector</transport-connector-ref>
               <policy ref="news-address-federation"/>
           </downstream>
   
           <downstream name="eu-west-1" >
               <static-connectors>
                   <connector-ref>eu-west-connector1</connector-ref>
               </static-connectors>
               <transport-connector-ref>netty-connector</transport-connector-ref>
               <policy ref="news-address-federation"/>
           </downstream>
   
           <queue-policy name="news-queue-federation" priority-adjustment="-5" include-federated="true" transformer-ref="new-transformer">
   
               <include queue-match="#" address-match="queue.bbc.new" />
               <include queue-match="#" address-match="queue.usatoday" />
               <include queue-match="#" address-match="queue.news.#" />
   
               <exclude queue-match="#.local" address-match="#" />
   
           </queue-policy>
   
           <transformer name="news-transformer">
               <class-name>org.foo.NewsTransformer</class-name>
               <property key="key1" value="value1"/>
               <property key="key2" value="value2"/>
           </transformer>
   
       </federation>
     ...
   </federations>

   이전 구성에 표시된 대로 원격 브로커는 이제 로컬 브로커의 다운스트림으로 간주됩니다. 다운스트림 브로커는 구성의 연결 정보를 사용하여 로컬(즉, 업스트림) 브로커에 다시 연결합니다.

6. 로컬 브로커에서 로컬 및 원격 브로커가 사용하는 커넥터 및 수락자를 추가하여 페더레이션 연결을 설정합니다. 예를 들면 다음과 같습니다.

   <connectors>
      <connector name="netty-connector">tcp://localhost:61616</connector>
      <connector name="eu-west-1-connector">tcp://localhost:61616</connector>
      <connector name="eu-east-1-connector">tcp://localhost:61617</connector>
   </connectors>
   
   <acceptors>
      <acceptor name="netty-acceptor">tcp://localhost:61616</acceptor>
   </acceptors>

   connector name="netty-connector"

   로컬 브로커가 원격 브로커로 전송하는 커넥터 구성입니다. 원격 브로커는 이 구성을 사용하여 다시 로컬 브로커에 연결합니다.

   connector name="eu-west-1-connector" , connector name="eu-east-1-connector"

   원격 브로커에 연결합니다. 로컬 브로커는 이러한 커넥터를 사용하여 원격 브로커에 연결하고 원격 브로커가 로컬 브로커에 다시 연결하는 데 필요한 구성을 공유합니다.

   acceptor name="netty-acceptor"

   원격 브로커가 로컬 브로커에 다시 연결하는 데 사용하는 커넥터에 해당하는 로컬 브로커의 수락입니다.

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 지정된 수락자의 경우 sslEnabled 키를 추가하고 값을 true 로 설정합니다. 또한 keyStorePath 및 keyStorePassword 키를 추가합니다. 브로커 키 저장소에 해당하는 값을 설정합니다. 예를 들면 다음과 같습니다.

   <acceptor name="artemis">tcp://0.0.0.0:61616?sslEnabled=true;keyStorePath=../etc/broker.keystore;keyStorePassword=1234!</acceptor>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 단방향 TLS를 위해 이전에 구성한 수락자의 경우 needClientAuth 키를 추가합니다. 값을 true 로 설정합니다. 예를 들면 다음과 같습니다.

   <acceptor name="artemis">tcp://0.0.0.0:61616?sslEnabled=true;keyStorePath=../etc/broker.keystore;keyStorePassword=1234!;needClientAuth=true</acceptor>

3. 이전 단계의 구성은 클라이언트의 인증서가 신뢰할 수 있는 공급자가 서명한다고 가정합니다. 클라이언트의 인증서가 신뢰할 수 있는 공급자(예: 자체 서명)에서 서명 되지 않은 경우 브로커는 클라이언트의 인증서를 신뢰 저장소로 가져와야 합니다. 이 경우 trustStorePath 및 trustStorePassword 키를 추가합니다. 브로커 신뢰 저장소에 해당하는 값을 설정합니다. 예를 들면 다음과 같습니다.

   <acceptor name="artemis">tcp://0.0.0.0:61616?sslEnabled=true;keyStorePath=../etc/broker.keystore;keyStorePassword=1234!;needClientAuth=true;trustStorePath=../etc/client.truststore;trustStorePassword=5678!</acceptor>

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. security-settings 요소 내에서 security-setting 요소를 추가하여 권한을 구성합니다. 예를 들면 다음과 같습니다.

   <security-settings>
       <security-setting match="#">
           <permission type="createDurableQueue" roles="user"/>
           <permission type="deleteDurableQueue" roles="user"/>
           <permission type="createNonDurableQueue" roles="user"/>
           <permission type="deleteNonDurableQueue" roles="user"/>
           <permission type="send" roles="user"/>
           <permission type="consume" roles="user"/>
       </security-setting>
   </security-settings>

   이전 구성은 모든 큐에 대한 특정 권한을 사용자 역할의 구성원에게 할당합니다.

3. < broker_instance_dir> /etc/login.config 파일을 엽니다.

4. 사용 중인 디렉터리 서비스를 기반으로 LDAP 로그인 모듈을 설정합니다.

   1. Microsoft Active Directory 디렉터리 서비스를 사용하는 경우 다음 예와 유사한 구성을 추가합니다.

      activemq {
        org.apache.activemq.artemis.spi.core.security.jaas.LDAPLoginModule required
           debug=true
           initialContextFactory=com.sun.jndi.ldap.LdapCtxFactory
           connectionURL="LDAP://localhost:389"
           connectionUsername="CN=Administrator,CN=Users,OU=System,DC=example,DC=com"
           connectionPassword=redhat.123
           connectionProtocol=s
           connectionTimeout="5000"
           authentication=simple
           userBase="dc=example,dc=com"
           userSearchMatching="(CN={0})"
           userSearchSubtree=true
           readTimeout="5000"
           roleBase="dc=example,dc=com"
           roleName=cn
           roleSearchMatching="(member={0})"
           roleSearchSubtree=true
           ;
      };

      참고

      Microsoft Active Directory를 사용하고 있고 connectionUsername 의 속성에 대해 지정해야 하는 값에는 공백(예: OU=System Accounts )에 공백(예: OU=System Accounts)이 포함된 경우 해당 값을 큰따옴표("") 쌍으로 묶고 백슬래시(\)를 사용하여 쌍으로 이스케이프해야 합니다. 예를 들어 connectionUsername="CN=Administrator,CN=Users,OU=\"System Accounts\",DC=example,DC=com".

   2. ApacheDS 디렉터리 서비스를 사용하는 경우 다음 예와 유사한 구성을 추가합니다.

      activemq {
        org.apache.activemq.artemis.spi.core.security.jaas.LDAPLoginModule required
           debug=true
           initialContextFactory=com.sun.jndi.ldap.LdapCtxFactory
           connectionURL="ldap://localhost:10389"
           connectionUsername="uid=admin,ou=system"
           connectionPassword=secret
           connectionProtocol=s
           connectionTimeout=5000
           authentication=simple
           userBase="dc=example,dc=com"
           userSearchMatching="(uid={0})"
           userSearchSubtree=true
           userRoleName=
           readTimeout=5000
           roleBase="dc=example,dc=com"
           roleName=cn
           roleSearchMatching="(member={0})"
           roleSearchSubtree=true
           ;
      };

      debug

      디버깅을 켜십시오(true) 또는 off(false). 기본값은 false입니다.

      initialContextFactory

      항상 com.sun.jndi.ldap.LdapCtxFactory로 설정해야 합니다.

      connectionURL

      LDAP URL을 사용하는 디렉터리 서버의 위치, __<ldap://Host:Port>. 슬래시 / 다음에 디렉터리 트리에 특정 노드의 DN을 추가하여 선택적으로 이 URL의 자격을 부여할 수 있습니다. Apache DS의 기본 포트는 10389 이며 Microsoft AD의 경우 기본값은 389 입니다.

      connectionUsername

      디렉터리 서버에 대한 연결을 여는 사용자의 고유 이름(DN)입니다. 예를 들면 uid=admin,ou=system 입니다. 디렉터리 서버는 일반적으로 클라이언트가 연결을 열기 위해 사용자 이름/암호 자격 증명을 제공해야 합니다.

      connectionPassword

      connectionUsername 에서 DN과 일치하는 암호입니다. 디렉터리 서버의 DIT( Directory Information Tree )에서 암호는 일반적으로 해당 디렉터리 항목에 userPassword 속성으로 저장됩니다.

      connectionProtocol

      모든 값이 지원되지만 효과적으로 사용되지 않습니다. 이 옵션은 기본값이 없으므로 명시적으로 설정해야 합니다.

      connectionTimeout

      브로커가 디렉터리 서버에 연결하는 데 사용할 수 있는 최대 시간(밀리초)을 지정합니다. 브로커가 이 시간 내에 디렉터리에 연결할 수 없는 경우 연결 시도가 중단됩니다. 이 속성에 대해 값을 0 이하로 지정하면 기본 TCP 프로토콜의 시간 초과 값이 대신 사용됩니다.If you specify a value of zero or less for this property, the timeout value of the underlying TCP protocol is used instead. 값을 지정하지 않으면 브로커가 무기한 대기하여 연결을 설정하거나 기본 네트워크 시간이 초과됩니다.

      연결 풀링이 연결에 대해 요청되면 이 속성은 최대 풀 크기에 이미 도달하고 풀의 모든 연결이 사용 중인 경우 브로커가 연결을 대기하는 최대 시간을 지정합니다. 값을 0 이하로 지정하면 브로커가 연결을 사용할 수 있을 때까지 무기한 대기합니다. 그렇지 않으면 브로커는 최대 대기 시간에 도달할 때 연결 시도를 중단합니다.

      인증

      LDAP 서버에 바인딩할 때 사용되는 인증 방법을 지정합니다. 이 매개변수는 단순 (사용자 이름과 암호가 필요한) 또는 none ( anonymous 액세스를 허용하는)으로 설정할 수 있습니다.

      userBase

      DIT의 특정 하위 트리를 선택하여 사용자 항목을 검색합니다. 하위 트리는 DN에 의해 지정되며 하위 트리의 기본 노드를 지정합니다. 예를 들어 이 옵션을 ou=User,ou=ActiveMQ,ou=system 로 설정하면 사용자 항목 검색이 ou=User,ou=ActiveMQ,ou=system 노드 아래의 하위 트리로 제한됩니다.

      userSearchMatching

      userBase 에서 선택한 하위 트리에 적용되는 LDAP 검색 필터를 지정합니다. 자세한 내용은 5.4.1.1절. “검색 일치 매개변수” 섹션을 참조하십시오.

      userSearchSubtree

      userBase 에서 지정한 노드와 관련하여 사용자 항목에 대한 검색 깊이를 지정합니다. 이 옵션은 부울입니다. false 값을 지정하면 검색이 userBase 노드의 하위 항목 중 하나와 일치하게 됩니다(maps to javax.naming.directory.SearchControls.ONELEVEL_SCOPE). 값이 true 이면 검색에서 userBase 노드의 하위 트리에 속하는 모든 항목( javax.naming.directory.SearchControls.SUBTREE_SCOPE)과 일치함을 의미합니다.

      userRoleName

      사용자의 역할 이름 목록이 포함된 사용자 항목의 속성 이름입니다. 역할 이름은 브로커의 권한 부여 플러그인에 의해 그룹 이름으로 해석됩니다. 이 옵션을 생략하면 사용자 항목에서 역할 이름을 추출하지 않습니다.

      readTimeout

      브로커가 디렉터리 서버에서 LDAP 요청에 대한 응답을 수신 대기할 수 있는 최대 시간(밀리초)을 지정합니다. 브로커가 현재 디렉터리 서버에서 응답을 받지 못하면 브로커가 요청을 중단합니다. 값을 0 이하로 지정하거나 값을 지정하지 않으면 브로커는 디렉터리 서버에서 LDAP 요청으로의 응답을 무기한 대기합니다.

      roleBase

      역할 데이터가 디렉터리 서버에 직접 저장되는 경우 userRoleName 옵션을 지정하는 대신 역할 옵션(roleBase,roleSearchMatching,roleSearchSubtree, roleName)의 조합을 사용할 수 있습니다. 이 옵션은 역할/그룹 항목을 검색하기 위해 DIT의 특정 하위 트리를 선택합니다. 하위 트리는 DN에 의해 지정되며 하위 트리의 기본 노드를 지정합니다. 예를 들어 이 옵션을 ou=Group,ou=ActiveMQ,ou=system 로 설정하면 role/group 항목 검색이 ou=Group,ou=system 노드 아래의 하위 트리로 제한됩니다.

      roleName

      역할/그룹의 이름(예: C, O, OU 등)이 포함된 역할 항목의 특성 유형입니다. 이 옵션을 생략하면 역할 검색 기능이 효과적으로 비활성화됩니다.

      roleSearchMatching

      역할Base 에서 선택한 하위 트리에 적용되는 LDAP 검색 필터를 지정합니다. 자세한 내용은 5.4.1.1절. “검색 일치 매개변수” 섹션을 참조하십시오.

      roleSearchSubtree

      roleBase 에서 지정한 노드와 관련하여 역할 항목에 대한 검색 깊이를 지정합니다. false 로 설정하면 검색이 roleBase 노드의 하위 항목 중 하나와 일치하려고 합니다(Java x.naming.directory.SearchControls.ONELEVEL_SCOPE에 매핑). true 인 경우 roleBase 노드의 하위 트리에 속하는 모든 항목( javax.naming.directory.SearchControls.SUBTREE_SCOPE)에 매핑합니다.

      참고

      Apache DS는 DN 경로의 OID 부분을 사용합니다. Microsoft Active Directory는 CN 부분을 사용합니다. 예를 들어 Apache DS에서 oid=testuser,dc=example,dc=com 과 같은 DN 경로를 사용할 수 있지만 Microsoft Active Directory의 cn=testuser,dc=example,dc=com 과 같은 DN 경로를 사용할 수 있습니다.

5. 브로커(서비스 또는 프로세스)를 시작하거나 다시 시작합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. security-settings 요소 내에서 security-setting-plugin 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <security-settings>
       <security-setting-plugin class-name="org.apache.activemq.artemis.core.server.impl.LegacyLDAPSecuritySettingPlugin">
           <setting name="initialContextFactory" value="com.sun.jndi.ldap.LdapCtxFactory"/>
           <setting name="connectionURL" value="ldap://localhost:1024"/>`ou=destinations,o=ActiveMQ,ou=system`
           <setting name="connectionUsername" value="uid=admin,ou=system"/>
           <setting name="connectionPassword" value="secret"/>
           <setting name="connectionProtocol" value="s"/>
           <setting name="authentication" value="simple"/>
       </security-setting-plugin>
   </security-settings>

   class-name

   구현은 org.apache.activemq.artemis.core.server.impl.LegacyLDAPSecuritySettingPlugin 입니다.

   initialContextFactory

   LDAP에 연결하는 데 사용되는 초기 컨텍스트 팩토리입니다. 항상 com.sun.jndi.ldap.LdapCtxFactory (기본값)로 설정해야 합니다.

   connectionURL

   LDAP URL을 사용하여 디렉터리 서버의 위치를 지정합니다. <ldap://Host:Port& gt;. 디렉터리 트리에 특정 노드의 고유 이름(DN)을 추가한 다음 슬래시 / 를 추가하여 이 URL의 자격을 선택적으로 지정할 수 있습니다. 예: ldap://ldapserver:10389/ou=system. 기본값은 ldap://localhost:1024 입니다.

   connectionUsername

   디렉터리 서버에 대한 연결을 여는 사용자의 DN입니다. 예를 들면 uid=admin,ou=system 입니다. 디렉터리 서버는 일반적으로 클라이언트가 연결을 열기 위해 사용자 이름/암호 자격 증명을 제공해야 합니다.

   connectionPassword

   connectionUsername 에서 DN과 일치하는 암호입니다. 디렉터리 서버의 DIT( Directory Information Tree )에서 암호는 일반적으로 해당 디렉터리 항목에 userPassword 속성으로 저장됩니다.

   connectionProtocol

   현재는 사용되지 않습니다. 나중에 이 옵션을 사용하면 디렉터리 서버에 연결할 Secure Socket Layer(SSL)을 선택할 수 있습니다. 이 옵션은 기본값이 없으므로 명시적으로 설정해야 합니다.

   인증

   LDAP 서버에 바인딩할 때 사용되는 인증 방법을 지정합니다. 이 매개 변수의 유효한 값은 simple (사용자 이름 및 암호) 또는 none (익명)입니다. 기본값은 simple 입니다.

   참고

   ASL(Simple Authentication and Security Layer) 인증은 지원되지 않습니다.

1. 명령 프롬프트에서 mask 유틸리티를 사용하여 암호를 암호화합니다.

   $ <broker_instance_dir>/bin/artemis mask <password>

   result: 3a34fd21b82bf2a822fa49a8d8fa115d

2. < broker_instance_dir> /etc/login.config 파일을 엽니다. connectionPassword 매개변수를 찾습니다.

   connectionPassword = <password>

3. 일반 텍스트 암호를 암호화된 값으로 바꿉니다.

   connectionPassword = 3a34fd21b82bf2a822fa49a8d8fa115d

4. 암호화된 값을 "ENC()" 식별자로 래핑합니다.

   connectionPassword = "ENC(3a34fd21b82bf2a822fa49a8d8fa115d)"

절차

1. 브로커를 중지합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis stop

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe stop

2. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

3. 허용 자 URL의 쿼리 문자열에 이름-값 쌍 saslMechanisms=GSSAPI 를 추가합니다.

   <acceptor name="amqp">
     tcp://0.0.0.0:5672?protocols=AMQP;saslMechanisms=GSSAPI
   </acceptor>

   앞의 구성은 수락자가 Kerberos 자격 증명을 인증할 때 GSSAPI 메커니즘을 사용한다는 것을 의미합니다.

4. (선택 사항) PLAIN 및 ANONYMOUS SASL 메커니즘도 지원됩니다. 여러 메커니즘을 지정하려면 쉼표로 구분된 목록을 사용합니다. 예를 들면 다음과 같습니다.

   <acceptor name="amqp">
     tcp://0.0.0.0:5672?protocols=AMQP;saslMechanisms=GSSAPI,PLAIN
   </acceptor>

   그 결과 GSSAPI 및 PLAIN SASL 메커니즘을 모두 사용하는 수락자가 있습니다.

5. 브로커를 시작합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis run

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe start

절차

1. 브로커를 중지합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis stop

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe stop

2. < broker_instance_dir> /etc/login.config 구성 파일을 엽니다.

3. amqp-sasl-gssapi 라는 구성 범위를 추가합니다. 다음 예제에서는 Oracle 및 OpenJDK 버전의 JDK에 있는 Krb5LoginModule 의 구성을 보여줍니다.

   amqp-sasl-gssapi {
       com.sun.security.auth.module.Krb5LoginModule required
       isInitiator=false
       storeKey=true
       useKeyTab=true
       principal="amqp/my_broker_host@example.com"
       debug=true;
   };

   amqp-sasl-gssapi

   기본적으로 브로커의 GSSAPI 메커니즘 구현은 amqp-sasl-gssapi 라는 JAAS 구성 범위를 사용하여 Kerberos 수락자 자격 증명을 가져옵니다.

   Krb5LoginModule

   이 버전의 Krb5LoginModule 은 Oracle 및 OpenJDK 버전의 JDK에서 제공합니다. Java 공급 업체의 문서를 참조하여 Krb5LoginModule 의 정규화된 클래스 이름과 사용 가능한 옵션을 확인합니다.

   useKeyTab

   Krb5LoginModule 은 보안 주체를 인증할 때 Kerberos 키탭을 사용하도록 구성되어 있습니다. 키탭은 Kerberos 환경의 툴링을 사용하여 생성됩니다. Kerberos 키탭 생성에 대한 자세한 내용은 공급 업체의 설명서를 참조하십시오.

   보안 주체

   보안 주체는 amqp/my_broker_host@example.com 로 설정됩니다. 이 값은 Kerberos 환경에서 생성된 서비스 주체에 해당해야 합니다. 서비스 주체 생성에 대한 자세한 내용은 공급 업체의 설명서를 참조하십시오.

4. 브로커를 시작합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis run

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe start

절차

1. 브로커를 중지합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis stop

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe stop

2. < broker_instance_dir> /etc/login.config 구성 파일을 엽니다.

3. AMQ Broker Krb5LoginModule 및 LDAPLoginModule 에 대한 구성을 추가합니다. LDAP 공급자의 문서를 참조하여 구성 옵션을 확인합니다.

   예제 구성은 다음과 같습니다.

   org.apache.activemq.artemis.spi.core.security.jaas.Krb5LoginModule required
       ;
   org.apache.activemq.artemis.spi.core.security.jaas.LDAPLoginModule optional
       initialContextFactory=com.sun.jndi.ldap.LdapCtxFactory
       connectionURL="ldap://localhost:1024"
       authentication=GSSAPI
       saslLoginConfigScope=broker-sasl-gssapi
       connectionProtocol=s
       userBase="ou=users,dc=example,dc=com"
       userSearchMatching="(krb5PrincipalName={0})"
       userSearchSubtree=true
       authenticateUser=false
       roleBase="ou=system"
       roleName=cn
       roleSearchMatching="(member={0})"
       roleSearchSubtree=false
       ;

   참고

   위 예에 표시된 Krb5LoginModule 버전은 AMQ Broker와 함께 배포되며, 역할 매핑을 위해 다른 AMQ 모듈에서 사용할 수 있는 브로커 ID로 Kerberos ID를 변환합니다.

4. 브로커를 시작합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis run

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe start

절차

1. < broker_instance_dir> /etc/boostrap.xml 구성 파일을 엽니다.

2. security-manager 요소에서 class-name 속성에 대해 org.apache.activemq.artemis.spi.core.security.security.ActiveMQSecurityManager5 인터페이스에 대한 사용자 정의 구현인 클래스를 지정합니다. 예를 들면 다음과 같습니다.

   <broker xmlns="http://activemq.org/schema">
      ...
      <security-manager class-name="com.foo.MySecurityManager">
         <property key="myKey1" value="myValue1"/>
         <property key="myKey2" value="myValue2"/>
      </security-manager>
      ...
   </broker>

절차

1. 사용자 지정 보안 관리자 예제가 포함된 디렉터리로 이동합니다.

   $ cd <install_dir>/examples/features/standard/security-manager

2. 예제를 실행합니다.

   $ mvn verify

절차

1. 명령 프롬프트에서 mask 유틸리티를 사용하여 암호를 암호화합니다.

   $ <broker_instance_dir>/bin/artemis mask <password>

   result: 3a34fd21b82bf2a822fa49a8d8fa115d

2. 마스크하려는 일반 텍스트 암호가 포함된 < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

   <cluster-password>
     <password>
   </cluster-password>

3. 일반 텍스트 암호를 암호화된 값으로 바꿉니다.

   <cluster-password>
     3a34fd21b82bf2a822fa49a8d8fa115d
   </cluster-password>

4. 암호화된 값을 ENC() 식별자로 래핑합니다.

   <cluster-password>
     ENC(3a34fd21b82bf2a822fa49a8d8fa115d)
   </cluster-password>

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

   기본적으로 브로커는 다음과 같이 저널 기반 지속성을 사용하도록 구성됩니다.

   <configuration>
     <core>
       ...
       <persistence-enabled>true</persistence-enabled>
       <journal-type>ASYNCIO</journal-type>
       <bindings-directory>./data/bindings</bindings-directory>
       <journal-directory>./data/journal</journal-directory>
       <journal-datasync>true</journal-datasync>
       <journal-min-files>2</journal-min-files>
       <journal-pool-files>-1</journal-pool-files>
       <journal-device-block-size>4096</journal-device-block-size>
       <journal-file-size>10M</journal-file-size>
       <journal-buffer-timeout>12000</journal-buffer-timeout>
       <journal-max-io>4096</journal-max-io>
       ...
     </core>
   </configuration>

   persistence-enabled

   이 매개변수의 값이 true 로 설정된 경우 브로커는 메시지 지속성을 위해 파일 기반 저널을 사용합니다.

   journal-type

   사용할 저널 유형입니다. ASYNCIO 로 설정하면 브로커는 먼저 AIO를 사용하려고 합니다. AIO를 찾을 수 없는 경우 브로커는 NIO를 사용합니다.

   bindings-directory

   바인딩 저널의 파일 시스템 위치. 기본값은 < broker_instance_dir> 디렉터리를 기준으로 합니다.

   journal-directory

   메시지 저널의 파일 시스템 위치. 기본값은 < broker_instance_dir> 디렉터리를 기준으로 합니다.

   journal-datasync

   이 매개변수의 값이 true 로 설정된 경우 브로커는 fdatasync 함수를 사용하여 디스크 쓰기를 확인합니다.

   journal-min-files

   브로커가 시작될 때 처음에 생성할 저널 파일 수입니다.

   journal-pool-files

   사용되지 않은 파일을 회수한 후 보관할 파일 수입니다. 기본값 -1 은 정리 중에 파일이 삭제되지 않음을 의미합니다.

   journal-device-block-size

   스토리지 장치의 저널에서 사용하는 데이터 블록의 최대 크기(바이트)입니다. 기본값은 4096바이트입니다.

   journal-file-size

   지정된 저널 디렉터리에 있는 각 저널 파일의 최대 크기(바이트)입니다. 이 제한에 도달하면 브로커가 새 파일을 시작합니다. 이 매개변수는 바이트 표기법(예: K, M, G) 또는 바이너리 동등한 (Ki, Mi, Gi)도 지원합니다. 이 매개변수가 구성에 명시적으로 지정되지 않은 경우 기본값은 10485760바이트(10MiB)입니다.

   journal-buffer-timeout

   브로커가 저널 버퍼를 플러시하는 빈도를 나노초 단위로 지정합니다. AIO는 일반적으로 NIO보다 높은 플러시 속도를 사용하므로 브로커가 NIO 및 AIO 둘 다에 대해 서로 다른 기본값을 유지합니다. 구성에 이 매개변수를 명시적으로 지정하지 않으면 NIO의 기본값은 3333333 나노초(초당 300회)입니다. AIO의 기본값은 50000 나노초(초당 2000번)입니다.

   journal-max-io

   한 번에 IO 대기열에 있을 수 있는 최대 쓰기 요청 수입니다. 큐가 가득 차게 되면 브로커는 공간을 사용할 수 있을 때까지 추가 쓰기를 차단합니다.

   NIO를 사용하는 경우 이 값은 항상 1 이어야 합니다. AIO를 사용하고 있고 이 매개변수가 구성에 명시적으로 지정되지 않은 경우 기본값은 500 입니다.

2. 이전 설명을 기반으로 스토리지 장치에 필요에 따라 지속성 구성을 조정합니다.

절차

1. Linux에서 디스크 쓰기 캐시 설정을 관리하려면 hdparm ( IDE 디스크용) 또는 sdparm 또는 sginfo (Sginfo의 경우)를 사용하십시오.
2. Windows에서 디스크 작성기 캐시 설정을 관리하려면 디스크를 마우스 오른쪽 버튼으로 클릭합니다. 속성 을 선택합니다.

절차

1. 적절한 JDBC 클라이언트 라이브러리를 브로커 런타임에 추가합니다. 이렇게 하려면 관련 .jar 파일을 < broker_instance_dir> /lib 디렉터리에 추가합니다.
2. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

3. core 요소 내에서 database- store 요소를 포함하는 store 요소를 추가합니다.

   <configuration>
     <core>
       <store>
          <database-store>
          </database-store>
       </store>
     </core>
   </configuration>

4. database-store 요소 내에서 JDBC 지속성에 대한 구성 매개 변수를 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   <configuration>
     <core>
       <store>
          <database-store>
             <jdbc-connection-url>jdbc:oracle:data/oracle/database-store;create=true</jdbc-connection-url>
             <jdbc-user>ENC(5493dd76567ee5ec269d11823973462f)</jdbc-user>
             <jdbc-password>ENC(56a0db3b71043054269d11823973462f)</jdbc-password>
             <bindings-table-name>BINDINGS_TABLE</bindings-table-name>
             <message-table-name>MESSAGE_TABLE</message-table-name>
             <large-message-table-name>LARGE_MESSAGES_TABLE</large-message-table-name>
             <page-store-table-name>PAGE_STORE_TABLE</page-store-table-name>
             <node-manager-store-table-name>NODE_MANAGER_TABLE</node-manager-store-table-name>
             <jdbc-driver-class-name>oracle.jdbc.driver.OracleDriver</jdbc-driver-class-name>
             <jdbc-network-timeout>10000</jdbc-network-timeout>
             <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
             <jdbc-lock-expiration>20000</jdbc-lock-expiration>
             <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
          </database-store>
       </store>
     </core>
   </configuration>

   jdbc-connection-url

   데이터베이스 서버의 전체 JDBC 연결 URL입니다. 연결 URL에는 모든 구성 매개 변수와 데이터베이스 이름이 포함되어야 합니다.

   jdbc-user

   데이터베이스 서버의 암호화된 사용자 이름입니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일의 암호 암호화” 을 참조하십시오.

   jdbc-password

   데이터베이스 서버의 암호화된 암호입니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일의 암호 암호화” 을 참조하십시오.

   bindings-table-name

   바인딩 데이터가 저장되는 테이블의 이름입니다. 테이블 이름을 지정하면 간섭 없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   message-table-name

   메시지 데이터가 저장되는 테이블의 이름입니다. 이 테이블 이름을 지정하면 간섭없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   large-message-table-name

   대용량 메시지 및 관련 데이터가 유지되는 테이블의 이름입니다. 또한 클라이언트가 청크로 큰 메시지를 스트리밍하는 경우 청크는 이 테이블에 저장됩니다. 이 테이블 이름을 지정하면 간섭없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   page-store-table-name

   paged store 디렉토리 정보가 저장된 테이블의 이름입니다. 이 테이블 이름을 지정하면 간섭없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   node-manager-store-table-name

   실시간 및 백업 브로커에 대한 공유 저장소 HA(고가용성) 잠금 및 기타 HA 관련 데이터가 브로커 서버에 저장되는 테이블의 이름입니다. 이 테이블 이름을 지정하면 간섭없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다. 공유 저장소 HA를 사용하는 각 라이브 백업 쌍은 동일한 테이블 이름을 사용해야 합니다. 여러 (및 관련이 없는) 실시간 백업 쌍 간에 동일한 테이블을 공유할 수 없습니다.

   jdbc-driver-class-name

   JDBC 데이터베이스 드라이버의 정규화된 클래스 이름입니다. 지원되는 데이터베이스에 대한 자세한 내용은 Red Hat 고객 포털의 Red Hat AMQ 7 지원 구성 을 참조하십시오.

   jdbc-network-timeout

   JDBC 네트워크 연결 시간 초과(밀리초). 기본값은 20000밀리초입니다. 공유 저장소 HA에 JDBC를 사용하는 경우 시간 제한을 jdbc-lock-expiration 보다 작거나 같은 값으로 설정하는 것이 좋습니다.

   jdbc-lock-renew-period

   현재 JDBC 잠금에 대한 갱신 기간의 길이(밀리초)입니다. 이 시간이 지나면 브로커가 잠금을 갱신할 수 있습니다. jdbc-lock-expiration 값보다 여러 번 작은 값을 설정하는 것이 좋습니다. 이를 통해 브로커는 리스를 연장할 수 있는 충분한 시간을 제공하며, 연결 문제 발생 시 브로커가 잠금을 갱신하려고 할 수 있습니다. 기본값은 2000밀리초입니다.

   jdbc-lock-expiration

   J dbc-lock-renew-period의 값이 경과하더라도 현재 JDBC 잠금이 소유하는 것으로 간주되는 시간(즉, 인수, 갱신 또는 갱신)입니다.

   브로커는 정기적으로 jdbc-lock-renew-period 값에 따라 소유한 잠금을 갱신하려고 합니다. 브로커 가 연결 문제로 인한 잠금을 갱신하지 못하면 브로커가 jdbc-lock-expiration 값이 마지막으로 성공적으로 취득되거나 갱신된 이후의 값이 통과될 때까지 브로커가 잠금을 갱신하려고 합니다.

   위에서 설명한 갱신 동작에 대한 예외는 다른 브로커가 잠금을 취득하는 경우입니다. 이는 DBMS(Database Management System)와 브로커 간에 오류가 있거나 가비지 수집의 긴 일시 중단이 있는 경우 발생할 수 있습니다. 이 경우 원래 잠금을 소유한 브로커는 손실 된 잠금을 고려하고 갱신하지 않습니다.

   만료 시간이 경과된 후 JDBC 잠금이 현재 보유 중인 브로커에 의해 갱신되지 않은 경우 다른 브로커는 JDBC 잠금을 설정할 수 있습니다.

   jdbc-lock-expiration 의 기본값은 20000밀리초입니다.

   jdbc-journal-sync-period

   브로커 저널이 JDBC와 동기화하는 기간(밀리초)입니다. 기본값은 5밀리초입니다.

절차

1. < broker-instance-dir> /etc/broker.xml 구성 파일을 엽니다.

2. JDBC 구성을 위해 이전에 추가한 database-store 요소 내에서 jdbc-driver-class-name,jdbc-connection-url,jdbc-user,jdbc-password, 매개변수를 제거합니다. 이 절차의 뒷부분에서 해당 DBCP 구성 매개변수로 바꿉니다.

   참고

   이전 매개변수를 명시적으로 제거하지 않으면 이 절차의 뒷부분에서 추가하는 해당 DBCP 매개변수가 우선합니다.

3. database-store 요소 내에서 data-source-properties 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <store>
       <database-store>
           <data-source-properties>
           </data-source-properties>
           <bindings-table-name>BINDINGS</bindings-table-name>
           <message-table-name>MESSAGES</message-table-name>
           <large-message-table-name>LARGE_MESSAGES</large-message-table-name>
           <page-store-table-name>PAGE_STORE</page-store-table-name>
           <node-manager-store-table-name>NODE_MANAGER_STORE</node-manager-store-table-name>
           <jdbc-network-timeout>10000</jdbc-network-timeout>
           <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
           <jdbc-lock-expiration>20000</jdbc-lock-expiration>
           <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
       </database-store>
   </store>

4. 새 data-source-properties 요소 내에서 연결 풀링을 위한 DBCP 데이터 소스 속성을 추가합니다. 키-값 쌍을 지정합니다. 예를 들면 다음과 같습니다.

   <store>
       <database-store>
           <data-source-properties>
               <data-source-property key="driverClassName" value="com.mysql.jdbc.Driver" />
               <data-source-property key="url" value="jdbc:mysql://localhost:3306/artemis" />
               <data-source-property key="username" value="ENC(5493dd76567ee5ec269d1182397346f)"/>
               <data-source-property key="password" value="ENC(56a0db3b71043054269d1182397346f)"/>
               <data-source-property key="poolPreparedStatements" value="true" />
               <data-source-property key="maxTotal" value="-1" />
           </data-source-properties>
           <bindings-table-name>BINDINGS</bindings-table-name>
           <message-table-name>MESSAGES</message-table-name>
           <large-message-table-name>LARGE_MESSAGES</large-message-table-name>
           <page-store-table-name>PAGE_STORE</page-store-table-name>
           <node-manager-store-table-name>NODE_MANAGER_STORE</node-manager-store-table-name>
           <jdbc-network-timeout>10000</jdbc-network-timeout>
           <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
           <jdbc-lock-expiration>20000</jdbc-lock-expiration>
           <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
       </database-store>
   </store>

   driverClassName

   JDBC 데이터베이스 드라이버의 정규화된 클래스 이름입니다.

   url

   데이터베이스 서버의 전체 JDBC 연결 URL입니다.

   사용자 이름

   데이터베이스 서버의 암호화된 사용자 이름입니다. 이 값을 암호화되지 않은 일반 텍스트로 지정할 수도 있습니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일의 암호 암호화” 을 참조하십시오.

   암호

   데이터베이스 서버의 암호화된 암호입니다. 이 값을 암호화되지 않은 일반 텍스트로 지정할 수도 있습니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일의 암호 암호화” 을 참조하십시오.

   poolPreparedStatements

   이 매개 변수의 값을 true 로 설정하면 풀에 캐시된 준비된 문 수가 무제한으로 있을 수 있습니다. 따라서 초기화 비용이 줄어듭니다.

   maxTotal

   풀의 최대 연결 수입니다. 이 매개 변수의 값을 -1 로 설정하면 제한이 없습니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. core 요소 내에서 paging-directory 요소를 추가합니다. 파일 시스템에서 페이징 디렉터리의 위치를 지정합니다.

   <configuration ...>
     <core ...>
       ...
       <paging-directory>/path/to/paging-directory</paging-directory>
       ...
     </core>
   </configuration>

   이후에 페이징을 위해 구성하는 각 주소에 대해 브로커는 지정한 페이징 디렉터리에 전용 디렉터리를 추가합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 일치하는 주소 또는 주소 집합에 대해 구성한 address-setting 요소의 경우 구성 요소를 추가하여 최대 메모리 사용량을 지정하고 페이징 동작을 정의합니다. 예를 들면 다음과 같습니다.

   <address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-size-bytes>104857600</max-size-bytes>
           <page-size-bytes>10485760</page-size-bytes>
           <address-full-policy>PAGE</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   max-size-bytes

   브로커가 address-full-policy 에 지정된 정책을 실행하기 전에 주소에 허용되는 메모리의 최대 크기(바이트)입니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다. 지정하는 값은 "K", "MB", "GB"와 같은 바이트 표기법도 지원합니다.

   page-size-bytes

   페이징 시스템에서 사용되는 각 페이지 파일의 크기(바이트)입니다. 기본값은 10485760 (즉, 10MiB)입니다. 지정하는 값은 "K", "MB", "GB"와 같은 바이트 표기법도 지원합니다.

   address-full-policy

   주소의 최대 크기에 도달했을 때 브로커가 수행하는 작업입니다. 기본값은 PAGE 입니다. 유효한 값은 다음과 같습니다.

   PAGE

   브로커는 추가 메시지를 디스크에 페이지에 표시합니다.

   DROP

   브로커는 추가 메시지를 자동으로 삭제합니다.

   FAIL

   브로커는 추가 메시지를 삭제하고 클라이언트 메시지 생산자에 대한 예외를 발행합니다.

   BLOCK

   클라이언트 메시지 생산자는 추가 메시지를 전송하려고 할 때 차단됩니다.

   이전 예에 표시되지 않는 추가 페이징 구성 요소는 아래에 설명되어 있습니다.

   page-max-cache-size

   브로커가 페이징 탐색 중에 IO를 최적화하기 위해 메모리에 유지하는 페이지 파일의 수입니다. 기본값은 5 입니다.

   page-sync-timeout

   시간(초)은 주기적 페이지 동기화 간입니다. 비동기 IO 저널(즉, journal-type 이 broker.xml 구성 파일에서 ASYNCIO 로 설정된 경우) 기본값은 3333333 입니다. 표준 Java NIO저널(즉, journal-type )을 사용하는 경우 기본값은 journal-buffer-timeout 매개변수 값으로 구성됩니다.

절차

1. 브로커를 중지합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis stop

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe stop

2. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

3. core 요소 내에서 global-max-size 요소를 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   <configuration>
     <core>
       ...
       <global-max-size>1GB</global-max-size>
       ...
     </core>
   </configuration>

   global-max-size

   브로커가 모든 주소에 사용할 수 있는 총 메모리 양(바이트)입니다. 이 제한에 도달하면 들어오는 메시지와 연결된 주소의 경우 브로커는 address-full-policy 의 값으로 지정된 정책을 실행합니다. global-max-size 의 기본값은 브로커를 호스팅하는 JVM(Java 가상 시스템)에서 사용할 수 있는 최대 메모리의 절반입니다.

   global-max-size 의 값은 바이트 단위입니다. 그러나 바이트 표기법(예: "K", "Mb", "GB")도 지원합니다.

   이전 예에서 브로커는 메시지를 처리할 때 최대 1기가바이트의 사용 가능한 메모리를 사용하도록 구성되어 있습니다.

4. 브로커를 시작합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis run

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe start

절차

1. 브로커를 중지합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis stop

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe stop

2. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

3. core 요소 내에서 max-disk-usage 구성 요소를 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   <configuration>
     <core>
       ...
       <max-disk-usage>50</max-disk-usage>
       ...
     </core>
   </configuration>

   max-disk-usage

   브로커가 메시지를 페이징할 때 사용할 수 있는 디스크 공간의 최대 백분율입니다. 이 제한에 도달하면 브로커는 메시지를 페이징하는 대신 수신되는 메시지를 차단합니다. 기본값은 90 입니다.

   이전 예에서 브로커는 메시지를 페이징할 때 디스크 공간의 50 %를 사용하도록 제한됩니다.

4. 브로커를 시작합니다.

   1. Linux의 경우:

      <broker_instance_dir>/bin/artemis run

   2. Windows에서:

      <broker_instance_dir>\bin\artemis-service.exe start

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 일치하는 주소 또는 주소 집합에 대해 구성한 address-setting 요소의 경우 구성 요소를 추가하여 메시지 차단 동작을 정의합니다. 예를 들면 다음과 같습니다.

   <address-settings>
       <address-setting match="my.blocking.address">
           ...
           <max-size-bytes>300000</max-size-bytes>
           <address-full-policy>BLOCK</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   max-size-bytes

   브로커가 address-full-policy 에 지정된 정책을 실행하기 전에 주소에 허용되는 메모리의 최대 크기(바이트)입니다. 지정하는 값은 "K", "MB", "GB"와 같은 바이트 표기법도 지원합니다.

   참고

   address-setting 요소에서 max-size-bytes 를 지정하는 경우 값은 일치하는 각 주소에 적용됩니다. 이 값을 지정 하면 일치하는 모든 주소의 총 크기가 max-size-bytes 값으로 제한되는 것은 아닙 니다.

   address-full-policy

   주소의 최대 크기에 도달했을 때 브로커가 수행하는 작업입니다.

   이전 예에서 주소 my.blocking.address 로 전송된 메시지가 메모리에서 300000바이트를 초과하면 브로커가 코어 또는 OpenWire 메시지 생산자에서 추가 메시지를 차단하기 시작합니다.

절차

1. < broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 일치하는 주소 또는 주소 집합에 대해 구성한 address-setting 요소의 경우 메모리에 있는 모든 AMQP 메시지의 최대 크기를 지정합니다. 예를 들면 다음과 같습니다.

   <address-settings>
       <address-setting match="my.amqp.blocking.address">
           ...
           <max-size-bytes-reject-threshold>300000</max-size-bytes-reject-threshold>
           ...
       </address-setting>
   </address-settings>

   max-size-bytes-reject-threshold

   브로커가 추가 AMQP 메시지를 차단하기 전에 주소에 허용되는 최대 크기(바이트)입니다. 지정하는 값은 "K", "MB", "GB"와 같은 바이트 표기법도 지원합니다. 기본적으로 max-size-bytes-reject-threshold 는 -1 로 설정됩니다. 즉, 최대 크기가 없음을 의미합니다.

   참고

   address-setting 요소에서 max-size-bytes-reject-threshold 를 지정하는 경우 값은 일치하는 각 주소에 적용됩니다. 이 값을 지정 하면 일치하는 모든 주소의 총 크기가 max-size-bytes-reject-threshold 값으로 제한되는 것은 아닙 니다.