Cluster Standby Change Log

1.52.0 (unreleased)

1.51.0 (2026-04-29)

  • Terminate the standby with an error if a snapshot supplied by the cluster does not exist as a recording in the cluster node’s archive. This can occur if users are cleaning up archive recordings manually.

  • Changed clusterStandby.Context.clusterReplayInitialLogPosition default value to CLUSTER_REPLAY_LATEST_LOG_POSITION. This means the standby will initialize from the most recent snapshot by default.

  • Correctly resolve ClusterStandby.Context.clusterReplayInitialLogPosition so that the appropriate snapshot will be downloaded by the standby from the cluster.

  • Use the property aeron.cluster.standby.cycle.threshold when setting duty cycle time threshold rather than the property for the consensus module (aeron.cluster.cycle.threshold).

  • Upgrade to Aeron 1.51.0.

  • Upgrade to Agrona 2.4.1.

  • Upgrade to SBE 1.38.1.

  • Upgrade to Gradle 9.5.0.

  • Upgrade to ByteBuddy 1.18.8.

  • Upgrade to Shadow 9.4.1.

  • Upgrade to Versions 0.54.0.

1.50.4 (2026-03-20)

  • Upgrade to Aeron 1.50.4.

  • Upgrade to Gradle 9.4.1.

  • Upgrade to Shadow 9.4.0.

1.50.3 (2026-03-13)

  • Upgrade to Aeron 1.50.3.

  • Upgrade to Gradle 9.4.0.

  • Upgrade to ByteBuddy 1.18.7.

  • Upgrade to Mockito 5.23.0.

  • Upgrade to Shadow 9.3.2.

1.50.2 (2026-02-27)

  • Upgrade to Aeron 1.50.2.

  • Upgrade to ByteBuddy 1.18.5.

  • Upgrade to JUnit 6.0.3.

  • Upgrade to Checkstyle 12.3.1.

  • Upgrade to Gradle 9.3.1.

1.50.1 (2026-02-06)

  • Use the property aeron.cluster.standby.cycle.threshold when setting duty cycle time threshold rather than the property for the consensus module (aeron.cluster.cycle.threshold).

  • Upgrade to Aeron 1.50.1.

1.50.0 (2026-01-16)

  • Remove use of deprecated TRANSITION_MODULE_CONTROL_TOGGLE counter in sample code and transition module.

  • Add support for configuring the cluster clock via the system property aeron.cluster.clock. The property’s value must be a fully qualified class name (e.g. io.aeron.cluster.NanosecondClusterClock).

  • Upgrade to Aeron 1.50.0.

  • Upgrade to Agrona 2.4.0.

  • Upgrade to SBE 1.37.1.

  • Upgrade to ByteBuddy 1.18.3.

  • Upgrade to JUnit 6.0.2.

  • Upgrade to Mockito 5.21.0.

  • Upgrade to Shadow 9.3.1.

  • Upgrade to Checkstyle 12.3.0.

  • Upgrade to Gradle 9.2.1.

1.49.3 (2025-12-15)

1.49.2 (2025-11-24)

  • Mark file updates and alignment with the Aeron API changes.

  • Update duty cycle counter names so the labels to not conflict with the counters from the Standby Agent.

  • Add version info to Standby agent logger and enable all Aeron loggers when it is used.

  • Upgrade to Aeron 1.49.2.

  • Upgrade to Agrona 2.3.2.

  • Upgrade to SBE 1.36.2.

  • Upgrade to ByteBuddy 1.17.8.

  • Upgrade to ASM 9.9.

  • Upgrade to JUnit 6.0.1.

  • Upgrade to Checkstyle 12.1.1.

1.49.1 (2025-11-01)

  • Use progress timeout instead of response timeout for checking progress and state transitions.

  • Treat error to transition to CONSENSUS state as terminal, i.e. shutdown the Standby node.

  • Upgrade to Aeron 1.49.1.

1.49.0 (2025-10-03)

  • Change logging agent package to io.aeron.standby.agent.

  • Update tests to use the AuthorisationService from Aeron that allows Standby and update the docs to tell people about authorising calls required for standby.

  • Update to cater for changes for sessionInfo added to Cluster Session.

  • Upgrade to Aeron 1.49.0.

  • Upgrade to Agrona 2.3.0.

  • Upgrade to SBE 1.36.0.

  • Upgrade to ByteBuddy 1.17.7.

  • Upgrade to JUnit 5.13.4.

  • Upgrade to Mockito 5.20.0.

  • Upgrade to Shadow 9.2.2.

  • Upgrade to Versions 0.53.0.

  • Upgrade to Checkstyle 11.1.0.

1.48.10 (2025-11-21)

1.48.9 (2025-11-11)

  • Enable all Aeron loggers when aeron-sequencer-agent.jar is used, i.e. support all Aeron log events.

  • Upgrade to Aeron 1.48.9.

  • Upgrade to Shadow 9.2.2.

1.48.7 (2025-11-01)

1.48.6 (2025-08-08)

1.48.5 (2025-07-21)

