配置 AMQ Broker

流程

1. 打开 & lt;broker_instance_dir>/etc/artemis.profile 文件。

2. 将新参数 -Dartemis.disableXxe 添加到 Java 系统参数的 JAVA_ARGS 列表中。

   -Dartemis.disableXxe=true

3. 保存 artemis.profile 文件。

1. 代理目前不支持虚拟主机，这意味着 CONNECT 帧中的 host 标头被忽略。
2. 消息确认不是事务性。ACK 框架不能是事务的一部分，如果设置了其 事务 标头，则忽略该帧。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。
2. 对于用于 STOMP 连接的 acceptor，将 stompEnableMessageId 参数设置为 true，如下例所示：

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。
2. 将 connectionTTL 参数添加到用于 STOMP 连接的 acceptor 的 URI 中，如下例所示：

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。
2. 添加 connection-ttl-override 属性，并为新默认值提供一个值（毫秒）。它属于 < core&gt; 小节，如下所示。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 在配置字面匹配前，请使用 literal-match-markers 参数来定义限制字面匹配的字符。在以下示例中，括号用于限制字面匹配。

   <core>
      ...
      <literal-match-markers>()</literal-match-markers>
      ...
   </core>

3. 在定义了限制字面匹配的标记后，在 address 设置 match 参数指定匹配项 （包括标记）。以下示例为名为 orders. 的地址配置字面匹配，以启用该特定地址的指标。

   <address-settings>
      <address-setting match="(orders.#)">
         <enable-metrics>true</enable-metrics>
      </address-setting>
   </address-settings>

流程

1. 打开 & lt;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 时，指示代理使用您的自定义设置。

   delimiter

   提供自定义字符作为 分隔符 替代默认字符（.）。

   any-words

   作为 any-words 的值提供的字符代表“匹配 0 个或更多个序列”，并将替换默认的 #。在表达式的末尾使用此字符。

   single-word

   作为 single-word 的值提供的字符代表“匹配一个词”，并将替换默认的 *。在您的表达式内使用此字符。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 使用一个 address 所选的 queue 项环绕一个 anycast 配置项。确保 address 和 queue 元素的 name 属性的值都相同。例如：

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

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 使用在 address 项中的 queue 项环绕一个 anycast 配置项。例如：

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

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 将 durable 配置元素添加到所选队列中。将值设为 true。

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

   注意

   因为队列默认是持久的，包括 durable 元素，并将值设为 true 并不严格需要创建持久队列。但是，明确包含该元素可让您稍后将队列的行为更改为非持久（如果需要）。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 将 durable configuration 元素添加到每个所选队列。将值设为 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>

   注意

   因为队列默认是持久的，包括 durable 元素，并将值设为 true 并不严格需要创建持久队列。但是，明确包含该元素可让您稍后将队列的行为更改为非持久（如果需要）。

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. 打开 & lt;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. 打开 & lt;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 元素的配置应用于与通配符地址 activemq. 4.1 匹配的任何地址或队列。

   auto-create-addresses

   当客户端请求连接到尚不存在的地址时，代理会创建地址。

   auto-delete-addresses

   当自动创建的地址不再关联任何队列时，会删除自动创建的地址。

   auto-create-queues

   当客户端请求连接到尚未存在的队列时，代理会创建队列。

   auto-delete-queues

   当自动创建的队列不再有任何消费者或消息时，将删除自动创建的队列。

   default-address-routing-type

   如果客户端在连接时没有指定路由类型，代理会在向地址传递消息时使用 ANYCAST。默认值为 MULTICAST。

1. 打开 & lt;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. 打开 & lt;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-queue 而不是 default-last-value-key。将值设为 true。例如：

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

流程

1. 打开 & lt;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. 打开 & lt;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， 这意味着它们不会过期。对于过期时间大于默认值的消息，expiry-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 （即 disabled）。

