Release Notes

EventStoreDB 4.0.4 Release Candidate 1

Hayley Campbell  |  19 December 2017

The first release candidate for Event Store 4.0.4 is now available! It is available for the following operating systems:

  • Windows (via Chocolatey)
  • Ubuntu 16.04 (via packagecloud)
  • Ubuntu 14.04 (via packagecloud)

While there are a number of changes and fixes in this version, the main focus has been on improving indexes.

Index Improvements

Loading indexes have a large impact on the startup times of Event Store. This is due to two processes that happen every time Event Store starts :

  1. Index verification - this hashes each index file and verifies it against the hash stored in its footer. Since this needs to read through the entire file, this will take longer for larger files and indexes.
  2. Loading and caching midpoints - this happens at the same time as the verification above. Event Store caches midpoints from the index files into memory. This makes searching the index much quicker.

The improvements in this release focus specifically on these two processes.

Firstly, index verification can now be disabled. This means that the entire index file no longer needs to be read on startup. Some extra checks have instead been added to check for possible corruption of the indexes. If any potential corruption is discovered while running, a file is created to indicate that verification must be run at the next startup. If there is anything wrong, then the indexes will be rebuilt as per usual.

Secondly, midpoints are now written to the footer of new index files. This allows Event Store to load up the midpoints without recalculating them on every run.

These improvements won’t always be immediately apparent. There are some steps required to get the benefits of these changes :

  1. Run Event Store with index verification disabled with the --skip-index-verify option.
  2. The index files need to be upgraded to the latest version. This will happen naturally as more data is written to Event Store and the index files are upgraded during merges. If you would like to force the midpoints to be cached, you can do this by rebuilding all your indexes upfront.

Replication changes

This release also changes the way the index is updated with a new write, as well as how events are read from $all.

Previously the index was updated as soon as possible after an event had been written to disk on a node. This means that an event could be added to the index before it has been replicated to other nodes in the cluster. Consequently if a client were to read or subscribe to that stream, it could receive an event that does not yet exist in the entire cluster.

As an example, consider the following scenario :

  1. Take a 3 node cluster with nodes A, B, and C. A is the current master node.
  2. A client subscribes to StreamA on node A.
  3. The network between node A and the others goes down. This means that node A can no longer replicate data to the two slaves.
  4. An event is written to StreamA on node A and is written to disk. The client that sent the event will get a Commit Timeout.
  5. The client receives the event and acts upon it.
  6. Node A goes down completely.

Because the event was never replicated to any of the other nodes, that event no longer exists. If that event is not retried, then our client may have acted on an event that essentially never happened.

Another common result of the above scenario is the client resubscribing to one of the other nodes, but the position it tries to subscribe from is no longer valid. This causes the subscription to throw errors, and means that the client will need to resubscribe from a known valid position.

If you have experienced issues similar to this, we would value your feedback on this release candidate.


We are still working on improvements for projections and aiming to make them more stable and reliable.

There are two fixes in this RC for projections not starting up correctly, as well as a performance improvement for multi-stream projections. Additionally, the issue where projections may be deleted if they take a few minutes to start up has been fixed.

Event Store 4.0.4 RC 1 release notes

Event Store Server

  • #1447 - (All Platforms) - Add gzip & deflate support for Accept-Encoding HTTP header
  • #1448 - (All Platforms) - Prevent reads of events that have not been replicated
  • #1461 - (All Platforms) - Add traverse in scavenge to count the new chunk size in memory
  • #1469 - (All Platforms) - Ensure CurrentVersion is set when forwarding writes
  • #1476 - (All Platforms) - Make PasswordChangeNotificationReader try again in case of a read error
  • #1485 - (All Platforms) - Allow the user to skip verification of index integrity on startup
  • #1491 - (All Platforms) - Cache midpoints in Ptable footer for faster startup times
  • #1504 - (All Platforms) - Fix an issue during the index upgrade from PTable V1 to V2 or later that may cause entries to be lost
  • #1510 - (All Platforms) - Fix case where master node may crash after 2 consecutive elections
  • #1515 - (All Platforms) - Fix bug where a forwarded request’s Content-Type was omitted if Content-Length is 0
  • #1520 - (All Platforms) - Fix for scavenged files remaining at 256MB
  • #1522 - (All Platforms) - Add option to set initial reader count on TFChunk

Event Store Projections

  • #1460 - (All Platforms) - Use current epoch (epoch-0) when starting up projections - fix projections stuck on startup
  • #1465 - (All Platforms) - Stop reading the order stream once the checkpoint has passed
  • #1466 - (All Platforms) - Prevent 2 instances of ProjectionCoreCoordinator & its subcomponents from running in parallel
  • #1484, #1489 - (All Platforms) - Expire long-running queries and make expiration configurable and prevent projections from being expired if they haven’t loaded state

Event Store Persistent Subscriptions

  • #1471 - (All Platforms) - Convert timeout of 0 to no timeout when loading config on startup

Where can I get the release candidate 1 packages?

The alpha packages can be installed using the following instructions.

Ubuntu 14.04/16.04 (via packagecloud)

curl -s | sudo bash
sudo apt-get install eventstore-oss=4.0.4-rc1

Windows (via Chocolatey)

choco install eventstore-oss -version 4.0.4-rc1 -pre

Client Packages (via Nuget)

Install-Package EventStore.Client -Pre

How do I provide feedback?

We appreciate any feedback via either GitHub Issues or forum.

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.