Versions
This chapter provides the following information for each release:
- A link to the full release notes which includes all issues resolved in the release.
- A brief list of "highlights" when applicable.
- If necessary, specific steps required when upgrading from the previous version.
- Note: If the upgrade spans multiple versions then the steps from each version need to be followed in order.
- Note: Follow the general upgrade procedure outlined in the Upgrading the Broker chapter in addition to any version-specific upgrade instructions outlined here.
2.11.0
Highlights:
- Support retroactive addresses.
- Support downstream federated queues and addresses.
- Make security manager configurable via XML.
- Support pluggable SSL TrustManagerFactory.
- Add plugin support for federated queues/addresses.
- Support
com.sun.jndi.ldap.read.timeout
in LDAPLoginModule.
2.10.0
This was mainly a bug-fix release with a notable dependency change impacting version upgrade.
Upgrading from 2.9.0
Due to the WildFly dependency upgrade the broker start scripts/configuration need to be adjusted after upgrading.
On *nix
Locate this statement in bin/artemis
:
WILDFLY_COMMON="$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final.jar"
This needs to be replaced with this:
WILDFLY_COMMON="$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final.jar"
On Windows
Locate this part of JAVA_ARGS
in etc/artemis.profile.cmd
respectively bin/artemis-service.xml
:
%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final.jar
This needs to be replaced with this:
%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final.jar
2.9.0
This was a light release. It included a handful of bug fixes, a few improvements, and one major new feature.
Highlights:
- Support exporting metrics.
2.8.1
This was mainly a bug-fix release with a notable dependency change impacting version upgrade.
Upgrading from 2.8.0
Due to the dependency upgrade made on ARTEMIS-2319 the broker start scripts need to be adjusted after upgrading.
On *nix
Locate this if
statement in bin/artemis
:
if [ -z "$LOG_MANAGER" ] ; then
# this is the one found when the server was created
LOG_MANAGER="$ARTEMIS_HOME/lib/jboss-logmanager-2.0.3.Final.jar"
fi
This needs to be replaced with this block:
if [ -z "$LOG_MANAGER" ] ; then
# this is the one found when the server was created
LOG_MANAGER="$ARTEMIS_HOME/lib/jboss-logmanager-2.1.10.Final.jar"
fi
WILDFLY_COMMON=`ls $ARTEMIS_HOME/lib/wildfly-common*jar 2>/dev/null`
if [ -z "$WILDFLY_COMMON" ] ; then
# this is the one found when the server was created
WILDFLY_COMMON="$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final.jar"
fi
Notice that the jboss-logmanager
version has changed and there is also a new wildfly-common
library.
Not much further down there is this line:
-Xbootclasspath/a:"$LOG_MANAGER" \
This line should be changed to be:
-Xbootclasspath/a:"$LOG_MANAGER:$WILDFLY_COMMON" \
On Windows
Locate this part of JAVA_ARGS
in etc/artemis.profile.cmd
respectively bin/artemis-service.xml
:
-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final.jar
This needs to be replaced with this:
-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final.jar
2.8.0
Highlights:
- Support ActiveMQ5 feature JMSXGroupFirstForConsumer.
- Clarify handshake timeout error with remote address.
- Support duplicate detection for AMQP messages the same as core.
2.7.0
Highlights:
- Support advanced destination options like
consumersBeforeDispatchStarts
andtimeBeforeDispatchStarts
from 5.x. - Add support for delays before deleting addresses and queues via
auto-delete-queues-delay
andauto-delete-addresses-delay
Address Settings. - Support logging HTTP access.
- Add a CLI command to purge a queue.
- Support user and role manipulation for PropertiesLoginModule via management interfaces.
- Docker images.
- Audit logging.
- Implementing consumer priority.
- Support FQQN for producers.
- Track routed and unrouted messages sent to an address.
- Support connection pooling in LDAPLoginModule.
- Support configuring a default consumer window size via
default-consumer-window-size
Address Setting. - Support masking
key-store-password
andtrust-store-password
in management.xml. - Support
JMSXGroupSeq
-1 to close/reset message groups from 5.x. - Allow configuration of RMI registry port.
- Support routing-type configuration on core bridge.
- Move artemis-native as its own project, as activemq-artemis-native.
- Support federated queues and addresses.
2.6.4
This was mainly a bug-fix release with a few improvements a couple notable new features:
Highlights:
- Added the ability to set the text message content on the
producer
CLI command. - Support reload logging configuration at runtime.
2.6.3
This was mainly a bug-fix release with a few improvements but no substantial new features.
2.6.2
This was a bug-fix release with no substantial new features or improvements.
2.6.1
This was a bug-fix release with no substantial new features or improvements.
2.6.0
Highlights:
- Support regular expressions for matching client certificates.
- Support
SASL_EXTERNAL
for AMQP clients. - New examples showing virtual topic mapping and exclusive queue features.
2.5.0
Highlights:
- Exclusive consumers.
- Equivalent ActiveMQ 5.x Virtual Topic naming abilities.
- SSL Certificate revocation list.
- Last-value queue support for OpenWire.
- Support masked passwords in bootstrap.xm and login.config
- Configurable broker plugin implementation for logging various broker events (i.e.
LoggingActiveMQServerPlugin
). - Option to use OpenSSL provider for Netty via the
sslProvider
URL parameter. - Enable splitting of broker.xml into multiple files.
- Enhanced message count and size metrics for queues.
Upgrading from 2.4.0
- Due to changes from ARTEMIS-1644 any
acceptor
that needs to be compatible with HornetQ and/or Artemis 1.x clients needs to haveanycastPrefix=jms.queue.;multicastPrefix=jms.topic.
in theacceptor
url. This prefix used to be configured automatically behind the scenes when the broker detected these old types of clients, but that broke certain use-cases with no possible work-around. See ARTEMIS-1644 for more details.
2.4.0
Highlights:
- JMX configuration via XML rather than having to use system properties via command line or start script.
- Configuration of max frame payload length for STOMP web-socket.
- Ability to configure HA using JDBC persistence.
- Implement role-based access control for management objects.
Upgrading from 2.3.0
- Create
<ARTEMIS_INSTANCE>/etc/management.xml
. At the very least, the file must contain this:
This configures role based authorisation for JMX. Read more in the Management documentation.<management-context xmlns="http://activemq.org/schema"/>
If configured, remove the Jolokia war file from the
web
element in<ARTEMIS_INSTANCE>/etc/bootstrap.xml
:<app url="jolokia" war="jolokia.war"/>
This is no longer required as the Jolokia REST interface is now integrated into the console web application.
If the following is absent and you desire to deploy the web console then add:
<app url="console" war="console.war"/>
Note: the Jolokia REST interface URL will now be at
http://<host>:<port>/console/jolokia
2.3.0
Highlights:
- Web admin console!
- Critical Analysis and deadlock detection on broker
- Support Netty native kqueue on Mac.
- Last-value queue for AMQP
Upgrading from 2.2.0
- If you desire to deploy the web console then add the following to the
web
element in<ARTEMIS_INSTANCE>/etc/bootstrap.xml
:<app url="console" war="console.war"/>
2.2.0
Highlights:
- Scheduled messages with the STOMP protocol.
- Support for JNDIReferenceFactory and JNDIStorable.
- Ability to delete queues and addresses when broker.xml changes.
- Client authentication via Kerberos TLS Cipher Suites (RFC 2712).
2.1.0
Highlights:
- Broker plugin support.
- Support Netty native epoll on Linux.
- Ability to configure arbitrary security role mappings.
- AMQP performance improvements.
2.0.0
Highlights:
- Huge update involving a significant refactoring of the addressing model yielding the following benefits:
- Simpler and more flexible XML configuration.
- Support for additional messaging use-cases.
- Eliminates confusing JMS-specific queue naming conventions (i.e. "jms.queue." & "jms.topic." prefixes).
- Pure encoding of messages so protocols like AMQP don't need to convert messages to "core" format unless absolutely necessary.
- "MAPPED" journal type for increased performance in certain use-cases.
1.5.6
Highlights:
- Bug fixes.
1.5.5
Highlights:
- Bug fixes.
1.5.4
Highlights:
- Support Oracle12C for JDBC persistence.
- Bug fixes.
1.5.3
Highlights:
- Support "byte notation" (e.g. "K", "KB", "Gb", etc.) in broker XML configuration.
- CLI command to recalculate disk sync times.
- Bug fixes.
1.5.2
Highlights:
- Support for paging using JDBC.
- Bug fixes.
1.5.1
Highlights:
- Support outgoing connections for AMQP.
- Bug fixes.
1.5.0
Highlights:
- AMQP performance improvements.
- JUnit rule implementation so messaging resources like brokers can be easily configured in tests.
- Basic CDI integration.
- Store user's password in hash form by default.
1.4.0
Highlights:
- "Global" limit for disk usage.
- Detect and reload certain XML configuration changes at runtime.
- MQTT interceptors.
- Support adding/deleting queues via CLI.
- New "browse" security permission for clients who only wish to look at messages.
- Option to populate JMSXUserID.
- "Dual authentication" support to authenticate SSL-based and non-SSL-based clients differently.
1.3.0
Highlights:
- Better support of OpenWire features (e.g. reconnect, producer flow-control, optimized acknowledgements)
- SSL keystore reload at runtime.
- Initial support for JDBC persistence.
- Support scheduled messages on last-value queue.
1.2.0
Highlights:
- Improvements around performance
- OSGi support.
- Support functionality equivalent to all 5.x JAAS login modules including:
- Properties file
- LDAP
- SSL certificate
- "Guest"
1.1.0
Highlights:
- MQTT support.
- The examples now use the CLI programmatically to create, start, stop, etc. servers reflecting real cases used in production.
- CLI improvements. There are new tools to compact the journal and additional improvements to the user experience.
- Configurable resource limits.
- Ability to disable server-side message load-balancing.
1.0.0
Highlights:
- First release of the donated code-base as ActiveMQ Artemis!
- Lots of features for parity with ActiveMQ 5.x including:
- OpenWire support
- AMQP 1.0 support
- URL based connections
- Auto-create addresses/queues
- Jolokia integration