Migration Guide 2.6.x to 2.7.x

The license for using Akka in production has been changed to Business Source License v1.1. Why We Are Changing the License for Akka explains the reasons and a detailed FAQ is available to answer many of the questions that you may have about the license change.

Akka 2.7.x is binary backwards compatible with 2.6.x with the ordinary exceptions listed in the Binary Compatibility Rules.

No configuration changes are needed for updating an application from Akka 2.6.x to 2.7.x.

Rolling updates of Akka Cluster from Akka 2.6.x to 2.7.x is fully supported.

No deprecated features or APIs have been removed in Akka 2.7.x.

Dependency updates

Jackson

The Jackson dependency for Serialization with Jackson has been updated to 2.13.4 in Akka 2.7.0. That bump includes many fixes and changes to Jackson, but it should not introduce any incompatibility in serialized format.

Default configuration changes

Persistence plugin-dispatcher

The default plugin-dispatcher for Akka Persistence plugins has been changed to use the ordinary akka.actor.default-dispatcher.

Previously it used a PinnedDispatcher, which wasn’t a good default choice and most plugins have already overridden that setting.

Akka Diagnostics

The extension “Akka Enhancements: Diagnostics Recorder” with the major version 1.x is only compatible up until 2.6.x.

For Akka 2.7 and beyond use 2.x of akka-diagnostics which is now maintained under Akka Diagnostics.