5. 在配置文件的 addresses 元素中，配置之前为 expiry-address 指定的地址。在此地址上定义队列。例如：

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

   前面的示例配置将到期队列 ExpiryQueue 与到期地址 ExpiryAddress 相关联。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 找到您之前添加到配置文件的 & lt;address-setting > 元素，以定义匹配地址 或一组 地址的到期地址。例如：

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

3. 在 & lt;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 &gt; 元素，用于定义到期地址和相关到期队列。自动创建的 <address& gt; 元素的 name 值与为 指定的值匹配 <expiry-address>。

   自动创建的过期队列有 multicast 路由类型。默认情况下，代理将到期队列命名为 expiry 队列，以匹配最初发送过期消息的地址，如 库存。

   代理还为使用 _AMQ_ORIG_ADDRESS 属性的到期队列定义过滤器。此过滤器可确保到期队列仅接收发送到对应原始地址的消息。

   expiry-queue-prefix

   代理应用到自动创建过期队列的名称的前缀。默认值为 EXP。

   当您定义前缀值或保留默认值时，到期队列的名称是前缀和原始地址的串联，如 EXP.stocks。

   expiry-queue-suffix

   代理应用到自动创建的过期队列的后缀。默认值没有被定义（即，代理不会应用后缀）。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 在与您的队列名匹配的 < 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 ...>

   match

   代理在此 address-setting 部分中应用配置的地址。您可以为 < address-setting> 元素的 match 属性指定一个通配符表达式。如果您希望将 <address-setting> 项中配置的死信设置与一组地址相匹配，可以使用通配符表达式。

   dead-letter-address

   死信地址的名称。在本例中，代理将未发送的消息从队列 exampleQueue 移到死信地址 DLA。

   max-delivery-attempts

   在将未发送的消息移到配置的死信地址前，代理发出的最大发送尝试次数。在本例中，代理会在 3 次失败发送尝试后将未发送的消息移到死信地址。默认值为 10。如果您希望代理进行无限的重新发送尝试数，请指定 -1 的值。

3. 在 addresses 部分中，为死信地址 DLA 添加一个 address 元素。要将死信队列与死信地址关联，请为 队列 指定 name 值。例如：

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

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 找到您之前添加的 &lt ;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，代理会自动创建定义死信 地址和 关联的死信队列的 <address> 元素。自动创建的 < address> 元素的名称与 您为 < dead-letter-address> 指定的 name 值匹配。

   代理在自动创建的 <address> 元素 中定义的 死信队列具有 multicast 路由类型。默认情况下，代理将死信队列命名为死信队列，以匹配未 传输消息的原始地址，如库存。

   代理还定义了使用 _AMQ_ORIG_ADDRESS 属性的死信队列的过滤器。此过滤器可确保死信队列仅接收发送到对应原始地址的消息。

   dead-letter-queue-prefix

   代理应用到自动创建的死信队列的名称的前缀。默认值为 DLQ。

   当您定义前缀值或保留默认值时，死信队列的名称是前缀和原始地址的串联，如 DLQ.stocks。

   dead-letter-queue-suffix

   代理应用于自动创建的死信队列的后缀。默认值没有被定义（即，代理不会应用后缀）。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 对于给定队列，添加 exclusive 密钥。将值设为 true。

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

1. 打开 & lt;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. 打开 & lt;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 和 deliver Count= 3。

3. 生产者向队列发送另一个消息。然后，消息被分配给消费者。

   现在，messageCount = 4 和 deliverCount = 4。消息计数 4 大于配置的环大小 3。但是，代理需要允许这种情况，因为它无法从队列中删除发送的消息。

4. 现在，假设消费者已关闭，而不会确认任何消息。

   在这种情况下，四个 in-delivery，未确认的消息会取消到代理，并以相反的顺序添加到队列的头。此操作将队列置于其配置的环大小上。由于环队列更喜欢在头上队列尾部的消息，因此队列丢弃了生产者发送的第一个消息，因为这是最后一个消息添加到队列的头头。事务或核心会话回滚的方式相同。

