yahoo-eng-team team mailing list archive

[Matt Riedemann <mriedem.os@xxxxxxxxx>]

Public bug reported:

The pause:

https://developer.openstack.org/api-ref/compute/#pause-server-pause-
action

And suspend:

https://developer.openstack.org/api-ref/compute/#suspend-server-suspend-
action

APIs just say they pause and suspend the server, which does not really
tell the user anything about what the difference is between the APIs,
why you'd want to use one over the other, etc. We should describe more
there.

For the libvirt driver, this describes the suspend operation:

https://libvirt.org/sources/virshcmdref/html/sect-managedsave.html

and

https://wiki.libvirt.org/page/VM_lifecycle#States_that_a_guest_domain_can_be_in

"Saved - Similar to the paused state, but the domain state is stored to
persistent storage. Again, the domain in this state can be restored and
it does not notice that any time has passed."

And for pause with libvirt:

https://wiki.libvirt.org/page/VM_lifecycle#Pausing_a_guest_domain

** Affects: nova
     Importance: Medium
         Status: Confirmed


** Tags: api-ref

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Compute (nova).
https://bugs.launchpad.net/bugs/1785246

Title:
  Compute API reference should describe pause and suspend operations

Status in OpenStack Compute (nova):
  Confirmed

Bug description:
  The pause:

  https://developer.openstack.org/api-ref/compute/#pause-server-pause-
  action

  And suspend:

  https://developer.openstack.org/api-ref/compute/#suspend-server-
  suspend-action

  APIs just say they pause and suspend the server, which does not really
  tell the user anything about what the difference is between the APIs,
  why you'd want to use one over the other, etc. We should describe more
  there.

  For the libvirt driver, this describes the suspend operation:

  https://libvirt.org/sources/virshcmdref/html/sect-managedsave.html

  and

  https://wiki.libvirt.org/page/VM_lifecycle#States_that_a_guest_domain_can_be_in

  "Saved - Similar to the paused state, but the domain state is stored
  to persistent storage. Again, the domain in this state can be restored
  and it does not notice that any time has passed."

  And for pause with libvirt:

  https://wiki.libvirt.org/page/VM_lifecycle#Pausing_a_guest_domain

To manage notifications about this bug go to:
https://bugs.launchpad.net/nova/+bug/1785246/+subscriptions