Installation: Upgrading to a New Version

Upgrading

Upgrading a RavenDB instance to a new version is very simple. To do so:

1. Download a distribution package from here.

2. Shut RavenDB Server down.

   • for a service (or daemon) - shutdown before upgrading.
   • for a console application - execute a 'shutdown' command in the RavenDB CLI.

3. Remove old RavenDB binaries

   • Avoid deleting your actual data, contained in folders like RavenData.
   • Avoid overwriting your configuration files, e.g. settings.json.
   • Avoid deleting your certificate file (ending with .pfx or .pem).
   • For additional information see the certificate page.
   • These steps are strictly necessary when updating to version 5.1.
     To update to lower versions, overriding the old binaries may be sufficient - although removing them is recommended.

4. Copy the new binaries.

5. Restart the server.

High Availability & Cluster

For zero downtime during a version upgrade, please upgrade a single cluster node at a time and wait until it becomes a fully fledged node (either Member, Leader, or Watcher).
The state of the node can be checked in Cluster View.

Upgrading Data Files

While upgrade RavenDB, no special action is needed to migrate the stored data.
However, sometimes our adjustments require changing the file format ("schema version").
If RavenDB finds during startup that the stored database uses an old format, it will automatically perform this kind of migration.

Remarks