VM in rescue state must have a restricted set of actions

[OpenStack Infra]

https://review.openstack.org/94281
commit 8ff170dc95bf3101fe38a2624e941bfa3b7c1138
Author: Leandro I. Costantino <email address hidden>
Date: Mon May 19 19:58:47 2014 -0300

    VM in rescue state must have a restricted set of actions

    Right now it is possible to pause, suspend and stop a VM in state RESCUED,
    so after the state is changed, it's not possible to trigger unrescue anymore
    since the original state is lost.

    This patch remove vm_states.RESCUED as valid state from stop,
    pause and suspend actions.

    The vm_states devref is also updated to reflect this change including the
    current reboot flow.( vm_states.RESCUED cannot be rebooted as per
    today code)

    DocImpact
    Closes-Bug: #1319182
    Co-Authored-By: Cyril Roelandt <email address hidden>
    Change-Id: I531dea5a5499bf93c24bea37850d562134dee281

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/150385

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/150385
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=2c288fbe52e04922eb1a190a3a2c812d8ef7f63b
Submitter: Jenkins
Branch: master

commit 2c288fbe52e04922eb1a190a3a2c812d8ef7f63b
Author: OlgaGusarenko <email address hidden>
Date: Tue Jan 27 13:44:01 2015 +0200

    Adds reboot into rescue mode

    There were no usage instructions on how to reboot an instance into
    the rescue mode. So, it was decided to add the description of
    $ nova rescue SERVER and $ nova unrescue SERVER
    commands to the user guide (Reboot an instance section).

    As it is much related to the bug
    https://bugs.launchpad.net/openstack-manuals/+bug/1346793
    it also adds a note, informing the user about the restricted
    number of available actions for the instance in running
    in the rescue mode.

    Besides, it adds --rescue_image_ref

    Change-Id: I8818d4d7430c26619cd7bfc364c0f3d19f174152
    Partial-Bug: 1346793
    Closes-Bug: 1306174