Rename vm reset_to_last_shutdown_state cmd to redeploy; add reset_disks command; fix help pages

[ryran]

The Ravello API docs are not very clear with regards to resetDisks and redeploy, but certainly Ravshello needs an update. Draft help pages follow, though I have no idea how accurate they are.

reset_disks

Reset VM disks of a VM to their most recent saved state.

The "most recent saved state" of each disk will come from the most recent of:

  * when the whole app was last saved to a new blueprint
  * when the whole VM was last saved to the VM images library
  * when the disk was last saved to the disk images library
  * when the VM was last shutdown

If none of those apply (if VM hasn't been shutdown since being published), the
most recent state will be that of the disks from original blueprint. If the VM
wasn't in original blueprint (i.e., was added to published application), the
most recent state will be that of the disks from VM or disk image library.

Note that this command only works with VMs in STARTED state. For this command
to be able to reset a VM to a pristine state (i.e., the state of the VM when
originally published), the VM must still be running and must have never been
stopped or saved to the library.

See also command: redeploy

redeploy

Replaces VM with a new copy based on the most recent VM saved state.

The "most recent saved state" of each disk will come from the most recent of:

  * when the whole app was last saved to a new blueprint
  * when the whole VM was last saved to the VM images library
  * when the disk was last saved to the disk images library
  * when the VM was last shutdown

If none of those apply (if VM hasn't been shutdown since being published), the
most recent state will be that of the disks from original blueprint. If the VM
wasn't in original blueprint (i.e., was added to published application), the
most recent state will be that of the disks from VM or disk image library.

This command will succeed under all conditions; however, for this command to be
able to reset a VM to a pristine state (i.e., the state of the VM when
originally published), the VM must have never been stopped or saved to the
library.

See also command: reset_disks

EDIT: Feedback from Ravello support has been incorporated into the above explanations.

[ryran]

Committed changes but will keep open until I confirm the above is how these two calls actually work.