cadd25e9bc
Import the following documents from the admin guide [1]: - cli-manage-flavors.rst - cli-nova-evacuate.rst - cli-nova-manage-projects-security.rst - cli-nova-manage-services.rst - cli-nova-numa-libvirt.rst - cli-nova-specify-host.rst - cli-set-quotas.rst - cli-set-compute-quotas.rst - cli-os-migrate.rst - cli-os-migrate-cfg-ssh.rst - ts-no-emulator-x86-64.rst - ts-multipath-warn.rst - ts-failed-connect-vol-FC-SAN.rst - ts-failed-attach-vol-no-sysfsutils.rst - ts-failed-attach-vol-after-detach.rst - ts-vol-attach-miss-sg-scan.rst These were missed in the original import [2]. All 'ts-' files are merged into a single 'support-compute' document, which is already in-tree. [1] https://github.com/openstack/openstack-manuals/tree/stable/ocata/doc/admin-guide/source [2] https://review.openstack.org/#/c/477497/ Change-Id: Ifa0039e270e54ea2fb58ab18ce6724e5e8e061a1 Closes-Bug: #1708666
80 lines
2.5 KiB
ReStructuredText
80 lines
2.5 KiB
ReStructuredText
=================
|
|
Migrate instances
|
|
=================
|
|
|
|
When you want to move an instance from one compute host to another, you can use
|
|
the :command:`openstack server migrate` command. The scheduler chooses the
|
|
destination compute host based on its settings. This process does not assume
|
|
that the instance has shared storage available on the target host. If you are
|
|
using SSH tunneling, you must ensure that each node is configured with SSH key
|
|
authentication so that the Compute service can use SSH to move disks to other
|
|
nodes. For more information, see :ref:`cli-os-migrate-cfg-ssh`.
|
|
|
|
#. To list the VMs you want to migrate, run:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server list
|
|
|
|
#. Use the :command:`openstack server migrate` command.
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server migrate --live TARGET_HOST VM_INSTANCE
|
|
|
|
#. To migrate an instance and watch the status, use this example script:
|
|
|
|
.. code-block:: bash
|
|
|
|
#!/bin/bash
|
|
|
|
# Provide usage
|
|
usage() {
|
|
echo "Usage: $0 VM_ID"
|
|
exit 1
|
|
}
|
|
|
|
[[ $# -eq 0 ]] && usage
|
|
|
|
# Migrate the VM to an alternate hypervisor
|
|
echo -n "Migrating instance to alternate host"
|
|
VM_ID=$1
|
|
openstack server migrate $VM_ID
|
|
VM_OUTPUT=$(openstack server show $VM_ID)
|
|
VM_STATUS=$(echo "$VM_OUTPUT" | grep status | awk '{print $4}')
|
|
while [[ "$VM_STATUS" != "VERIFY_RESIZE" ]]; do
|
|
echo -n "."
|
|
sleep 2
|
|
VM_OUTPUT=$(openstack server show $VM_ID)
|
|
VM_STATUS=$(echo "$VM_OUTPUT" | grep status | awk '{print $4}')
|
|
done
|
|
nova resize-confirm $VM_ID
|
|
echo " instance migrated and resized."
|
|
echo;
|
|
|
|
# Show the details for the VM
|
|
echo "Updated instance details:"
|
|
openstack server show $VM_ID
|
|
|
|
# Pause to allow users to examine VM details
|
|
read -p "Pausing, press <enter> to exit."
|
|
|
|
.. note::
|
|
|
|
If you see the following error, it means you are either running the command
|
|
with the wrong credentials, such as a non-admin user, or the ``policy.json``
|
|
file prevents migration for your user::
|
|
|
|
ERROR (Forbidden): Policy doesn't allow compute_extension:admin_actions:migrate to be performed. (HTTP 403)``
|
|
|
|
.. note::
|
|
|
|
If you see the following error, similar to this message, SSH tunneling was
|
|
not set up between the compute nodes::
|
|
|
|
ProcessExecutionError: Unexpected error while running command.
|
|
Stderr: u Host key verification failed.\r\n
|
|
|
|
The instance is booted from a new host, but preserves its configuration
|
|
including instance ID, name, IP address, any metadata, and other properties.
|