1. 在 12:00 时，生成者发送消息 A 给使用 ring-size="3" 配置的环队列。该消息被调度为 12:05。

   此时，messageCount= 1 和 scheduledCount= 1。

2. at 12:01，生成者将消息 B 发送到同一环队列。

   现在，messageCount= 2 和 scheduledCount= 1。

3. at 12:02，生成者将消息 C 发送到同一环队列。

   现在，messageCount= 3 和 scheduledCount= 1。

4. at 12:03，生成者将消息 D 发送到同一环队列。

   现在，messageCount= 4 和 scheduledCount= 1。

   队列的消息数现在是 4，大于 配置的环大小为 3。但是，调度的消息还没有在队列中（即，它位于代理上，并被调度到队列中）。在计划的 12:05 交付时，代理会将消息放在队列的头头上。但是，由于环队列已达到其配置的大小，因此调度的消息 A 会立即被删除。

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 对于给定的 acceptor，添加 sslEnabled 键并将值设为 true。另外，添加 keyStorePath 和 keyStorePassword 密钥。设置与代理密钥存储对应的值。例如：

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

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 对于您之前为单向 TLS 配置的 acceptor，请添加 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. 打开 & lt;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. 打开 & lt;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），那么您必须将该值放在一对双引号("")中，并使用反斜杠(\)来转义对中的每个双引号。例如, 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)或关闭(假)。默认值为 false。

      initialContextFactory

      必须始终设置为 com.sun.jndi.ldap.LdapCtxFactory

      connectionURL

      使用 LDAP URL 的目录服务器的位置__<ldap://Host:Port>。通过添加正斜杠 / 以及目录树中特定节点的 DN，可以选择性地验证此 URL。对于 Microsoft AD，Apache DS 的默认端口为 10389，默认为 389。

      connectionUsername

      打开与目录服务器的连接的用户的区分名称(DN)。例如： uid=admin,ou=system。目录服务器通常需要客户端提供用户名/密码凭证才能打开连接。

      connectionPassword

      与来自 connectionUsername 的 DN 匹配的密码。在目录服务器中，在 Directory Information Tree (DIT)中，密码通常作为 userPassword 属性存储在对应的目录条目中。

      connectionProtocol

      支持任何值，但实际上没有使用。必须明确设置这个选项，因为它没有默认值。

      connectionTimeout

      指定代理连接到目录服务器所需的最长时间（以毫秒为单位）。如果代理无法在此时间内连接到目录 sever，它会中止连接尝试。如果为此属性指定 0 或更小的值，则会使用底层 TCP 协议的超时值。如果没有指定值，代理会无限期等待建立连接，或者底层网络超时。

      当为连接请求连接池时，此属性指定在达到最大池大小并且使用池中所有连接时代理等待连接的最长时间。如果您指定了零或更少的值，代理会无限期等待连接可用。否则，代理会在达到最大等待时间时中止连接尝试。

      身份验证

      指定绑定到 LDAP 服务器时使用的身份验证方法。这个参数可以设置为 simple （需要用户名和密码）或 none （允许匿名访问）。

      userBase

      选择 DIT 的特定子树来搜索用户条目。子树由 DN 指定，用于指定子树的基本节点。例如，通过将此选项设置为 ou=User,ou=ActiveMQ,ou=system，搜索用户条目仅限于 ou=User,ou=ActiveMQ,ou=system 节点下的子树。

      userSearchMatching

      指定一个 LDAP 搜索过滤器，它应用到 userBase 所选的子树。详情请查看 第 5.4.1.1 节 “搜索匹配参数” 部分。

      userSearchSubtree

      相对于 userBase 指定的节点，指定用户条目的搜索深度。此选项是一个布尔值。指定 false 值表示搜索会尝试匹配 userBase 节点的一个子条目（映射到 javax.naming.directory.SearchControls.ONELEVEL_SCOPE）。值为 true 表示搜索会尝试与属于 userBase 节点 的子树 的任何条目匹配（映射到 javax.naming.directory.SearchControls.SUBTREE_SCOPE）。

      userRoleName

      用户条目的名称，其中包含用户的角色名称列表。角色名称由代理的授权插件解释为组名称。如果省略这个选项，则不会从用户条目中提取角色名称。

      readTimeout

      指定代理可以等待从目录服务器接收响应到 LDAP 请求的最长时间（以毫秒为单位）。如果代理目前没有收到来自目录服务器的响应，代理会中止请求。如果您指定了零或更少的值，或者没有指定值，代理会无限期等待目录服务器的响应到 LDAP 请求。

      roleBase

      如果角色数据直接存储在目录服务器中，可以使用角色选项(roleBase,roleSearchMatching,roleSearchSubtree, 和 roleName)作为指定 userRoleName 选项的替代方案。这个选项选择 DIT 的特定子树来搜索角色/组条目。子树由 DN 指定，用于指定子树的基本节点。例如，通过将此选项设置为 ou=Group,ou=ActiveMQ,ou=system，搜索 role/group 条目仅限于 ou=Group,ou=ActiveMQ,ou=system 节点下的子树。

      roleName

      包含角色/组名称（如 C、O、OU 等）的角色条目的属性类型。如果省略这个选项，则角色搜索功能会有效地禁用。

      roleSearchMatching

      指定一个 LDAP 搜索过滤器，它应用到 roleBase 所选的子树。详情请查看 第 5.4.1.1 节 “搜索匹配参数” 部分。

      roleSearchSubtree

      指定与 roleBase 指定的节点相关的角色条目的搜索深度。如果设置为 false （默认值）搜索会尝试匹配 roleBase 节点的一个子条目（映射到 javax.naming.directory.SearchControls.ONELEVEL_SCOPE）。如果为 true，它会尝试匹配属于 roleBase 节点子树的任何条目（映射到 javax.naming.directory.SearchControls.SUBTREE_SCOPE）。

      注意

      Apache DS 使用 DN 路径的 OID 部分。Microsoft Active Directory 使用 CN 部分。例如，您可以在 Apache DS 中使用 DN 路径，如 oid=testuser,dc=example,dc=com，而您可能在 Microsoft Active Directory 中使用一个 DN 路径，如 cn=testuser,dc=example,dc=com。

