第 7 章 为地址配置最大内存用量

流程

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

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

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

   Copy to Clipboard Toggle word wrap

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

流程

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>
           <page-size-bytes>10485760</page-size-bytes>
           <address-full-policy>PAGE</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   Copy to Clipboard Toggle word wrap

   max-size-bytes

   在代理执行为 address-full-policy 指定的策略前，地址允许的内存的最大大小（以字节为单位）。默认值为 -1，这表示没有限制。您指定的值还支持字节表示法，如"K"、"MB"和"GB"。

   page-size-bytes

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

   address-full-policy

   然后，达到地址的最大大小时代理要执行的操作。默认值为 PAGE。有效值为：

   页面

   代理将任何进一步的信息输出到磁盘。

   DROP

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

   FAIL

   代理会丢弃任何进一步的消息和问题例外，以客户端消息制作者。

   BLOCK

   客户端消息制作者在尝试发送更多消息时会阻断。

   上例中 未显示 的其他分页配置元素如下所述。

   page-max-cache-size

   代理保留在内存中的页面文件数量，以便在分页导航期间优化 IO。默认值为 5。

   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

      Copy to Clipboard Toggle word wrap

   2. 在 Windows 中：

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

      Copy to Clipboard Toggle word wrap
2. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

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

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

   Copy to Clipboard Toggle word wrap

   global-max-size

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

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

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

4. 启动代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard Toggle word wrap

   2. 在 Windows 中：

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

      Copy to Clipboard Toggle word wrap

流程

1. 停止代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard Toggle word wrap

   2. 在 Windows 中：

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

      Copy to Clipboard Toggle word wrap
2. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

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

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

   Copy to Clipboard Toggle word wrap

   max-disk-usage

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

   在上例中，当分页消息时，代理限制为使用 fifty 磁盘空间。

4. 启动代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard Toggle word wrap

   2. 在 Windows 中：

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

      Copy to Clipboard Toggle word wrap