版本消息队列

本章节为每个版本提供以下信息

指向完整发行说明的链接，其中包含版本中解决的所有问题。
简要的“亮点”列表（如果适用）。
如果需要，从先前版本升级时所需的特定步骤。

如果升级跨越多个版本，则需要按顺序遵循每个版本的步骤。

除了此处概述的任何特定版本升级说明外，请遵循升级代理章节中概述的一般升级程序。

1. 2.38.0

完整发行说明

1.1. 亮点

现在支持 WebSocket 压缩。当通过 WebSockets 进行通信时，此压缩可用于 AMQP、STOMP 或 MQTT 透明地使用。
ActiveMQServerMessagePlugin现在具有messageMoved()回调。
核心桥接配置现在支持client-id，这将使识别远程代理上的桥接连接变得更加容易。
consumer CLI 命令现在支持通过为--receive-timeout指定-1来“永久”使用消息。
身份验证和授权缓存现在具有详细的调试日志记录。
代理管理已进行了一些更新
- 文档已改进，其中包含更多有关 Jolokia 的示例，以及有关管理方法选项语法的新子部分。
- 现在可以将空“选项”传递给接受它们的管理方法。
- 返回分页结果的管理方法现在可以通过为页或 pageSize 指定-1来一起返回所有结果。
- 管理方法选项语法现在支持NOT_EQUALS运算符，以增强管理操作结果的过滤功能。
- 通过管理创建的转向的配置现在可以通过 JSON 完成。
TextFileCertificateLoginModule现在支持 DN 属性值的规范化。有关更多详细信息，请参见ARTEMIS-5102

1.2. 从 2.37.0 升级

由于 ARTEMIS-5096，Web 控制台的归档文件（即console.war）现在将被解压缩。此更改是必要的，以便从归档文件中删除某些 jar 文件，这些文件已经分发在代理的主要lib目录中。消除这些重复的 jar 文件将减少代理分发的尺寸，并且这也意味着控制台在某些情况下将使用更新的依赖项，并防止安全工具标记旧的 jar 文件。
由于 ARTEMIS-5101，用于对称密码屏蔽的默认敏感字符串编解码器中使用的two-way算法现在已弃用。它将继续工作，但它将在日志中打印警告。这是消除密码存储在配置文件中的过程中的一步，除了那些由强单向哈希算法编码的密码。其他用例将被推向基于证书的安全（例如，双向 TLS）或不需要密码的等效内容。
由于 ARTEMIS-5085，参数retryIntervalMultiplier和maxRetryInterval现在将应用于“初始”连接尝试（即通过initialConnectAttempts控制）。这是为了修复一个错误，即这些参数被错误地忽略了。

2. 2.37.0

完整发行说明

2.1. 亮点

除了运行之外，CLI 命令的环境变量可以通过artemis-utility.profile文件配置。
除了运行之外，CLI 命令的日志记录配置可以通过log4j2-utility.properties文件配置。
运行命令已从 artemis shell 中删除，请使用artemis脚本（Windows 上为artemis.cmd）执行它。
作为 ARTEMIS-4986的一部分，修复了投票（无共享复制仲裁协议）的版本兼容性

2.2. 从 2.36.0 升级

除了运行之外，CLI 命令现在需要通过artemis-utility.profile文件定义环境变量，并通过log4j2-utility.properties文件定义日志记录配置。有关更多信息，请参见日志记录。

3. 2.36.0

完整发行说明

3.1. 亮点

与 GitHub 的 Dependabot 集成引发的许多依赖项升级。
通过 ARTEMIS-4949 针对涉及较慢 IO 设备（例如 NFS）和 NIO 日志的用例的稳定性改进。
地址管理器中的代码优化，以降低 CPU 利用率并提高涉及大量地址和队列的用例的代理可扩展性，这得益于 ARTEMIS-4814。
通过 ARTEMIS-3509 针对涉及通过 WebSockets 连接的 STOMP 客户端的用例的稳定性改进。
针对开发人员的许多内部“代码整理”改进，使代码库更简单、更一致。