5. 启动或重启代理（服务或进程）。

流程

1. 打开 & lt;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> 指定 目录服务器 的位置。您可选择通过在目录树中添加特定节点的正斜杠 /，后跟特定节点的可分辨名称(DN)来确定此 URL。例如： ldap://ldapserver:10389/ou=system。默认值为 ldap://localhost:1024。

   connectionUsername

   打开与目录服务器连接的用户的 DN。例如： uid=admin,ou=system。目录服务器通常需要客户端提供用户名/密码凭证才能打开连接。

   connectionPassword

   与来自 connectionUsername 的 DN 匹配的密码。在目录服务器中，在 Directory Information Tree (DIT)中，密码通常作为 userPassword 属性存储在对应的目录条目中。

   connectionProtocol

   当前未使用。未来，这个选项可能允许您为与目录服务器的连接选择安全套接字层(SSL)。必须明确设置这个选项，因为它没有默认值。

   身份验证

   指定绑定到 LDAP 服务器时使用的身份验证方法。此参数的有效值为 simple （用户名和密码）或 none （匿名）。默认值为 simple。

   注意

   不支持 简单身份验证和安全层(SASL)身份验证。

1. 在命令提示符下，使用 mask 工具加密密码：

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

   result: 3a34fd21b82bf2a822fa49a8d8fa115d

2. 打开 & lt;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. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

3. 将 name-value 对 saslMechanisms=GSSAPI 添加到 acceptor 的 URL 的查询字符串中。

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

   前面的配置意味着 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. 打开 & lt;broker_instance_dir> /etc/login.config 配置文件。

