openstack/openstack-manuals
Code Issues Proposed changes

Controlled shutdown for rescue, shelve, and resize

Browse Source 
Rescue, shelve, and resize operations now give the guest OS
a chance to shutdown cleanly before powering off the VM.

The shutdown behavior is defined by the shutdown_timeout
conf parameter

Change-Id: I45699daaf1ed4b5e800f80563cd23f9befd5bb45
Partial-bug: 1204566
This commit is contained in:
OlgaGusarenko 2015-07-20 13:51:41 +03:00
parent 79be92627c
commit c263b5daa8
3 changed files with 57 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/user-guide/source/cli_change_the_size_of_your_server.rst
View File

@ -43,7 +43,6 @@ Change the size of a server by changing its flavor.
#. List the available flavors with the following command::
$ nova flavor-list
+-----+-----------+-----------+------+-----------+------+-------+-------------+----------+
| ID | Name | Memory_MB | Disk | Ephemeral | Swap | VCPUs | RXTX_Factor | Is_Public|
@ -59,12 +58,30 @@ Change the size of a server by changing its flavor.
ID or name and the new flavor. Include the ``--poll`` parameter to display
the resize progress. For example::
$ nova resize myCirrosServer 4 --poll
Instance resizing... 100% complete
Finished
.. note::
By default, the :command:`nova resize` command gives the guest operating
system a chance to perform a controlled shutdown before the instance
is powered off and the instance is resized.
The shutdown behavior is configured by the
``shutdown_timeout`` parameter that can be set in the
:file:`nova.conf` file. Its value stands for the overall
period (in seconds) a guest operation system is allowed
to complete the shutdown. The default timeout is 60 seconds.
See `Description of Compute configuration options
<http://docs.openstack.org/kilo/config-reference/content/list-of-compute-config-options.html>`_
for details.
The timeout value can be overridden on a per image basis
by means of ``os_shutdown_timeout`` that is an image metadata
setting allowing different types of operating systems to specify
how much time they need to shut down cleanly.
#. Show the status for your server::
$ nova list

20
doc/user-guide/source/cli_reboot_an_instance.rst
View File

@ -36,6 +36,26 @@ command::
$ nova rescue SERVER
.. note::
On running the :command:`nova rescue` command,
an instance performs a soft shutdown first. This means that
the guest operating system has a chance to perform
a controlled shutdown before the instance is powered off.
The shutdown behavior is configured by the ``shutdown_timeout``
parameter that can be set in the :file:`nova.conf` file.
Its value stands for the overall period (in seconds)
a guest operation system is allowed to complete the shutdown.
The default timeout is 60 seconds. See `Description of
Compute configuration options
<http://docs.openstack.org/kilo/config-reference/content/list-of-compute-config-options.html>`_
for details.
The timeout value can be overridden on a per image basis
by means of ``os_shutdown_timeout`` that is an image metadata
setting allowing different types of operating systems to specify
how much time they need to shut down cleanly.
To restart the instance from the normal boot disk, run the following
command::

18
doc/user-guide/source/cli_stop_and_start_an_instance.rst
View File

@ -50,6 +50,24 @@ You can run the following shelving tasks:
$ nova shelve SERVERNAME
.. note::
By default, the :command:`nova shelve` command gives the guest operating
system a chance to perform a controlled shutdown before the instance
is powered off. The shutdown behavior is configured by the
``shutdown_timeout`` parameter that can be set in the
:file:`nova.conf` file. Its value stands for the overall
period (in seconds) a guest operation system is allowed
to complete the shutdown. The default timeout is 60 seconds.
See `Description of Compute configuration options
<http://docs.openstack.org/kilo/config-reference/content/list-of-compute-config-options.html>`_
for details.
The timeout value can be overridden on a per image basis
by means of ``os_shutdown_timeout`` that is an image metadata
setting allowing different types of operating systems to specify
how much time they need to shut down cleanly.
- Unshelve an instance - Restores the instance.
.. code::