08f0c4aa46
Moving (copying) Admin User Guide CLI content to the Cloud Admin Guide as a part of the reorganization goal. This patch does not include any new or original content. This patch is Part 1 to create a new command- line client section for Admin Users in the Cloud Admin Guide, as disucssed in the User Guide Specialty team meetings. 1) Creating a new CLI section with cli.rst 2) Moving the non common files from user-guide-admin to admin-guide-cloud, along with their sub files. (Rename user-guide-admin files to user cli_ prefix in admin- guide-cloud.) manage_projects_users_and_roles.rst nova_cli_manage_projects_security.rst cli_manage_services.rst cli_manage_shares.rst cli_manage_flavors.rst cli_admin_manage_environment.rst cli_set_quotas.rst analyzing-log-files-with-swift-cli.rst cli_cinder_scheduling.rst 3) Attempt updates to several links. Change-Id: I97f4ced4f5033c7e0f3bf00c410288a75699d110 Implements: blueprint user-guides-reorganised
52 lines
2.0 KiB
ReStructuredText
52 lines
2.0 KiB
ReStructuredText
==================
|
|
Evacuate instances
|
|
==================
|
|
|
|
If a hardware malfunction or other error causes a cloud compute node to fail,
|
|
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 chooses the target host.
|
|
|
|
To preserve user data on the server disk, configure shared storage on the
|
|
target host. When you evacuate the instance, Compute detects whether shared
|
|
storage is available on the target host. Also, you must validate that the
|
|
current VM host is not operational. Otherwise, the evacuation fails.
|
|
|
|
#. To find a host for the evacuated instance, list all hosts:
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova host-list
|
|
|
|
#. Evacuate the instance. You can use the :option:`--password PWD` option
|
|
to pass the instance password to the command. If you do not specify a
|
|
password, the command generates and prints one after it finishes
|
|
successfully. The following command evacuates a server from a failed host
|
|
to HOST_B.
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova evacuate EVACUATED_SERVER_NAME HOST_B
|
|
|
|
The command rebuilds the instance from the original image or volume and
|
|
returns a password. The command preserves the original configuration, which
|
|
includes the instance ID, name, uid, IP address, and so on.
|
|
|
|
.. code-block:: console
|
|
|
|
+-----------+--------------+
|
|
| Property | Value |
|
|
+-----------+--------------+
|
|
| adminPass | kRAJpErnT4xZ |
|
|
+-----------+--------------+
|
|
|
|
#. To preserve the user disk data on the evacuated server, deploy Compute
|
|
with a shared file system. To configure your system, see
|
|
`Configure migrations <http://docs.openstack.org/admin-guide-cloud/compute-configuring-migrations.html>`_
|
|
in the `OpenStack Cloud Administrator Guide`. The
|
|
following example does not change the password.
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova evacuate EVACUATED_SERVER_NAME HOST_B --on-shared-storage
|