3. 添加名为 amqp-sasl-gssapi 的配置范围。以下示例显示了在 JDK 的 Oracle 和 OpenJDK 版本中找到的 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 acceptor 凭证。

   Krb5LoginModule

   此版本的 Krb5LoginModule 由 JDK 的 Oracle 和 OpenJDK 版本提供。通过引用 Java 厂商的文档，验证 Krb5LoginModule 及其可用选项的完全限定类名称。

   useKeyTab

   Krb5LoginModule 配置为在验证主体时使用 Kerberos keytab。keytabs 使用 Kerberos 环境中的工具生成。有关生成 Kerberos keytab 的详情，请查看厂商中的文档。

   主体

   Principal 设置为 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. 打开 & lt;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 一起分发，并将 Kerberos 身份转换为可供其他 AMQ 模块用于角色映射的代理身份。

4. 启动代理。

   1. 对于 Linux：

      <broker_instance_dir>/bin/artemis run

   2. 在 Windows 上：

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

流程

1. 打开 & lt;broker_instance_dir> /etc/boostrap.xml 配置文件。

2. 在 security-manager 元素中，对于 class-name 属性，请指定作为 org.apache.activemq.artemis.spi.core.security.ActiveMQSecurityManager5 接口的用户定义的实施的类。例如：

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

流程

1. 导航到包含自定义安全管理器示例的目录。以下示例假设您将示例下载到名为 amq-broker-examples 的目录。

   $ cd amq-broker-examples/examples/features/standard/security-manager

2. 运行示例。

   $ mvn verify

流程

1. 在命令提示符下，使用 mask 工具加密密码：

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

   result: 3a34fd21b82bf2a822fa49a8d8fa115d

2. 打开 & lt;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. 使用 mask 实用程序加密配置文件中的每个密码。对于 key 参数，指定用于加密密码的字符串。使用相同的密钥字符串加密每个密码。

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

   警告

   确保保留了您在运行 mask 工具以加密密码时指定的密钥字符串记录。您必须在环境变量中配置相同的键值，以允许代理解密密码。

   有关在配置文件中加密密码的详情请参考 第 5.9.2 节 “在配置文件中加密密码”。

2. 从命令提示符，将 ARTEMIS_DEFAULT_SENSITIVE_STRING_CODEC_KEY 环境变量设置为您在加密每个密码时指定的密钥字符串。

   $ export ARTEMIS_DEFAULT_SENSITIVE_STRING_CODEC_KEY= <key>

3. 启动代理。

   $ ./artemis run

4. 取消设置 ARTEMIS_DEFAULT_SENSITIVE_STRING_CODEC_KEY 环境变量。

   $ unset ARTEMIS_DEFAULT_SENSITIVE_STRING_CODEC_KEY

   注意

   如果在启动代理后取消设置 ARTEMIS_DEFAULT_SENSITIVE_STRING_CODEC_KEY 环境变量，则必须在每次启动代理前将其再次设置为相同的密钥字符串。

1. 打开 & lt;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 的 flush 率，因此代理为 NIO 和 AIO 维护不同的值。如果未在配置中明确指定此参数，则 NIO 的默认值是 3333333 纳秒（每秒 300 次）。AIO 的默认值为 50000 纳秒（即每秒 2000 次）。

   journal-max-io

   任意一个时间可在 IO 队列中的最大写入请求数。如果队列已满，代理会阻止进一步写入，直到空间可用为止。

   如果您使用 NIO，则该值应始终为 1。如果您使用 AIO 和此参数没有在配置中明确指定，则默认值为 500。

2. 根据前面的描述，根据您的存储设备需要调整持久性配置。

流程

1. 在 Linux 上，要管理磁盘写入缓存设置，请使用工具 hdparm （用于 IDE 磁盘）或 sdparm 或 sginfo （用于 SDSI/SATA 磁盘）。
2. 在 Windows 上，要管理磁盘写器缓存设置，请右键单击磁盘。选择 属性。

流程