5. 2.34.0

完整发行说明

5.2. 从 2.33.0 升级

由于 ARTEMIS-4712，LDAPLoginModule中不再支持通过login.config中的connectionPool属性配置的连接池功能。login.config仍然可以使用connectionPool属性。不会抛出错误。但是，无论配置如何，连接将不再池化。
由于 ARTEMIS-4498，Web 控制台现在将报告所有内部对象。
- 这样做是为了允许管理员在事情无法按预期工作时采取行动，以获取这些对象的指标，并为代理提供更大的透明度。
- 这包括所有 Openwire Advisor 队列和地址、MQTT 内部对象、集群存储和转发 (SNF) 队列、镜像 SNF。
- 如果您打算控制 Web 控制台上某些用户的访问权限，则可能需要重新审视授权。
CLI 操作./artemis queue stat的输出已改进和更新。如果您在脚本中解析了以前的输出，您将看到输出中的差异。
- 不建议解析 CLI 操作的输出。您可以改为使用具有适当 JSON 输出的管理上的 jolokia 调用。

6. 2.33.0

完整发行说明

6.1. 亮点

支持 CLIproducer命令上的 JSON 格式的类型化属性
新的 CLI 命令pwd，用于显示与当前实例相关的目录
Maven 物料清单 (BOM) artemis-bom，用于简化集成
计划消息的“FirstMessage”API
新的 “查看”和“编辑” 权限，用于通过broker.xml中的security-settings配置的管理操作
在bootstrap.xml中配置的嵌入式 Web 服务器的新sslAutoReload参数，用于检测 SSL 存储在磁盘上的更改并自动重新加载
镜像和分页的性能改进
日志记录指标，以降低错过日志中WARN或ERROR消息的风险。
对网络隔离（又名脑裂）的文档大幅改进
可插拔锁管理器（又名可插拔仲裁投票）已从“实验性”状态中移出，并已准备好投入通用使用

6.2. 从 2.32.0 升级

由于 ARTEMIS-4532，与 MQTT 主题和订阅相关的地址和队列的名称可能会更改。如果同时满足以下两个条件，这将影响 MQTT 用例
1. 代理配置为使用通配符语法，该语法不匹配MQTT 通配符语法（例如，默认的通配符语法）。
2. 您在 MQTT 主题名称或过滤器中使用来自代理的通配符语法的字符。例如，如果您正在使用默认的通配符语法和名为1.0/group/device的 MQTT 主题。此处的点 (.) 字符是代理通配符语法的一部分，并且它正在 MQTT 主题的名称中使用。
  
  在这种情况下，来自代理的通配符语法的字符（与 MQTT 通配符语法中的字符不匹配）将用反斜杠 (\) 转义。为了避免这种转换，您可以配置代理以使用 MQTT 通配符语法，或者更改 MQTT 主题名称或过滤器的名称。
此更改还将影响使用#而不是<进行通配符目的的 OpenWire JMS 消费者。在以前的版本中，#字符在从 OpenWire 通配符格式转换为核心通配符格式时只是直接传递。但是，现在#字符在转换过程中被转义。对于应用程序而言，将#用作 OpenWire JMS 客户端的通配符是一个错误；>是在 ActiveMQ Classic 文档中的通配符中指定的使用适当字符。
由于 ARTEMIS-4559，嵌入代理并依赖于 artemis-quorum-ri 和/或 artemis-quorum-api 模块，或者使用 org.apache.activemq.artemis.core.config.ha.DistributedPrimitiveManagerConfiguration 的用户需要分别使用 artemis-lockmanager-ri、artemis-lockmanager-api 和 org.apache.activemq.artemis.core.config.ha.DistributedLockManagerConfiguration。之前，这些在文档中被标记为“实验性”，并且在名称上严格更改以从概念上阐明其用途。此外，有关高可用性和网络隔离（即脑裂）的文档已得到重大重构，以使其更清晰和更全面。

7. 2.32.0

完整发行说明

