openstack-manuals/doc/user-guide/source/cli_reboot_an_instance.rst
Andreas Jaeger 28d95bfc66 End User Guide: Remove user_only and orphan
With the split of the User Guides, there's no need anymore to have
orphan and user_only flags, remove them from the user-guide
directory.

Only files that keep :orphan: are
doc/user-guide/source/hot-guide/hot_advanced_topics.rst and
hot_existing_templates.rst since these files are not currently included.

Change-Id: I1ac0356d69d8668785f8b1947e8b061731aca747
2015-05-13 18:09:16 +00:00

48 lines
1.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::
$ nova reboot SERVER
To perform a hard reboot, pass the ``--hard`` parameter, as follows::
$ 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::
$ nova rescue SERVER
To restart the instance from the normal boot disk, run the following
command::
$ nova unrescue SERVER
If you want to rescue an instance with a specific image, rather than the
default one, use the ``--rescue_image_ref`` parameter::
$ nova rescue --rescue_image_ref IMAGE_ID SERVER