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. Navigate to the Dedicated Virtual Machine Hosts list page. If you need help finding the list page, see Listing Dedicated Virtual Machine Hosts.
    2. Select the source dedicated virtual machine host.
    3. The instance details are displayed.
    4. Select the option you see:
      • Select More Actions, then select Migrate instance.
    5. Select the destination dedicated virtual machine host using the host list provide or by specifying the host OCID.
    6. Select 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.
    Note

    To monitor the migration process, select Work Requests. 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 --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 command line reference for Compute.

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    Use the UpdateInstance operation to update an instance.