openstack-manuals/doc/admin-guide/source/compute-live-migration-usage.rst
OlgaGusarenko 2ddc924be8 [admin-cloud-guide] links update for Mitaka
Updates links to the versioned guides for mitaka
(to Install guides and Config Reference)

Change-Id: I2132ef1ecafd1f364dc9eb9a2d6420c95d22fadf
2016-04-01 21:28:48 +09:00

234 lines
5.1 KiB
ReStructuredText

.. _section_live-migration-usage:
=================
Migrate instances
=================
This section discusses how to migrate running instances from one
OpenStack Compute server to another OpenStack Compute server.
Before starting a migration, review the Configure migrations section.
:ref:`section_configuring-compute-migrations`.
.. note::
Although the :command:`nova` command is called :command:`live-migration`,
under the default Compute configuration options, the instances
are suspended before migration. For more information, see
`Configure migrations
<http://docs.openstack.org/mitaka/config-reference/compute/config-options.html>`_.
in the OpenStack Configuration Reference.
**Migrating instances**
#. Check the ID of the instance to be migrated:
.. code-block:: console
$ nova list
.. list-table::
:header-rows: 1
:widths: 46 12 13 22
* - ID
- Name
- Status
- Networks
* - d1df1b5a-70c4-4fed-98b7-423362f2c47c
- vm1
- ACTIVE
- private=a.b.c.d
* - d693db9e-a7cf-45ef-a7c9-b3ecb5f22645
- vm2
- ACTIVE
- private=e.f.g.h
#. Check the information associated with the instance. In this example,
``vm1`` is running on ``HostB``:
.. code-block:: console
$ nova show d1df1b5a-70c4-4fed-98b7-423362f2c47c
.. list-table::
:widths: 30 45
:header-rows: 1
* - Property
- Value
* - ...
OS-EXT-SRV-ATTR:host
...
flavor
id
name
private network
status
...
- ...
HostB
...
m1.tiny
d1df1b5a-70c4-4fed-98b7-423362f2c47c
vm1
a.b.c.d
ACTIVE
...
#. Select the compute node the instance will be migrated to. In this
example, we will migrate the instance to ``HostC``, because
``nova-compute`` is running on it:
.. list-table:: **nova service-list**
:widths: 20 9 12 11 9 30 24
:header-rows: 1
* - Binary
- Host
- Zone
- Status
- State
- Updated_at
- Disabled Reason
* - nova-consoleauth
- HostA
- internal
- enabled
- up
- 2014-03-25T10:33:25.000000
- -
* - nova-scheduler
- HostA
- internal
- enabled
- up
- 2014-03-25T10:33:25.000000
- -
* - nova-conductor
- HostA
- internal
- enabled
- up
- 2014-03-25T10:33:27.000000
- -
* - nova-compute
- HostB
- nova
- enabled
- up
- 2014-03-25T10:33:31.000000
- -
* - nova-compute
- HostC
- nova
- enabled
- up
- 2014-03-25T10:33:31.000000
- -
* - nova-cert
- HostA
- internal
- enabled
- up
- 2014-03-25T10:33:31.000000
- -
#. Check that ``HostC`` has enough resources for migration:
.. code-block:: console
# nova host-describe HostC
.. list-table::
:header-rows: 1
:widths: 14 14 7 15 12
* - HOST
- PROJECT
- cpu
- memory_mb
- disk_gb
* - HostC
- (total)
- 16
- 32232
- 878
* - HostC
- (used_now)
- 22
- 21284
- 442
* - HostC
- (used_max)
- 22
- 21284
- 422
* - HostC
- p1
- 22
- 21284
- 422
* - HostC
- p2
- 22
- 21284
- 422
- ``cpu``: Number of CPUs
- ``memory_mb``: Total amount of memory, in MB
- ``disk_gb``: Total amount of space for NOVA-INST-DIR/instances, in GB
In this table, the first row shows the total amount of resources
available on the physical server. The second line shows the currently
used resources. The third line shows the maximum used resources. The
fourth line and below shows the resources available for each project.
#. Migrate the instance using the :command:`nova live-migration` command:
.. code-block:: console
$ nova live-migration SERVER HOST_NAME
In this example, SERVER can be the ID or name of the instance. Another
example:
.. code-block:: console
$ nova live-migration d1df1b5a-70c4-4fed-98b7-423362f2c47c HostC
Migration of d1df1b5a-70c4-4fed-98b7-423362f2c47c initiated.
.. warning::
When using live migration to move workloads between
Icehouse and Juno compute nodes, it may cause data loss
because libvirt live migration with shared block storage
was buggy (potential loss of data) before version 3.32.
This issue can be solved when we upgrade to RPC API version 4.0.
#. Check that the instance has been migrated successfully, using
:command:`nova list`. If the instance is still running on ``HostB``,
check the log files at ``src/dest`` for ``nova-compute`` and
``nova-scheduler`` to determine why.