808235cab3
Implements: blueprint user-guides-reorganised Change-Id: I6e777be1e22f99f839657f25962ff0eb65ead698
76 lines
2.4 KiB
ReStructuredText
76 lines
2.4 KiB
ReStructuredText
==================
|
|
Reboot an instance
|
|
==================
|
|
|
|
You can soft or hard reboot a running instance. A soft reboot attempts a
|
|
graceful shut down and restart of the instance. A hard reboot power
|
|
cycles the instance.
|
|
|
|
By default, when you reboot an instance, it is a soft reboot.
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova reboot SERVER
|
|
|
|
To perform a hard reboot, pass the :option:`--hard` parameter, as follows:
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova reboot --hard SERVER
|
|
|
|
It is also possible to reboot a running instance into rescue mode. For example,
|
|
this operation may be required, if a filesystem of an instance becomes
|
|
corrupted with prolonged use.
|
|
|
|
.. note::
|
|
|
|
Pause, suspend, and stop operations are not allowed when an instance
|
|
is running in rescue mode, as triggering these actions causes the
|
|
loss of the original instance state, and makes it impossible to
|
|
unrescue the instance.
|
|
|
|
Rescue mode provides a mechanism for access, even if an image renders
|
|
the instance inaccessible. By default, it starts an instance from the
|
|
initial image attaching the current boot disk as a secondary one.
|
|
|
|
To perform an instance reboot into rescue mode, run the following
|
|
command:
|
|
|
|
.. code-block:: console
|
|
|
|
$ 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 ``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/liberty/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:
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova unrescue SERVER
|
|
|
|
If you want to rescue an instance with a specific image, rather than the
|
|
default one, use the :option:`--rescue_image_ref` parameter:
|
|
|
|
.. code-block:: console
|
|
|
|
$ nova rescue --rescue_image_ref IMAGE_ID SERVER
|