Red Hat AMQ broker 7 Supported Configurations
Table of Contents
- Red Hat AMQ broker 7.11
- AMQ Components Previously Listed On This Page
- AMQ broker 7.11 Supported Configurations
- AMQ broker 7.11 Tested Configurations
- Interoperability with FUSE
- OpenShift Images
- Cloud Services
- Message wire-protocol conversion support
- Kerberos Network Authentication Service
- Red Hat AMQ clients 2.11
- Specific supported clients and OSs
- AMQ JMS details
- Standards and network protocols
Red Hat AMQ broker 7.11
Every Red Hat AMQ broker release is tested and supported on a variety of market-leading operating systems, Java™ Virtual Machines (JVMs), and database combinations. Red Hat provides both production and development support for supported configurations and tested integrations according to your subscription agreement in both physical and virtual environments.
Supported configurationf for previous AMQ broker 7.X releases can be found here.
AMQ Components Previously Listed On This Page
Components formerly grouped with AMQ 7 such as Streams and Interconnect have been removed from the AMQ grouping and each has a supported configuration page created for it.
AMQ broker 7.11 Supported Configurations
Red Hat provides both production and development support for supported configurations according to your subscription agreement in both physical and virtual environments.[1] In order to be running in a supported configuration, JBoss AMQ must be running in one of the following JVM versions and on one of the operating systems supported by that JVM.
| Java Virtual Machine | Version |
|---|---|
| OpenJDK | 11, 17 |
| OracleJDK | 11,17 |
[1] Red Hat expects that customers will remain on a supported environment. In the event that a JVM, operating system, database, etc., or its version is no longer supported by its vendor, Red Hat may be limited in its ability to provide support and may require you to reproduce the issue in a supported environment for continued assistance.
AMQ broker 7.11 Tested Configurations
Red Hat has performed the full range of platform tests on the following tested configurations
| Operating system | Architecture | JVM |
|---|---|---|
| RHEL 7 | x86_64 | OpenJDK 11 & 17 , Oracle JDK 11 |
| RHEL 8 | x86_64 | OpenJDK 11 & 17, Oracle JDK 11 |
| RHEL 9 | x86_64 | OpenJDK 11 & 17, Oracle JDK 11 |
| Microsoft Windows Server 2012 R2 | x86_64 | OpenJDK 11 & 17, Oracle JDK 11 |
| Microsoft Windows Server 2019 | x86_64 | OpenJDK 11 & 17, Oracle JDK 11 |
- This is the last release that will be supported on RHEL 6 without a support exception
Note: Earlier versions of the JDK are not supported.
Interoperability with FUSE
With regards to FUSE, AMQ broker 7.x is only supported as a remote broker. AMQ Broker 7.x is not certified to run as the internal broker in FUSE 6.x or 7.x. AMQ broker 7.x has been tested and certified to work as an external broker with FUSE 6.x and 7.x components (camel-jms, camel-amqp).
OpenShift Images
| Image | OpenShift Compatibility | Architecture |
|---|---|---|
| Red Hat AMQ broker 7.11 | OpenShift 4.9,4.10,4.11,4.12,4.13,4.14 | x86_64,s390x, & ppc64le |
| Red Hat AMQ broker Operator | OpenShift 4.9,4.10,4.11,4.12,4.13,4.14 | x86_64,s390x, & ppc64le |
Note: AMQ 7.8 is the last version of AMQ broker supported on OpenShift 3.11.
Cloud Services
| AMQ broker 7.11 is supported as the following cloud services |
|---|
| Redhat Openshift Service on AWS (ROSA) |
| Microsoft Azure Redhat Openshift |
Note: When running the Broker in AWS it is recommended to use EBS storage instead of EFS. EFS was intended for large storage and not transactional processing and could lead to low throughput which in turn could cause the broker to become unresponsive.
Tested databases
| Database | Version | JDBC Driver Version |
|---|---|---|
| Oracle | 12c, 18c, 19c | v12 |
| DB2 | 11 | v4 |
| MSSQL | 2016 and 2019 | v8.4.1 |
| PostgreSQL | 11.5 | v11 |
| Mysql | 8 | v8 |
Note: Databases are only required when JDBC is selected as the message persistence store option. Please read documentation to understand the limitations and performance trade-offs inherent in using JDBC persistence.
Message wire-protocol conversion support
Messages sent to an address from a client that uses one wire-protocol should be consumable from a client using one of the other supported wire protocols as listed below.
| Protocol | AMQP 1.0 | OpenWire | CORE | MQTT | STOMP |
|---|---|---|---|---|---|
| AMQP 1.0 | NA | X | X | X | X |
| OpenWire | X | NA | X | X | X |
| CORE | X | X | NA | X | X |
| MQTT 5 | X | X | X | NA | X |
| STOMP | X | X | X | X | NA |
- AMQP 1.0 is the message protocol of the AMQ JMS, AMQ C++, AMQ JavaScript, AMQ Python, and AMQ .NET clients.
- OpenWire is the message protocol of the AMQ OpenWire JMS client, the JMS implementation previously provided in AMQ 6. It is provided for backward compatibility during migration from AMQ 6 to AMQ 7. As AMQ 6 is coming to the end of its life it is strongly recommended that customers that have migrated from AMQ 6 to 7 migrate any remaining OpenWire clients to a modern supported client in one of the other actively supported clients.
- Core Protocol is the message protocol of the AMQ Core Protocol JMS client, the JMS implementation previously provided with HornetQ.
- MQTT is a machine to machine messaging protocol commonly used in IoT applications. AMQ 7 Brokers support version MQTT 5 with Qos levels of 0,1, & 2 Red Hat does not provide clients for use with the MQTT protocol. Several MQTT clients for multiple languages can be found at the MQTT Community.
- STOMP is a simple text based protocol for sending messages through a broker. Red Hat does not provide clients for STOMP. For information about using STOMP visit the STOMP site.
Supported network file systems
The following network file systems are supported for use with AMQ Broker 7.10 in the master/slave failover configuration:
- NFSv4
- GFS2
- GlusterFS *
- Ceph
Note: GlusterFS is supported for use as the message store for brokers in OpenShift and "bare metal," environments. GlusterFS is not recommended or supported for creating multiple-datacenter/availability zone DR strategies.
Kerberos Network Authentication Service
Kerberos version 5 is supported for authentication between kerberos enabled clients and the broker. Kerberos was tested with the following.
- Microsoft Windows Server 2012 R2 Active Directory
- Free IPA (Red Hat Identity Management) 4.5.0-21
LDAP Directories tested for use with the broker
The following LDAP providers were tested as users stores for authentication and authorization
- Windows Active Directory
- Apache Directory Server
- RH 389 Directory Server
A Note on shared - nothing high availability
Shared - nothing HA is only supported in a single local data center preferably on the same network subnet. Shared - nothing HA is very sensitive to network latency and consistency therefore shared - nothing HA configurations where the master is in one data center and the slave is in another are specifically not supported.
Apache Maven
AMQ 7.10 was built from source using Apache Maven 3.6.3. It should not be assumed that building from source with an earlier version will work. Any examples provided with the broker should be built or executed with Maven 3.6.3.
Red Hat AMQ clients 2.11
AMQ clients are supported for use on the following operating systems, architectures, and JVM versions. Note: Clients are backward compatible and supported on the latest released and supported version of AMQ 6.
Not all clients are supported on all operating systems. Specific client support is documented in the section titled Specific supported clients and OSs.
| Operating system | Architecture | JVM |
|---|---|---|
| RHEL 8 | X86_64 | OpenJDK 11 &17, Oracle JDK 11, IBM JDK 11 |
| RHEL 7 | x86_64 | OpenJDK 11 &17, Oracle JDK 11, or IBM JDK 11 |
| IBM AIX 7.1 | x86_64 | IBM JDK 11 |
| Microsoft Windows Server 2012 R2 | x86_64 | Oracle JDK 11 |
| Microsoft Windows Server 2016 | x86_64 | Oracle JDK 11 |
| Microsoft Windows 10 Professional | x86_64 | Oracle JDK 11 |
| Solaris 10 and 11 | x86, x86_64, or Sparc 64 | Oracle JDK 11 |
Note: Earlier versions of the JDK are not supported.
Specific supported clients and OSs
The table below lists the supported operating systems for each AMQ Client. Additional information about specific clients is documented in subsequent sections.
| Operating system | AMQ JMS | AMQ C++ | AMQ JavaScript | AMQ Python | AMQ .NET | AMQ Ruby |
|---|---|---|---|---|---|---|
| RHEL 8 x86_64 | Yes | Yes | Yes | Yes | Yes | Yes |
| RHEL 7 x86_64 | Yes | Yes | Yes | Yes | Yes | Yes |
| Microsoft Windows Server 2012 R2 | Yes | Yes | Yes | Yes | Yes | No |
| Microsoft Windows Server 2016 | Yes | Yes | Yes | Yes | Yes | No |
| Microsoft Windows 10 Professional | Yes | Yes | Yes | Yes | Yes | No |
| IBM AIX 7.1 | Yes | No | No | No | No | No |
| Solaris 10 and 11 | Yes | No | No | No | No | No |
AMQ JMS details
The AMQ JMS client is supported on the following OSs and JVMs.
| Operating system | JVM |
|---|---|
| RHEL 8 | OpenJDK 11 &17, Oracle JDK 11, IBM JDK 11 |
| RHEL 7 | OpenJDK 11 &17 or Oracle JDK 11, IBM JDK 11 |
| Microsoft Windows Server 2012 R2 | Oracle JDK 11 |
| IBM AIX 7.1 | IBM JDK 11 |
| Solaris 10 and 11 | Oracle JDK 8 |
Notes:
+ Earlier versions of the JDK are not supported.
+ The AMQ JMS Client supports the use of the AMQ Pool library.
Standards and network protocols
- Version 2.0 of the Java Message Service API
- Version 1.0 of the Advanced Message Queueing Protocol (AMQP)
- Version 1.0 of the AMQP JMS Mapping
- Modern TCP with IPv6
AMQ C++ details
The AMQ C++ client is supported on the following OSs with the compilers and standards that are listed.
| Operating system | Compiler | Standard |
|---|---|---|
| RHEL 8 | GNU C++ | Compiling as C++11 |
| RHEL 7 | GNU C++ | Compiling as C++11 |
| Microsoft Windows Server 2012 R2 | Microsoft Visual Studio 2013 | Compiling as C++11 |
| Microsoft Windows Server 2016 | Microsoft Visual Studio 2013 | Compiling as C++11 |
| Microsfot Windows 10 Professional | Microsoft Visual Studio 2013 | Compiling as C++11 |
Standards and network protocols
- Version 1.0 of the Advanced Message Queueing Protocol (AMQP)
- Versions 1.0, 1.1, and 1.2 of the Transport Layer Security (TLS) protocol, the successor to SSL
- Modern TCP with IPv6
AMQ JavaScript details
The AMQ JavaScript client is supported on the following OSs and JavaScript runtimes.
| Operating system | JavaScript runtime |
|---|---|
| RHEL 8 | Node.js 14 |
| RHEL 7 | Node.js 14 from Software Collections |
| Microsoft Windows Server 2012 R2 | Node.js 14 from the Node.js project |
| Microsoft Windows Server 2016 | Node.js 14 from the Node.js project |
| Microsoft Windows 10 | Node.js 14 from the Node.js project |
Standards and network protocols
- Version 1.0 of the Advanced Message Queueing Protocol (AMQP)
- Versions 1.0, 1.1, and 1.2 of the Transport Layer Security (TLS) protocol, the successor to SSL
- Modern TCP with IPv6
Supported browsers
Supported browsers include the following:
- Google Chrome
- Mozilla Firefox
Note: Microsoft Internet Explorer is no longer supported for use with Broker consoles.
AMQ Python details
The AMQ Python client is supported on the following OSs and languages.
| Operating system | Python version |
|---|---|
| RHEL 8 | Python 3.6 |
| RHEL 7 | Python 3.6 |
| Microsoft Windows Server 2012 R2 | Python 3.6 or 3.8 |
| Microsoft Windows Server 2016 | Python 3.6 or 3.8 |
| Microsoft Windows 10 Professional | Python 3.6 or 3.8 |
Standards and network protocols
- Version 1.0 of the Advanced Message Queueing Protocol (AMQP)
- Versions 1.0, 1.1, and 1.2 of the Transport Layer Security (TLS) protocol, the successor to SSL
- Modern TCP with IPv6
AMQ .NET details
The AMQ .NET client is supported with the following OS and runtime.
| Operating system | .NET version |
|---|---|
| RHEL 8 | .NET Core 3.1 |
| RHEL 7 | .NET Core 3.1 |
| Microsoft Windows Server 2012 R2 | .NET Core 3.1 or .NET Framework 4.7 |
| Microsoft Windows Server 2016 | .NET Core 3.1 or .NET Framework 4.7 |
| Microsoft Windows 10 Professional | .NET Core 3.1 or .NET Framework 4.7 |
- Note .NET Core is not supported by the NMS client
Standards and network protocols
- Version 1.0 of the Advanced Message Queueing Protocol (AMQP)
- Modern TCP with IPv6
[1] Red Hat expects that customers will remain on a supported environment. In the event that a JVM, operating system, database, etc., or its version is no longer supported by its vendor, Red Hat may be limited in its ability to provide support and may require you to reproduce the issue in a supported environment for continued assistance.
XA Transaction support
The following clients support XA transactions.
| Client | Wire Protocol |
|---|---|
| AMQ Core Protocol JMS | Core Protocol |
| AMQ OpenWire JMS | OpenWire Protocol |
AMQ Pool Support
The following clients support the use of the AMQ Pool library
- AMQ JMS Client
- AMQ Core Protocol JMS
- AMQ OpenWire JMS
Note: The AMQ Pool library is supported with these clients when used on OS and JVM combinations that are supported by the client.
Red Hat AMQ online 1.7
Red Hat AMQ online 1.7 is supported on the following platforms.
| Platform | Version |
|---|---|
| OpenShift Container Platform | 3.11, 4.8 thru 4.10* |
- OpenShift 4.10 is the last release that AMQ Online will be supported on.
AMQ online is no longer actively developed and will reach its end of life soon. AMQ Online EOL Statement
17 Comments
Hello Ramon, Information about configuring LDAP is in chapter 9.2 of the "Using the Broker" guide here: https://access.redhat.com/documentation/en-us/red_hat_jboss_amq/7.0/html/using_amq_broker/security#integrating-ldap Please let me know if this is not the information that you're looking for. Thank you.
Apologies, Ramon. I just noticed the email thread on this topic and I see that you're looking for more details around migration and LDAP. I'll ensure that the documentation request from that thread gets tracked.
Would like to see more about backwards compatibility with OpenWire clients.
I saw this slideshow from a year ago: "A-MQ 7 Sneak Preview" https://www.redhat.com/files/summit/session-assets/2016/SS88848-sneak-preview-of-next-generation-messaging-platform-red-hat-jboss-a-mq-7.pdf
It said that openwire clients would still work in A-MQ 7 (JMS 1.1, C++, NMS). Please speak about whether that is supported because we are having troubles in those configurations.
For AMQ 6.3 please see article
Hi, I noticed that the supported configuration for AMQ Streams 1.3 for RHEL is not aligned with the product documentation https://access.redhat.com/documentation/en-us/red_hat_amq/7.5/html/using_amq_streams_on_rhel/overview-str#idm140649900148240 about the RHEL version. In the article the supported configurations indicated that only RHEL 7 is supported (and also indicated version 1.2. of AMQ Streams and not 1.3) while the product documentation said that RHEL 7.x and 8.x are supported. Can we fix this misalignment?
Regards,
Mauro Vocale
Red Hat AMQ Streams 1.3 describes that OpenJDK 11 is supported in RHEL 8, you could see here [1]. However this article defines that only OpenJDK 8 is supported in both platforms RHEL 7 and RHEL 8.
Which reference is the right one?
Regards
[1] https://access.redhat.com/documentation/en-us/red_hat_amq/7.5/html-single/using_amq_streams_on_rhel/index#overview-supported-configurations-str
Hi,
Is Red Hat AMQ Online 1.7 supported on OpenShift 4.7?
Thanks!
I guess they are just slow again updating their stuff...
Indeed
woot woot fixed :)
Party!!
Doing a little dance!
Hi, I need to understand if Debezium is supported or not in AMQ Streams on RHEL scenario. Based on what it's described in this article it seems that the answer is NO. Also the official documentation seems to confirm it: AMQ Streams on Openshift, https://access.redhat.com/documentation/en-us/red_hat_amq/2021.q3/html/release_notes_for_amq_streams_1.8_on_openshift/supported-config-str , lists Debezium as supported while the one of AMQ Streams on RHEL https://access.redhat.com/documentation/en-us/red_hat_amq/2021.q3/html/release_notes_for_amq_streams_1.8_on_rhel/supported-config-str doesn't do it. If you read the Debezium documentation, https://access.redhat.com/documentation/en-us/red_hat_integration/2021.q3/html/installing_debezium_on_rhel/installing-debezium-connectors-on-rhel-debezium#debezium-rhel-install-prerequisites , it seems that AMQ Streams on RHEL is supported with Debezium. So Debezium is supported or not on AMQ Streams on RHEL?
It would be nice to have a kind of change logs. I got notified twice today but don't really have any clue about what has been added to the page.
Sorry, I didnt make change comments. The changes were the addition of IBM Z & PPC support on OpenShfit.
Hello, Can you tell me if we can use Oracle 21c instead 19c? It is not labeled as "tested" but maybe something changed recently? Thank you
Hi Tomasz, Based on the life cycle of Oracle 21c we don't have plans to certify this version. However, we will plan to certify Oracle 23c with the next minor version of AMQ broker.