7.1. 亮点

镜像核心消息现在可以在其原生格式下发送，无需转换
镜像错误修复和改进
ActiveMQ Artemis 现在采用更具包容性的语言定义。
示例现在位于其自己的存储库中：https://github.com/apache/activemq-artemis-examples/

7.2. 从 2.31.x 升级

由于 ARTEMIS-4501，MQTT 订阅队列将在相应的会话过期时自动删除，无论是基于 MQTT 5 客户端传递的会话过期时间间隔，还是基于为 MQTT 3.x 客户端或未显式传递会话过期时间间隔的 MQTT 5 客户端配置的 defaultMqttSessionExpiryInterval。

在此更改之前，删除订阅队列依赖于通用的 auto-delete-* address-settings。

这些设置现在不再需要。

改为配置 defaultMqttSessionExpiryInterval。
由于 ARTEMIS-3474，以下配置元素已更改其出现位置（例如 broker.xml、bootstrap.xml 等），尽管所有之前的配置目前仍将得到支持
- master → primary
- slave → backup
- check-for-live-server → check-for-active-server
- whitelist → allowlist
- blacklist → denylist
此外，文档和管理界面中对这些元素的引用也发生了更改。集群拓扑信息（例如，从 listNetworkTopology 返回）将包含充当主服务器的节点的 primary **和** live 条目。

10. 2.31.0

完整发行说明

10.1. 亮点

引入了交互式 shell 用于运行 CLI 命令，以及 Bash & ZSH 自动完成支持。
添加了一个 CLI 集群验证工具来帮助监视代理拓扑。使用 check cluster 命令。
queue stat 命令现在能够在使用集群时验证整个集群拓扑上的消息计数。
添加了对代理连接的 AMQP 联邦支持。
MQTT 订阅状态现在已持久化.
显着改进了分页 JDBC 持久性。
将大部分文档从 MarkDown 转换为 AsciiDoc。有关更多详细信息，请参阅 ARTEMIS-4383。
许多其他错误修复和改进。

10.2. 从 2.30.0 升级

由于 ARTEMIS-4372 和新 Artemis shell 功能的引入，当您调用 ./artemis 时，它现在将启动新 shell 以浏览 CLI 命令，而不是仅仅输出 help 文本。

11. 2.30.0

完整发行说明

11.1. 亮点

此版本主要是错误修复版本，包含一些小改进和一些依赖项升级。有关所有详细信息，请参阅发行说明。

12. 2.29.0

完整发行说明

12.1. 亮点

此版本对大型消息进行了广泛的测试和修复，其中一些 JIRA 专注于此主题。有关更多信息，请参阅发行说明。

12.2. 从 2.28.0 升级

由于 ARTEMIS-4151，现在未在 management.xml 的 role-access 或 allowlist 中定义的 MBean 的默认访问权限为只读。这是一种预防措施，以确保与代理一起部署的任何意外 MBean 不会构成风险。但是，这也将影响特定于 JVM 和平台的 MBean（例如，允许手动垃圾回收、“飞行记录”等）。现在必须通过更改 default-access（不建议）或在 management.xml 中专门为特定 MBean 配置 role-access 来手动启用对这些 MBean 的写访问权限和一般操作访问权限。

这适用于所有 MBean 访问，包括直接通过 JMX 和通过 Jolokia JMX-HTTP 桥访问。

由于 ARTEMIS-4212，代理将拒绝在 broker.xml 中未指定路由类型的地址定义，例如

<address name="myAddress"/>

此类配置需要更改为指定路由类型，例如

<address name="myAddress">
   <anycast/>
</address>

或者

<address name="myAddress">
   <multicast/>
</address>

如果配置了没有路由类型的地址，代理将抛出类似的异常并无法启动

