openstack-manuals/doc/common/section_nova_cli_startstop.xml
Diane Fleming 5ab33d32b3 Clean up End User Guide - sentence style headings and other edits
Closes-Bug: #1249837

backport: none

Change-Id: Ie5068452b8596b0625e680ddd6f4eb6851e41927
author: diane fleming
2013-11-12 08:41:13 -06:00

45 lines
2.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 un-pause an instance</title>
<procedure xml:id="nova_cli_pause_unpause">
<step>
<para>To pause a server, run the following command:</para>
<screen><prompt>$</prompt> <userinput>nova pause <replaceable>SERVER</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>
<para>To un-pause the server, run the following
command:</para>
<screen><prompt>$</prompt> <userinput>nova unpause <replaceable>SERVER</replaceable></userinput> </screen>
</step>
</procedure>
</section>
<section xml:id="suspend_resume">
<title>Suspend and resume an instance</title>
<procedure xml:id="nova_cli_suspend_resume">
<para>Administrative users might want to suspend an infrequently
used instance or to perform system maintenance.</para>
<step>
<para>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.</para>
<para>To initiate a hypervisor-level suspend operation, run
the following command:</para>
<screen><prompt>$</prompt> <userinput>nova suspend <replaceable>SERVER</replaceable></userinput></screen>
</step>
<step>
<para>To resume a suspended server:</para>
<screen><prompt>$</prompt> <userinput>nova resume <replaceable>SERVER</replaceable></userinput></screen>
</step>
</procedure>
</section>
</section>