4bf765758c
This patch works several files that were not in common use back into the documents they should live with. The intended end result of this activity is to make common as lean as possible so it can be more easily translated. Also: Don't include configdrive table in user-guide since it's not relevant for audience Change-Id: Iacd5c68c639e60e8c711cb18351543e477444299
76 lines
4.0 KiB
XML
76 lines
4.0 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_stop_start">
|
|
<title>Stop and start an instance</title>
|
|
<para>Use one of the following methods to stop and start an
|
|
instance.</para>
|
|
<section xml:id="pause_server">
|
|
<title>Pause and unpause an instance</title>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>To pause an instance, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova pause <replaceable>INSTANCE_NAME</replaceable></userinput> </screen>
|
|
<para>This command stores the state of the VM in RAM. A paused
|
|
instance continues to run in a frozen state.</para></listitem>
|
|
<listitem><para>To unpause the instance, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova unpause <replaceable>INSTANCE_NAME</replaceable></userinput> </screen>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
<section xml:id="suspend_resume">
|
|
<title>Suspend and resume an instance</title>
|
|
<itemizedlist>
|
|
<para>Administrative users might want to suspend an instance if
|
|
it is infrequently used or to perform system maintenance. When
|
|
you suspend an instance, its VM state is stored on disk, all
|
|
memory is written to disk, and the virtual machine is stopped.
|
|
Suspending an instance is similar to placing a device in
|
|
hibernation; memory and vCPUs become available to create other
|
|
instances.</para>
|
|
<listitem>
|
|
<para>To initiate a hypervisor-level suspend operation, run
|
|
the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova suspend <replaceable>INSTANCE_NAME</replaceable></userinput></screen>
|
|
</listitem>
|
|
<listitem>
|
|
<para>To resume a suspended instance, run the following
|
|
command:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova resume <replaceable>INSTANCE_NAME</replaceable></userinput></screen>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
<section xml:id="shelve_server">
|
|
<title>Shelve and unshelve an instance</title>
|
|
<para>Shelving is useful if you have an instance that you are not using, but would like retain in
|
|
your list of servers. For example, you can stop an instance at the end of a work week, and
|
|
resume work again at the start of the next week. All associated data and resources are kept;
|
|
however, anything still in memory is not retained. If a shelved instance is no longer needed,
|
|
it can also be entirely removed.</para>
|
|
<para>You can complete the following shelving tasks:</para>
|
|
<variablelist>
|
|
<varlistentry><term>Shelve an instance</term>
|
|
<listitem><para>Shuts down the instance, and stores it together with associated data and resources (a snapshot
|
|
is taken if not volume backed). Anything in memory is lost. Use the following
|
|
command:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova shelve <replaceable>SERVERNAME</replaceable></userinput></screen>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Unshelve an instance</term>
|
|
<listitem><para>Restores the instance:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova unshelve <replaceable>SERVERNAME</replaceable></userinput></screen>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Remove a shelved instance</term>
|
|
<listitem><para>Removes the instance from the server; data and resource associations are deleted. If an
|
|
instance is no longer needed, you can move that instance off the hypervisor in order to
|
|
minimize resource usage:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova shelve-offload <replaceable>SERVERNAME</replaceable></userinput></screen>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
</section>
|