Event Store Blog

21.10.9 Release Notes

Written by Hayley Campbell | Dec 6, 2022 12:30:20 PM

We are pleased to announce the official release of EventStoreDB OSS & Commercial version 21.10.9 LTS.

This is an LTS release and will be supported until October 2023.
Read more about our versioning strategy here.

The complete changelog can be found here. If you need help planning your upgrade or want to discuss support, please contact us here.

 

 EventStoreDB 21.10.9 is available for the following operating systems:

  • Windows
  • Ubuntu 18.04
  • Ubuntu 20.04
  • CentOS 7 (Commercial version)
  • Amazon Linux 2 (Commercial version)
  • Oracle Linux 7 (Commercial version)

Additionally, you can find docker images including the experimental ARM64 image on Dockerhub.

Should I upgrade?

21.10.9 is a patch of the LTS version released in 2021. 21.10.x will be supported for 2 years from the initial release until version 23.10.0 is released in October 2023.

As always, we recommend that you upgrade to the latest LTS version, which is currently 22.10.x. However, if you are not upgrading to 22.10.x, then we highly recommend keeping EventStoreDB up to date with the latest LTS patch versions.

These patches can contain important fixes for cluster stability, performance, and the prevention of possible data-loss scenarios.

The upgrade can be done directly from any version of 20.10 and 21.10. There is no need to step through all of the versions, and the upgrade steps are the same as below.

20.10 is out of support

LTS versions of EventStoreDB are supported for a period of 2 years, which means that 20.10 is out of support following the release of 22.10.0.

As such, we recommend that you upgrade to either 22.10.0 or 21.10.9 if you are running version 20.10 or lower. You can upgrade directly to either of these versions from any version of 20.10.x.

There is a 2-month grace period where we will continue to provide support for 20.10.x to allow for upgrading to a newer version. This grace period will end in January 2023.

Upgrade Procedure

To upgrade a cluster from 20.10.x or 21.10.x,  a usual rolling upgrade can be done:

  • Pick a node (start with the follower nodes first, then choose the leader last).
  • Stop the node, upgrade it and start it.

Where Can I Get the Packages?

Downloads are available on our website.

The packages can also be installed using the following instructions.

Ubuntu 18.04/20.04 (via packagecloud)

curl -s https://packagecloud.io/install/repositories/EventStore/EventStore-OSS/script.deb.sh | sudo bash
sudo apt-get install eventstore-oss=21.10.9

Windows (via Chocolatey)

choco install eventstore-oss -version 21.10.9

Docker (via docker hub)

docker pull eventstore/eventstore:21.10.9-focal
docker pull eventstore/eventstore:21.10.9-bullseye-slim

Highlights for this release

This release mainly contains fixes that were made while working on the 22.10.0 release.

We did, however, backport the new dev certificates feature to make getting started easier on any currently supported LTS version of EventStoreDB.

Dev certificates

We have backported the new dev mode to make running a local dev instance of EventStoreDB easier. You can now run a secure single EventStoreDB node on localhost with the command:

./EventStore.ClusterNode.exe -–dev

This does a few things. It generates a self-signed dev certificate for the node if one isn’t already present, enables AtomPub over HTTP, enables system projections, and starts the secure EventStoreDB instance.

You can then browse to the admin UI or connect a gRPC client with very little hassle.

The benefit to this over insecure mode is that there are no extra configuration changes needed for your clients, and user management is enabled in secure mode.

If you wish to remove the dev certificates created by EventStoreDB, you can run the command:

./EventStore.ClusterNode.exe --remove-dev-certs

Fixes

  • Node not going into ready state due to synchronization bug in UserManagementService - EventStore#3599
  • Race condition when creating a persistent subscription to a stream at the same time as creating that stream. - EventStore#3601
  • Quick responses for authentication requests when the node is not ready - EventStore#3609
  • Edge cases in maxage read fast path. - EventStore#3646
  • Make MergeIndexes endpoint return proper result. - EventStore#3573
  • Incorrect error message when deleting a stream using gRPC.- EventStore#3583
  • Duplicate Persistent Subscriptions in the EventStoreDB UI - EventStore#3533

Documentation and previous releases notes

Documentation for EventStoreDB can be found here.
Previous release notes can be found here. 

Providing Feedback

If you encounter any issues, please don’t hesitate to open an issue on GitHub if there isn’t one already.

Additionally, there is a fairly active discuss channel, and an #eventstore channel on the DDD-CQRS-ES community.

If you have any questions that aren't covered in these release notes or the docs, please feel free to reach out.