1. 将适当的 JDBC 客户端库添加到代理运行时。要做到这一点，将相关的 .JAR 文件添加到 < broker_instance_dir>/lib 目录中。

   如果要将 .JAR 文件添加到不同的目录中，您必须将该目录添加到 Java 类路径中。如需更多信息，请参阅 第 1.5 节 “扩展 JAVA 类路径”

2. 打开 & lt;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>BIND_TABLE</bindings-table-name>
             <message-table-name>MSG_TABLE</message-table-name>
             <large-message-table-name>LGE_TABLE</large-message-table-name>
             <page-store-table-name>PAGE_TABLE</page-store-table-name>
             <node-manager-store-table-name>NODE_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>
             <jdbc-max-page-size-bytes>100K</jdbc-max-page-size-bytes>
          </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

   保存用于存储目录信息的表名称。指定此表名称可让您在多个服务器间共享单个数据库，而无需干扰。

   node-manager-store-table-name

   共享存储高可用性(HA)为实时和备份代理锁定的表名称，其他与 HA 相关的数据存储在代理服务器上。指定此表名称可让您在多个服务器间共享单个数据库，而无需干扰。使用共享存储 HA 的每个实时备份对都必须使用相同的表名称。您不能在多个（和不相关的）实时备份对间共享相同的表。

   jdbc-driver-class-name

   JDBC 数据库驱动程序的完全限定类名称。有关支持的数据库的详情，请参考红帽客户门户网站中的 Red Hat AMQ 7 支持的配置。

   jdbc-network-timeout

   JDBC 网络连接超时，以毫秒为单位。默认值为 20000 毫秒。将 JDBC 用于共享存储 HA 时，建议将超时设置为小于或等于 jdbc-lock-expiration 的值。

   jdbc-lock-renew-period

   当前 JDBC 锁的续订周期的长度，以毫秒为单位。当这个时间过后，代理可以续订锁定。建议设置一个值，它比 jdbc-lock-expiration 的值小几次。这为代理有足够的时间来扩展租期，并提供了代理时间在连接问题时尝试续订锁定。默认值为 2000 毫秒。

   jdbc-lock-expiration

   以毫秒为单位，当前 JDBC 锁定被视为拥有的时间（即获取或续订），即使 jdbc-lock-renew-period 的值已过。

   代理定期尝试根据 jdbc-lock-renew-period 的值续订其拥有的锁定。如果代理 无法 续订锁定（例如，因为连接问题），代理会不断尝试续订锁定，直到 jdbc-lock-expiration 的值因为锁定上次成功获取或续订。

   上述续订行为的例外是另一个代理获取锁定时。如果数据库管理系统(DBMS)和代理之间有时间不对齐，或者对于垃圾回收有长时间暂停，则会出现这种情况。在这种情况下，最初拥有的锁定的代理会考虑丢失锁定，且不会尝试续订它。

   过期时间后，如果当前拥有的代理没有续订 JDBC 锁定，则另一个代理可以建立 JDBC 锁定。

   jdbc-lock-expiration 的默认值为 20000 毫秒。

   jdbc-journal-sync-period

   持续时间，以毫秒为单位，代理日志与 JDBC 同步。默认值为 5 毫秒。

   jdbc-max-page-size-bytes

   当 AMQ Broker 将消息保留到 JDBC 数据库时，每个页文件的最大大小（以字节为单位）。默认值为 102400，其值为 100KB。您指定的值也支持字节表示法，如 "K" "MB" 和 "GB"。

流程

