Skip to main content
Version: v4

How to Live Migrate Instances

Introduction​

This guide provides instructions for cloud administrators on how to migrate instances through the dashboard. Migration is the process that a server administrator can move instances to a different host. Live migration keeps instances in an active state during the migration process. This process is useful when applications need to remain running and shutting down an instance is not possible or advantageous.

Prerequisite​

Live migrating instances requires having a user account with the administrator role. This is typically the account called admin.

Determining an Instance's Parent Host​

Go to Admin -> Compute -> Instances. The list shows each instance's project, host, IP address, and status.

Admin instances list in Horizon

Figure 1: Summary of Instances

Migrate Instance​

In the same list, open the actions menu at the end of the instance's row and choose Live Migrate Instance.

Instance actions menu in Horizon

Figure 2: Live Migrate action

Live Migrate dialog in Horizon

Figure 3: Live Migration Options

  • Current Host: read-only, the host it runs on now.
  • New Host: leave on Automatically schedule new host, or pick one.
  • Disk Over Commit and Block Migration: leave both unchecked.

Click Submit.

The instance's Status changes while it migrates, and its Host updates when the migration completes.

OpenMetal uses shared storage through Ceph, so block migration is not required.