Oracle Cloud Infrastructure Documentation

Managing On-Demand Reboot Migration for Dedicated Virtual Machine Hosts

You can migrate instances on an OCI dedicated virtual machine host on-demand using the console, CLI, or API. First, select an existing dedicated virtual machine host or set up a new dedicated virtual machine host to serve as the destination host for migrating instances. Then, using the desired method, start the migration process.

Warning

Reboot migration for Dedicated Virtual Machine Hosts is not supported across different availability domains.
Tip

Some downtime is associated with a dedicated virtual machine host as each instance must be stopped and rebooted on the new destination host. You can see the migration process using the work request feature.

  • To migrate a dedicated virtual machine host instance using the console, follow these steps.

    1. From the main menu, select Compute then Dedicated Virtual Machine Hosts.
    2. Select a compartment.
    3. Select the source dedicated virtual machine host.
    4. Select the instance to migrate.
    5. From the More Actions menu, select Migrate instance.
    6. Select the destination dedicated virtual machine host using the host list provide or by specifying the host OCID.
    7. Click Migrate.
    Important

    If the selected instance has local NVME on a dense I/O shape, the local storage is deleted during the migration process. In this case, a prompt is provided to confirm the deletion of local resources.

    To monitor the migration process, click Work Requests in the left menu. A job is created for the migration. The progress for that migration is shown in the console.

    When the migration is complete, a message is displayed in the console. The destination host shows the new instance, while the old instance doesn't show up in the source host.

    Repeat this process for each instance you want to migrate to the destination host.

  • Use the instance update command and required parameters to update an instance.

    oci compute instance update --instance-id <ocid1> --dedicated-vm-host-id <ocid1> --fault-domain FAULT-DOMAIN-# --from-json <file://path/to/file.json>

    file://path/to/file.json is the path to a JSON file that defines the instance details. For information about how to generate an example of the JSON file, see Advanced JSON Options.

    For a complete list of flags and variable options for the Compute Service CLI commands, see the Compute command line reference.

  • Use the UpdateInstance operation to update an instance.