1. 打开 & lt;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。

   username

   您的数据库服务器的加密用户名。您还可以将这个值指定为 unencrypted, plain text。有关加密在配置文件中使用的用户名和密码的详情请参考 第 5.9 节 “在配置文件中加密密码”。

   password

   您的数据库服务器的加密密码。您还可以将这个值指定为 unencrypted, plain text。有关加密在配置文件中使用的用户名和密码的详情请参考 第 5.9 节 “在配置文件中加密密码”。

   poolPreparedStatements

   当此参数的值设为 true 时，池可以有无限数量的缓存准备语句。这降低了初始化成本。

   maxTotal

   池中连接的最大数量。当此参数的值设为 -1 时，没有限制。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 在 core 元素中，添加 pages -directory 元素。指定文件系统中分页目录的位置。

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

   对于您随后为分页配置的每个地址，代理会在您指定的分页目录中添加一个专用目录。

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 对于您为匹配地址 或一组 地址配置的 address-setting 元素，请添加配置元素来指定最大内存用量并定义分页行为。例如：

   <address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-size-bytes>104857600</max-size-bytes>
           <max-size-messages>20000</max-size-messages>
           <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"。

   max-size-messages

   代理执行为 address-full-policy 属性指定的操作前允许地址的最大消息数。默认值为 -1，这意味着没有消息限制。

   page-size-bytes

   分页系统上使用的每个页面文件的大小（以字节为单位）。默认值为 10485760 （即 10 MiB）。您指定的值也支持字节表示法，如 "K"、"MB" 和 "GB"。

   address-full-policy

   当达到地址的最大大小时，代理所采取的操作。默认值为 PAGE。有效值为：

   页面

   代理将任何进一步的信息页面到磁盘。

   DROP

   代理静默丢弃任何进一步的消息。

   FAIL

   代理将任何进一步的消息和异常丢弃给客户端消息制作者。

   BLOCK

   客户端消息制作者块尝试发送进一步消息。

   如果您为 max-size-bytes 和 max-size-message 属性设置了限制，代理会在达到任何限制时执行为 address-full-policy 属性指定的操作。在上例中，当内存中的地址总消息超过 20,000 或使用 104857600 字节可用内存时，代理会启动对 my.paged.address 地址的分页消息。

   上例中 没有显示 的额外分页配置元素如下所述。

   page-sync-timeout

   定期页面同步之间的时间（以纳秒为单位）。如果您使用异步 IO 日志（即，在 broker.xml 配置文件中将 journal-type 设置为 ASYNCIO ），则默认值为 3333333。如果您使用标准 Java NIO 日志（即 journal-type 设置为 NIO），则默认值为 journal-buffer-timeout 参数的配置值。

流程

1. 停止代理。

   1. 对于 Linux：

      <broker_instance_dir>/bin/artemis stop

   2. 在 Windows 上：

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

2. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

3. 在 core 元素中，添加 global-max-size 元素并指定一个值。例如：

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

   global-max-size

   代理可用于所有地址的内存总量，以字节为单位。当达到这个限制时，代理会为与每个传入消息关联的地址执行为 address-full-policy 属性指定的操作。global-max-size 的默认值为托管代理的 Java 虚拟机(JVM)的最大内存的一半。

   global-max-size 的值以字节为单位，但也支持字节表示法（例如："K"、"Mb"、"GB"）

   在前面的示例中，代理配置为在处理消息时使用最多 1GB 可用内存。

   global-max-messages

   允许所有地址的消息总数。当达到这个限制时，代理会为与每个传入消息关联的地址执行为 address-full-policy 属性指定的操作。默认值为 -1，这意味着没有消息限制。

   如果您为 global-max-size 和 global-max-messages 属性设置了限制，代理会在达到任何限制时执行为 address-full-policy 属性指定的操作。使用上例中的配置时，当内存中的消息数量超过 900,000 或使用 1 GB 可用内存时，代理会启动所有地址的分页消息。

   注意

   如果为单个地址设置的限制，通过使用 max-size-bytes 或 max-size-message 属性在为 global-max- size 或 global-max -messages 属性设置的限值之前访问，代理会执行为该地址的 address-full-policy 属性指定的操作。

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. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

