64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
52 lines
2.8 KiB
XML
52 lines
2.8 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="nova_cli_evacuate">
|
|
<title>Evacuate instances</title>
|
|
<para>If a cloud compute node fails due to a hardware malfunction
|
|
or another reason, you can evacuate instances to make them
|
|
available again.</para>
|
|
<para>You can choose evacuation parameters for your use case.</para>
|
|
<para>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.</para>
|
|
<procedure xml:id="evacuate_shared">
|
|
<title>To evacuate your server</title>
|
|
<step>
|
|
<para>To find a different host for the evacuated instance,
|
|
run the following command to lists hosts:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova host-list</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>You can pass the instance password to the command by
|
|
using the <literal>--password <pwd></literal>
|
|
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:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova evacuate <replaceable>evacuated_server_name</replaceable> <replaceable>host_b</replaceable></userinput> </screen>
|
|
<para>The command evacuates an instance from a down host
|
|
to a specified host. 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:</para>
|
|
<screen><computeroutput><?db-font-size 70%?>+-----------+--------------+
|
|
| Property | Value |
|
|
+-----------+--------------+
|
|
| adminPass | kRAJpErnT4xZ |
|
|
+-----------+--------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>To preserve the user disk data on the evacuated
|
|
server, deploy OpenStack Compute with shared
|
|
filesystem. To configure your system, see <link
|
|
xlink:href="http://docs.openstack.org/trunk/openstack-compute/admin/content/configuring-migrations.html"
|
|
>Configure migrations guide</link>. In this
|
|
example, the password remains unchanged.</para>
|
|
<screen><prompt>$</prompt> <userinput>nova evacuate <replaceable>evacuated_server_name</replaceable> <replaceable>host_b</replaceable> --on-shared-storage</userinput> </screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|