Using a Amazon CloudFormation template to update the engine version of your Neptune DB Cluster - Amazon Neptune
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Using a Amazon CloudFormation template to update the engine version of your Neptune DB Cluster

You can re-use the Neptune Amazon CloudFormation template that you used to create your Neptune DB Cluster to update its engine version.

Neptune engine version upgrades can be minor or major. Using an Amazon CloudFormation template can help with major version upgrades, which often contain significant changes. Since major version upgrades can contain database changes that are not backward-compatible with existing applications, you may also need to make changes to your applications when upgrading. Always test before upgrading, and we strongly recommend that you always create a manual snapshot of your DB cluster before upgrading.

Note that you have to do a separate engine upgrade for each major version. You can't skip a major version and upgrade directly to the major version following.

Prior to May 17, 2023, if you used the Neptune Amazon CloudFormation stack to upgrade your engine version, it simply created a new, empty DB cluster in place your current one. As of May 17, 2023, however, the Neptune Amazon CloudFormation stack now supports in-place engine upgrades that preserve your existing data.

Note

If you are using the Amazon Cloud Development Kit (Amazon CDK), ensure that the Amazon CDK version being used is 2.82.0 or later. Versions prior to 2.82.0 do not support in-place Neptune engine upgrades.

For a major version upgrade, your template should set the following properties in DBCluster:

  • DBClusterParameterGroup (Custom or Default)

  • DBInstanceParameterGroupName

  • EngineVersion

Similarly, for DBInstances attached to DBCluster you should set:

  • DBParameterGroup (Custom/Default)

Make sure that all your parameter groups are defined in the template, whether they are default or custom.

In the case of a custom parameter group, make sure that the family of your existing custom parameter group is compatible with the new engine version. Engine versions earlier than 1.2.0.0 used parameter group family neptune1, whereas engine releases from 1.2.0.0 forward require parameter group family neptune1.2. See Amazon Neptune parameter groups for more information.

For major engine version upgrades, specify a parameter group with the appropriate family in the DBCluster DBInstanceParameterGroupName field.

A default parameter group should be upgraded to one that is compatible with the new engine version.

Note that Neptune automatically reboots DB instances after an engine upgrade.