3. 在 core 元素中，添加属性，以根据磁盘使用情况或消息数或消息数指定分页限制，并指定在达到任一限制时要采取的操作。例如：

   <address-settings>
      <address-setting match="match="my.paged.address"">
       ...
       <page-limit-bytes>10G</page-limit-bytes>
       <page-limit-messages>1000000</page-limit-messages>
       <page-full-policy>FAIL</page-full-policy>
       ...
      </address-setting>
   </address-settings>

   page-limit-bytes

   在代理执行为 page-full-policy 属性指定的操作前，允许进入地址的最大磁盘空间大小（以字节为单位）。您指定的值支持字节表示法，如 "K"、"MB" 和 "GB"。默认值为 -1，这意味着没有限制。

   page-limit-messages

   在代理执行为 page-full-policy 属性指定的操作前，可以为地址分页的最大传入消息数。默认值为 -1，这意味着没有消息限制。

   page-full-policy

   当达到了地址的 page-limit- bytes 或 page-limit -messages 属性中设置的限制时，代理需要执行的操作。有效值为：

   DROP 代理静默丢弃任何进一步的消息。

   FAIL。代理丢弃任何进一步的消息，并通知发送客户端

   在上例中，代理页面会为 my.paged.address 地址分页信息，直到使用了 10 GB 的磁盘空间或直到所有 100万条消息都被被分页为止。

4. 启动代理。

   1. 对于 Linux：

      <broker_instance_dir>/bin/artemis run

   2. 在 Windows 上：

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

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 对于您为匹配地址或一组地址配置的 address-settings 元素，请指定 paged 消息传输为内存中的限制。例如：

   address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-read-page-messages>104857600</max-read-page-messages>
           <max-read-page-bytes>20MB</max-read-page-bytes>
           ...
       </address-setting>
   </address-settings>

   max-read- page-messages 代理每个地址可以从磁盘读取的最大页面消息数。默认值为 -1，这意味着没有应用任何限制。

   max-read-page-bytes 最大大小（以字节为单位），代理可以从磁盘读取到每个地址的内存。默认值为 20 MB。

   当应用这些限制时，代理会计算内存中的消息，这些消息已准备好发送到当前提供的消费者和消息。如果消费者确认消息缓慢，发送消息可能会导致达到内存或消息限制，并阻止代理将新消息读取到内存中。因此，代理可能会耗尽消息。

3. 如果消费者使用较慢来确认消息，并且当前提供的消息可以访问配置的 max-read-page-messages 或 max-read-page-bytes 限制，请为当前提供的消息指定单独的限制。例如：

   address-settings>
       <address-setting match="my.paged.address">
           ...
           <prefetch-page-bytes>20MB</prefetch-page-bytes>
           <prefetch-page-messages>104857600</prefetch-page-messages>
           ...
       </address-setting>
   </address-settings>

   预抓取页字节 内存（以字节为单位），可用于将页面消息读取到每个队列的内存。默认值为 20 MB。

   Prefetch-page-messages Number of paged 消息，代理可以从磁盘读取到每个队列的内存。默认值为 -1，这意味着没有应用任何限制。

   如果您为 prefetch-page-bytes 或 prefetch-page-messages 参数指定限制当前交付的消息数量，请为 max-read-page- bytes 或 max-read-page -message 参数设置更高限制，以提供向内存中读取新消息的容量。

   注意

   如果在 prefetch-page-bytes 参数的值前达到 max-read-page-bytes 参数的值，代理将停止将进一步页面的消息读入内存中。

流程

1. 停止代理。

   1. 对于 Linux：

      <broker_instance_dir>/bin/artemis stop

   2. 在 Windows 上：

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

2. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

3. 在 core 元素中，添加 max-disk-usage 配置元素并指定一个值。例如：

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

   max-disk-usage

   代理可以使用的最大可用磁盘空间百分比。当达到这个限制时，代理会阻断传入的信息。默认值为 90。

   在上例中，代理限制为使用百分之八十的可用磁盘空间。

4. 启动代理。

   1. 对于 Linux：

      <broker_instance_dir>/bin/artemis run

   2. 在 Windows 上：

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

流程

1. 打开 & lt;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 字节的消息时，代理开始阻止来自 Core 或 OpenWire 消息制作者的进一步消息。

流程

1. 打开 & lt;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 的值。