Migrate an instance

Considerations

• Migrating an instance causes a brief service interruption that lasts about 30 seconds.

• Unlike other editions, ApsaraDB MyBase for MySQL Master-replica Edition instances cannot be migrated to a host in a different zone.

• Consider the following risks when you migrate an instance to a different zone:

  • The virtual IP address (VIP) of the instance changes. Use the instance endpoint in your application instead of its IP address.

  • If you do not clear the client-side cache promptly, data writes may fail while data reads remain functional.

  • If a Data Transmission Service (DTS) task is running on the instance, you must restart the task after the migration is complete.

Procedure

1. Log in to the ApsaraDB for MyBase console.

2. In the upper-left corner of the page, select the target region.

3. In the navigation pane on the left, click Instances > MySQL.

4. For the instance you want to migrate, click More > Migrate in the Actions column.

5. Configure the following parameters:

   Parameter	Description
   Destination zone	Select the destination zone from the drop-down list. Note This parameter appears only for ApsaraDB MyBase for MySQL High-availability Edition, ApsaraDB MyBase for PostgreSQL, and ApsaraDB MyBase for Redis instances, which support cross-zone migration. The drop-down list displays all zones where the hosts in the dedicated cluster reside.
   vSwitch	Select a vSwitch from the drop-down list. If no vSwitch is available, click Create VSwitch to create one in the destination zone. Note This parameter appears only when you migrate a primary instance to a different zone.
   Destination host	Select the destination host. Note This parameter is optional. If you do not specify a host, the system migrates the instance to a host in the specified zone.
   Migration time	Immediate Maintenance Window 02:00-06:00 Specified Time

   Note You can migrate the primary instance, the secondary instance, or both, based on your business needs. If you choose to migrate only the primary instance, configure only the parameters for the primary instance.

6. Click OK.