java.lang.IllegalArgumentException: AMQ229247: Invalid address configuration for 'myAddress'. Address must support multicast and/or anycast.
      at org.apache.activemq.artemis.core.deployers.impl.FileConfigurationParser.parseAddressConfiguration(FileConfigurationParser.java:1580)
      at org.apache.activemq.artemis.core.deployers.impl.FileConfigurationParser.parseAddresses(FileConfigurationParser.java:1038)
      at org.apache.activemq.artemis.core.deployers.impl.FileConfigurationParser.parseMainConfig(FileConfigurationParser.java:804)
      at org.apache.activemq.artemis.core.config.impl.FileConfiguration.parse(FileConfiguration.java:56)
      at org.apache.activemq.artemis.core.config.FileDeploymentManager.readConfiguration(FileDeploymentManager.java:81)
      at org.apache.activemq.artemis.integration.FileBroker.createComponents(FileBroker.java:120)
      at org.apache.activemq.artemis.cli.commands.Run.execute(Run.java:119)
      at org.apache.activemq.artemis.cli.Artemis.internalExecute(Artemis.java:212)
      at org.apache.activemq.artemis.cli.Artemis.execute(Artemis.java:162)
      at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
      at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
      at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
      at java.base/java.lang.reflect.Method.invoke(Method.java:566)
      at org.apache.activemq.artemis.boot.Artemis.execute(Artemis.java:144)
      at org.apache.activemq.artemis.boot.Artemis.main(Artemis.java:61)

由于 ARTEMIS-3707，从 JCA 资源适配器中删除了所有 javax.transaction.TransactionManager 的使用。但是，这使 transactionTimeout 激活配置属性变得无用。一些现有用户依赖于此行为，因此它已被恢复并为将来删除而适当弃用。

13. 2.28.0

完整发行说明

13.1. 亮点

错误修复和改进一如既往
ARTEMIS-4136 镜像同步复制
- 镜像现在有一个选项可以设置 sync=true。来自客户端的阻塞操作将等待镜像上的往返行程。
ARTEMIS-4065 分页计数器日志记录已删除
- 我们不再在日志中存储分页计数器记录，这应该可以简化操作并提高性能。

13.2. 从 2.27.0 升级

由于 ARTEMIS-3871，用于 MQTT 共享订阅队列的命名模式已更改。以前，订阅队列的命名方式是根据 MQTT SUBSCRIBE 数据包中提供的订阅名称。但是，MQTT 允许在多个订阅中使用相同的名称，而代理中的队列必须具有唯一的名称。现在，订阅队列的命名方式将根据订阅名称和主题名称，以确保所有订阅队列名称都是唯一的。在升级之前，请确保所有 MQTT 共享订阅都是空的。当订阅者重新连接时，他们将获得一个新的订阅队列。如果它们不为空，您可以通过管理方式将消息移动到新的订阅队列。

14. 2.27.1

完整发行说明

14.1. 亮点

错误修复
通过桥接的 AMQP 大型消息已损坏
大规模事务回滚需要很长时间才能处理
对自动创建和自动删除队列的改进。

15. 2.27.0

完整发行说明

15.1. 亮点

2.27.0 引入了一个新的升级工具来帮助将您的实例迁移到较新的版本。
客户端和代理现在使用 SLF4J 作为其日志记录 API。
代理分发现在使用 Log4J 2 作为其日志记录实现。

15.2. 从 2.26.0 升级

希望进行日志记录的客户端应用程序现在需要提供适当的 SLF4J 支持日志记录实现，并根据其需要进行适当配置。有关更多信息以及有关使用 Log4J 2 的示例，请参阅客户端应用程序日志记录。

代理分发现在包含并配置 Log4J 2 作为其日志记录实现，有关更多详细信息，请参阅日志记录。如果要升级现有代理实例而不是创建新实例，则需要对代理现有实例的 /etc 和 /bin 文件进行一些配置等更新。

您可以使用从新下载的代理中获取的新升级辅助工具来刷新现有代理实例的各种配置文件和脚本。broker.xml 和数据保持原样。

在运行命令之前，您应该备份现有代理实例。

可以通过从新下载的代理主目录运行 ./artemis upgrade <path-to-your-instance> 来执行该命令。

