371f556463
Closes-Bug: #1250515 author: diane fleming Change-Id: Ib1755a3e10ddd348d0575b3c5e6aa1660d5f612e backport: none
54 lines
2.9 KiB
XML
54 lines
2.9 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">
|
|
<step>
|
|
<para>To find a different host for the evacuated instance,
|
|
run this command to list 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 file
|
|
system. To configure your system, see <link
|
|
xlink:href="http://docs.openstack.org/trunk/config-reference/content/configuring-openstack-compute-basics.html#section_configuring-compute-migrations"
|
|
>Configure migrations</link> in
|
|
<citetitle>OpenStack Configuration
|
|
Reference</citetitle>. 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>
|