Working with replication engine versions - Amazon Database Migration Service
Upgrading the engine version using the consoleUpgrading the engine version using the Amazon CLI
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).

Working with replication engine versions

The replication engine is the core Amazon DMS software that runs on your replication instance and performs the migration tasks you specify. Amazon periodically releases new versions of the Amazon DMS replication engine software, with new features and performance improvements. Each version of the replication engine software has its own version number, to distinguish it from other versions.

When you launch a new replication instance, it runs the latest Amazon DMS engine version unless you specify otherwise. For more information, see Working with an Amazon DMS replication instance.

If you have a replication instance that is currently running, you can upgrade it to a more recent engine version. (Amazon DMS doesn't support engine version downgrades.) For more information about replication engine versions, see Amazon DMS release notes.

Upgrading the engine version using the console

You can upgrade an Amazon DMS replication instance using the Amazon Web Services Management Console.

To upgrade a replication instance using the console

  1. Open the Amazon DMS console at https://console.amazonaws.cn/dms/v2/.

  2. In the navigation pane, choose Replication instances.

  3. Choose your replication engine, and then choose Modify.

  4. For Engine version, choose the version number you want, and then choose Modify.

Note

We recommend that you stop all tasks before upgrading the Replication Instance. If you don't stop the task, Amazon DMS will stop the task automatically before the upgrade. If you stop the task manually, you will need to start the task manually after the upgrade is complete. Upgrading the replication instance takes several minutes. When the instance is ready, its status changes to available.

Upgrading the engine version using the Amazon CLI

You can upgrade an Amazon DMS replication instance using the Amazon CLI, as follows.

To upgrade a replication instance using the Amazon CLI

  1. Determine the Amazon Resource Name (ARN) of your replication instance by using the following command.

    aws dms describe-replication-instances \
--query "ReplicationInstances[*].[ReplicationInstanceIdentifier,ReplicationInstanceArn,ReplicationInstanceClass]"

    In the output, take note of the ARN for the replication instance you want to upgrade, for example: arn:aws:dms:us-east-1:123456789012:rep:6EFQQO6U6EDPRCPKLNPL2SCEEY

  2. Determine which replication instance versions are available by using the following command.

    aws dms describe-orderable-replication-instances \
--query "OrderableReplicationInstances[*].[ReplicationInstanceClass,EngineVersion]"

    In the output, note the engine version number or numbers that are available for your replication instance class. You should see this information in the output from step 1.

  3. Upgrade the replication instance by using the following command.

    aws dms modify-replication-instance \
--replication-instance-arn arn \
--engine-version n.n.n

    Replace arn in the preceding with the actual replication instance ARN from the previous step.

    Replace n.n.n with the engine version number that you want, for example: 3.4.5

Note

Upgrading the replication instance takes several minutes. You can view the replication instance status using the following command.

aws dms describe-replication-instances \
--query "ReplicationInstances[*].[ReplicationInstanceIdentifier,ReplicationInstanceStatus]"

When the replication instance is ready, its status changes to available.