版本訊息佇列

本章提供每個版本的以下資訊

完整版本說明連結，其中包含此版本中解決的所有問題。
適用時的「重點」簡短清單。
如有必要，從先前版本升級時所需的特定步驟。

如果升級跨越多個版本，則需要依序遵循每個版本的步驟。

除了此處概述的任何特定於版本的升級指示之外，請遵循升級 Broker章節中概述的一般升級程序。

1. 2.38.0

完整版本說明

1.1. 重點

現在支援 WebSocket 壓縮。當透過 WebSockets 進行通訊時，此壓縮可以透明地用於 AMQP、STOMP 或 MQTT。
ActiveMQServerMessagePlugin 現在具有 messageMoved() 回呼。
核心橋接器組態現在支援 client-id，這將使識別遠端 Broker 上的橋接連線更加容易。
consumer CLI 命令現在透過為 --receive-timeout 指定 -1 來支援「永久」使用訊息。
驗證與授權快取現在具有詳細的偵錯記錄。
Broker 管理已進行了一些更新
- 文件已改進，包含更多關於 Jolokia 的範例，以及關於管理方法選項語法的新子章節。
- 現在可以將空的「選項」傳遞給接受它們的管理方法。
- 傳回分頁結果的管理方法現在可以透過為頁面或 pageSize 指定 -1 來一起傳回所有結果。
- 管理方法選項語法現在支援 NOT_EQUALS 運算子，以便在篩選管理操作結果時更具彈性。
- 現在可以透過 JSON 完成透過管理建立的轉移組態。
TextFileCertificateLoginModule 現在支援 DN 屬性值的標準化。有關更多詳細資訊，請參閱 ARTEMIS-5102

1.2. 從 2.37.0 升級

由於 ARTEMIS-5096，Web 主控台的封存（即 console.war）現在將被解壓縮。此變更是為了從封存中移除某些已在 Broker 的主要 lib 目錄中發佈的 jar 檔案。消除這些重複的 jar 將減少 Broker 發佈的大小，這也表示主控台在某些情況下將使用更新的相依性，並防止安全工具標記較舊的 jar。
由於 ARTEMIS-5101，用於對稱密碼遮罩的預設敏感字串編解碼器中的 two-way 演算法現在已被棄用。它將繼續運作，但會在日誌中列印警告。這是逐步消除組態檔案中儲存密碼的第一步，除了透過強大的單向雜湊演算法編碼的密碼。其他用例將被推向基於憑證的安全（即相互 TLS）或不需要密碼的等效機制。
由於 ARTEMIS-5085，參數 retryIntervalMultiplier 和 maxRetryInterval 現在將套用於「初始」連線嘗試（即透過 initialConnectAttempts 控制）。這是為了修正這些參數被錯誤忽略的錯誤。

2. 2.37.0

完整版本說明

2.1. 重點

除了 run 之外的 CLI 命令的環境變數可透過 artemis-utility.profile 檔案進行組態。
除了 run 之外的 CLI 命令的記錄組態可透過 log4j2-utility.properties 檔案進行組態。
run 命令已從 artemis shell 中移除，使用 artemis 指令碼（Windows 上為 artemis.cmd）來執行它。
投票 (共用無任何複寫仲裁協定) 的版本相容性已在 ARTEMIS-4986 中修正。

2.2. 從 2.36.0 升級

除了 run 之外的 CLI 命令現在將需要透過 artemis-utility.profile 檔案定義環境變數，並透過 log4j2-utility.properties 檔案定義記錄組態。有關更多資訊，請參閱記錄。

3. 2.36.0

完整版本說明

3.1. 重點

由與 GitHub 的 Dependabot 整合觸發的眾多相依性升級。
透過 ARTEMIS-4949 改善涉及較慢 IO 裝置（例如 NFS）和 NIO 日誌的用例的穩定性。
由於 ARTEMIS-4814，位址管理員中的程式碼最佳化可減少 CPU 使用率並提高涉及大量位址和佇列的用例的 Broker 可擴充性。
透過 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 主控台現在將報告所有內部物件。
- 這樣做是為了讓管理員在事情未按預期運作時採取行動、取得這些物件的指標，並讓 Broker 更加透明。
- 這包括所有 Openwire Advisor 佇列和位址、MQTT 內部物件、叢集儲存和轉發 (SNF) 佇列、鏡像 SNF。
- 如果您打算控制 Web 主控台上某些使用者的存取權，則可能需要重新檢查授權。
CLI 操作 ./artemis queue stat 的輸出已改善和更新。如果您在指令碼中剖析先前的輸出，您將看到輸出中的差異。
- 不建議剖析 CLI 操作的輸出。您可以使用 jolokia 通過管理來進行呼叫，並使用適當的 JSON 輸出。

6. 2.33.0

完整版本說明

6.1. 重點

支援 CLI producer 命令上的 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 萬用字元格式轉換為 Core 萬用字元格式時，# 字元只是被傳遞過去。然而，現在 # 字元會在轉換過程中被跳脫。應用程式使用 # 作為 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. 重點

鏡像 Core 訊息現在可以使用其原生格式傳送，而無需轉換
鏡像錯誤修正和改進
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（例如，允許手動垃圾收集、「飛行記錄」等）。現在必須在 management.xml 中手動啟用對這些 MBean 的寫入存取和一般操作存取，方法是變更 default-access（不建議）或為相關的特定 MBean 具體設定 role-access。

這適用於所有 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，所有對 javax.transaction.TransactionManager 的使用都已從 JCA 資源配接器中移除。然而，這使得 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 Logging 設定檔。
需要進行相關的啟動腳本或設定檔清理：自 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 訂閱者所建立的佇列現在是非持久性，而不是持久性。這可能會影響先前僅針對其角色具有 createDurableQueue 的 MQTT 用戶端的 security-settings。現在他們也需要 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