在刷新文件过程中，大多数对旧配置文件和脚本的现有自定义内容将丢失。因此，您应该将旧配置文件与刷新的配置文件进行比较，然后根据需要移植您可能已进行的任何缺失的自定义内容。升级命令本身会将它更改的旧文件复制到实例目录中的 old-config-bkp. 文件夹中。

同样，如果您已自定义旧的 logging.properties 文件，则可能需要为新的 log4j2.properties 文件准备类似的更改。

还要注意，broker.xml 中的 configuration-file-refresh-period 设置不再涵盖日志记录配置刷新。Log4J 2 具有自己的配置重新加载处理，通过 Log4J 配置文件本身内的 monitorInterval 属性进行配置。创建的默认 <instance>/etc/log4j2.properties 文件具有设置为 5 秒的 monitorInterval 值，以与之前的默认代理行为保持一致。

15.3. 手动更新

或者，除了使用上面概述的升级辅助工具之外，您还可以按照以下步骤手动执行更新，遵循一般升级步骤以及以下附加步骤

应使用 Log4J 2 配置创建新的 <instance>/etc/log4j2.properties 文件。“artemis create” CLI 命令使用的文件可以从以下位置下载：log4j2.properties
应删除旧的 <instance>/etc/logging.properties JBoss 日志记录配置文件。
需要相关的启动脚本或配置文件清理：自 2.26.0 以来所需更改的差异文件可从此处（适用于 *nix）或此处（适用于 Windows）获取。

16. 2.26.0

完整发行说明

16.1. 亮点

错误修复和改进

16.2. 从 2.25.0 升级

由于ARTEMIS-4006，artemis-jms-client-all和artemis-jakarta-client-all客户端已从二进制发行版中的lib/client目录中删除。如果您使用这些库，则可以在Maven Central（例如这里）找到它们。有关更多信息，请参阅客户端类路径文档。
我们从代码库和文档中删除了REST接口。如果您仍然需要REST接口，则可以访问仍然可行的最新版本。您仍然可以按照先前文档中的步骤构建和部署该接口。但是，您应该停止使用它，因为它将不再维护。
由于ARTEMIS-3980，Web内容已从二进制发行版中删除。我们现在将使用根目标重定向Web请求到管理控制台。要在当前实例上启用此新的重定向行为，您必须更新bootstrap.xml。更改
```
<web path="web">
```
到
```
<web path="web" rootRedirectLocation="console">
```
如果您以前自定义过索引页面或在web文件夹中添加了自定义内容，请参阅Web服务器文档以获取有关禁用重定向和启用Web内容的更多信息。

17. 2.25.0

完整发行说明

17.1. 亮点

分页流控制改进
许多其他错误修复和改进

18. 2.24.0

完整发行说明

18.1. 亮点

简化的页面缓存和文件只需读入队列，而无需软缓存。

18.2. 从2.23.0升级

由于ARTEMIS-3851，为使用CleanSession=1的MQTT 3.x订阅者创建的队列现在是**非持久的**而不是持久的。这可能会影响MQTT客户端的security-settings，这些客户端以前只对其角色具有createDurableQueue。他们现在还需要createNonDurableQueue。同样，这只会对使用CleanSession=1的MQTT 3.x客户端产生潜在影响。
由于ARTEMIS-3892，分配给队列的用户名将基于**验证后的**用户，而不仅仅是客户端应用程序提交的用户名。这将影响以下用例
1. 当login.config配置了GuestLoginModule，导致某些用户在身份验证过程中被分配特定用户名和角色时。
2. 当login.config配置了CertificateLoginModule，导致用户被分配与其SSL证书中的主体DN相对应的用户名和角色时。
在这种情况下，代理将使用此分配的（即验证后的）用户名创建任何与连接关联的队列。在过去，队列的用户名将为空。

19. 2.23.1

完整发行说明

19.1. 亮点

ARTEMIS-3856 - 无法将通道状态更改为ReadyForWriting：java.util.ConcurrentModificationException

版本

2.1.0