1.48.4 (2025-06-27)

  • Upgrade to Aeron 1.48.4.

  • Upgrade to Agrona 2.2.4.

  • Upgrade to SBE 1.35.6.

  • Upgrade to ByteBuddy 1.17.6.

  • Upgrade to Shadow 8.3.7.

  • Upgrade to JUnit 5.13.2.

  • Upgrade to Checkstyle 10.26.0.

  • Upgrade to jgit 7.3.0.202506031305-r.

1.48.3 (2025-06-20)

  • Add a cool down period that will occur whenever an exception is detected within the main event loop of the ClusterStandbyAgent. This will prevent rapid resource construction when faced with an unexpected issue.

  • Upgrade to Aeron 1.48.3.

  • Upgrade to Agrona 2.2.3.

  • Upgrade to SBE 1.35.5.

1.48.2 (2025-06-12)

1.48.1 (2025-06-06)

1.48.0 (2025-06-03)

  • [Breaking] Maven coordinates changed, i.e. groupId was changed to io.aeron.premium.standby

    • aeron-cluster-standby - main module.

      <groupId>io.aeron.premium.standby</groupId>
<artifactId>aeron-cluster-standby</artifactId>
<version>1.48.0</version>

    • aeron-cluster-standby-agent - logging agent, previously was called aeron-extensions-agent.

      <groupId>io.aeron.premium.standby</groupId>
<artifactId>aeron-cluster-standby-agent</artifactId>
<version>1.48.0</version>

    • aeron-cluster-standby-samples - code samples.

      <groupId>io.aeron.premium.standby</groupId>
<artifactId>aeron-cluster-standby-samples</artifactId>
<version>1.48.0</version>

1.47.7 (2025-08-08)

1.47.5 (2025-05-09)

1.47.4 (2025-03-14)

  • Fix duplicate classes in aeron-extensions-agent.jar.

  • Upgrade to Aeron 1.47.4.

1.47.3 (2025-02-14)

1.47.2 (2025-01-30)

1.47.1 (2025-01-29)

  • Upgrade to Aeron 1.47.1.

  • Upgrade to ByteBuddy 1.16.1.

  • Upgrade to Versions 0.52.0.

1.47.0 (2025-01-17)

  • [Breaking] Agrona upgrade brings breaking changes. See 2.0.0 release notes.

    Note: --add-opens java.base/jdk.internal.misc=ALL-UNNAMED JVM option must be specified in order to run Aeron. In addition to --add-opens java.base/java.util.zip=ALL-UNNAMED that is required to running the Aeron Archive.

  • Await for log replay to start while in SETUP_LOG state, i.e. ensure that replay starts and the Archive start recording data. Ensure that remote Archive’s errors are raised on the Standby node. Use proper alias for the recording and replay streams.

  • Remove remaining dynamic join APIs.

  • Print configuration on start if aeron.print.configuration=true is set.

  • Fix challenge response authentication for snapshot notification.

  • Do not try to send notifications of standby snapshots to nodes that do not currently have a resolvable address.

  • Ensure that sessions from snapshots are correctly loaded in standby.

  • Upgrade to Aeron 1.47.0.

  • Upgrade to Agrona 2.0.1.

  • Upgrade to SBE 1.34.1.

  • Upgrade to ByteBuddy 1.15.11.

  • Upgrade to JUnit 5.11.4.

  • Upgrade to Mockito 5.15.2.

  • Upgrade to Checkstyle 10.21.1.

  • Upgrade to Gradle 8.11.1.

  • Upgrade to Shadow 8.3.5.

1.46.1 (2024-10-10)

  • Add overload and documentation to better explain transition operation behaviour.

  • Ensure that sessions from snapshots are correctly loaded in standby.

  • Use BitUtil.generateRandomisedId() to generate unique replay session-id.

  • Upgrade to Aeron 1.46.5.

  • Upgrade to Agrona 1.23.1.

  • Upgrade to SBE 1.33.1.

1.46.0 (2024-08-25)

  • [Breaking] JDK 17 is required for compiling and running!

  • Ensure cluster mark file is closed during reset.

  • Add PremiumClusterTool operation for resetting a Cluster Standby by moving the recording log out of the way.

  • Debounce cluster standby control toggle signals.

  • Add `errors' command to Premium Cluster tool to display errors from the Transition Module and Standby markfiles

  • Fix the `describe-transition' command so it reads from the correct directories.

  • Use alternative implementation for next session id that avoid conflicts between standbys.

  • Rename counters to have consistent case with similar counters

  • Fix closed session leak in ClusterStandby.

  • Close sessions after transition.

  • Upgrade to Aeron 1.46.0.

  • Upgrade to Agrona 1.23.0.

  • Upgrade to SBE 1.33.0.

  • Upgrade to Gradle 8.10.

  • Upgrade to ByteBuddy 1.15.0.

  • Upgrade to Shadow 8.3.0.

  • Upgrade to bnd 7.0.0.

  • Upgrade to Mockito 5.12.0.

  • Upgrade to AsciiDoctor 2.5.13.

  • Upgrade to JGit 6.10.0.202406032230-r.

  • Force ASM 9.7.

1.44.2 (2024-05-21)

  • Fix a bug where sessions aren’t closed (e.g., due to inactivity) after TransitionModule transitions from STANDBY to CONSENSUS due to some missing state.