Release Notes

20.10.5 Release Notes

Hayley Campbell  |  13 December 2021

We are pleased to announce the official release of EventStoreDB OSS & Commercial version 20.10.5 long-term support (LTS). This is a patch release that contains important fixes and changes from the 21.10.0 LTS release.

This LTS release will continue to be supported until October 2022. 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 20.10.5 is available for the following operating systems:

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

Where Can I Get the Packages?

Downloads are available on our website.

The packages can also be installed using the following instructions.

Ubuntu 16.04/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=20.10.5

Windows (via Chocolatey)

choco install eventstore-oss -version 20.10.5

Docker (via docker hub)

docker pull eventstore/eventstore:20.10.5-focal
docker pull eventstore/eventstore:20.10.5-buster-slim

Highlights for this release:

Support for Intermediate CA certificates

We have introduced support for intermediate CA certificates (EventStore#3176).

Steps on Linux:

sudo su eventstore --shell /bin/bash
dotnet tool install --global dotnet-certificate-tool
~/.dotnet/tools/certificate-tool add --file /path/to/intermediate.crt

Steps on Windows:

To import the certificate store, run the following PowerShell under the same account as EventStoreDB is running:

Import-Certificate -FilePath .\path\to\intermediate.crt -CertStoreLocation Cert:\CurrentUser\CA

To import the intermediate certificate in the `Local Computer` store, run the following as `Administrator`:

Import-Certificate -FilePath .\ca.crt -CertStoreLocation Cert:\LocalMachine\CA

Alternatively, you can right-click on the intermediate certificate, click Install (let windows choose the appropriate location - it should go under Intermediate Certification Authorities -> Certificates in the current user's certificate store.

We will be adding support to the es-gencer-cli to allow generating self-signed intermediate certificates shortly.

Fixes

Breaking Changes

Intermediate Certificates

We try our best not to introduce breaking changes in patch releases, but this is still possible as long as the breaking change still allows for a rolling upgrade. In this case, you may have to change the configuration on the nodes if you are making use of intermediate certificates.

If you are currently using intermediate certificates and rely on the AIA URL to build the full chain, the configuration will no longer work and will print the error “Failed to build the certificate chain with the node's own certificate up to the root“ on startup. If you see this error, please check out the docs or the PR for help on solving it.

Upgrade Procedure

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

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

There is no way to perform a rolling upgrade between version 5.x and version 20.10.5 due to changes in the replication protocols and the way nodes gossip and host elections.

As such, the upgrade process from 5.x is as follows:

      • Take down the cluster
      • Perform an in-place upgrade of the nodes, ensuring that the relevant configuration and certificates are set up
      • Bring the nodes back online and wait for them to stabilize

Documentation

Documentation for EventStoreDB can be found here.

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

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 Slack community


Photo of Hayley Campbell

Hayley Campbell Hayley is Engineering Team Lead for Event Store and works in our Netherlands office. She was part of the team back in 2015 and re-joined in 2019. In her spare time she enjoys playing games.