openstack-manuals/doc/common-rst/cli_nova_evacuate.rst
daz 498dfed60a [admin-guide-cloud] Convert compute sections to RST
1. Files converted:
- common/section_compute-configure-console.xml
- common/section_compute-configure-vnc.xml
- common/section_compute-configure-spice.xml
2. Moved cli_nova_evacuate.rst to the common-rst folder

Change-Id: I4963d799ae4f6f5528885aa15c90eeb56ad3322e
Implements: blueprint reorganise-user-guides
2015-08-04 11:14:28 +03:00

48 lines
1.8 KiB
ReStructuredText

:orphan:
==================
Evacuate instances
==================
If a cloud compute node fails due to a hardware malfunction or another
reason, you can evacuate instances to make them available again. You
can optionally include the target host on the :command:`evacuate`
command. If you omit the host, the scheduler determines the target
host.
To preserve user data on server disk, you must configure shared
storage on the target host. Also, you must validate that the current
VM host is down; otherwise, the evacuation fails with an error.
#. To list hosts and find a different host for the evacuated instance, run::
$ nova host-list
#. Evacuate the instance. You can pass the instance password to the
command by using the :option:`--password PWD` option. If you do not
specify a password, one is generated and printed after the command
finishes successfully. The following command evacuates a server
without shared storage from a host that is down to the specified
HOST_B::
$ nova evacuate EVACUATED_SERVER_NAME HOST_B
The instance is booted from a new disk, but preserves its
configuration including its ID, name, uid, IP address, and so on.
The command returns a password::
+-----------+--------------+
| Property | Value |
+-----------+--------------+
| adminPass | kRAJpErnT4xZ |
+-----------+--------------+
#. To preserve the user disk data on the evacuated server, deploy
OpenStack Compute with a shared file system. To configure your
system, see `Configure migrations
<http://docs.openstack.org/admin-guide-cloud/content/section_configuring-compute-migrations.html>`_
in OpenStack Cloud Administrator Guide. In the following example,
the password remains unchanged::
$ nova evacuate EVACUATED_SERVER_NAME HOST_B --on-shared-storage