Upgrades and Versioning in ArangoGraph

Select which version of ArangoDB you want to use within your ArangoGraph deployment and choose when to roll out your upgrades

Please note that this policy comes into effect in April 2023.

Release Definitions

The following definitions are used for release types of ArangoDB within ArangoGraph:

ReleaseIntroducesContains breaking changes
Major (X.y.z)Major new features and functionalitiesLikely large changes
Minor (x.Y.z)Some new features or improvementsLikely small changes
Patch (x.y.Z)Essential fixes and improvementsSmall changes in exceptional circumstances

Release Channels

When creating a deployment in ArangoGraph, you can select the minor version of ArangoDB that your deployment is going to use. This minor version is in the format Major.Minor and indicates the major and minor version of ArangoDB that is used in this deployment, for example 3.10 or 3.9.

To provide secure and reliable service, databases are deployed on the latest available patch version in the selected version. For example, if 3.10 is selected and 3.10.3 is the latest version of ArangoDB available for the 3.10 minor version, then the deployment is initially using ArangoDB 3.10.3.

Upgrades

Manual Upgrades

At any time, you can change the release channel of your deployment to a later release channel, but not to an earlier one. For example, if you are using 3.10 then you can change your deployment’s release channel to 3.11, but you would not be able to change the release channel to 3.9. See how to edit a deployment.

Upon changing your release channel, an upgrade process for your deployment is initiated to upgrade your running database to the latest patch release of your selected release channel. You can use this mechanism to upgrade your deployments at a time that suits you, prior to the forced upgrade when your release channel is no longer available.

Automatic Upgrades

Major Versions (X.y.z)

The potential disruption of a major version upgrade requires additional testing of any applications connecting to your ArangoGraph deployment. As a result, when a new major version is released on the ArangoGraph platform, an email is sent out to inform you of this release.

If the ArangoDB version that you are currently using is no longer available on the ArangoGraph platform, you are forced to upgrade to the next available version. Prior to the removal of the version, an email is sent out to inform you of this forced upgrade.

Minor Versions (x.Y.z)

Although minor upgrades are not expected to cause significant compatibility changes like major versions, they may still require additional planning and validation.

This is why minor upgrades are treated in the same manner as major upgrades within ArangoGraph. When a new minor version is released on the ArangoGraph platform, an email is sent out to inform you of this release.

If the ArangoDB version that you are currently using is no longer available on the ArangoGraph platform, you are forced to upgrade to the next available version. Prior to the removal of the version, an email is sent out to inform you of this forced upgrade.

Patch Versions (x.y.Z)

Upgrades between patch versions are transparent, with no significant disruption to your applications. As such, you can expect to be automatically upgraded to the latest patch version of your selected minor version shortly after it becomes available in ArangoGraph.

ArangoGraph aims to give approximately one week’s notice prior to upgrading your deployments to the latest patch release. Although in exceptional circumstances (such as a critical security issue) the upgrade may be triggered with less than one week’s notice. The upgrade is carried out automatically. However, if you need the upgrade to be deferred temporarily, contact the ArangoGraph Support team to request that.