Compute API: migrate doesn't exist in the doc but is in the core compute API

[Anne Gentle]

Review the thread about:
·Migrate: move a VM from one server to another, reboots across the move (I think) and destination is picked by scheduler ·LiveMigration: move a VM from one server to another, VM doesn't appear to reboot, need to specify the destination (both with shared storage and block storage)
- Resize then migrate

Mailing list thread at http://markmail.org/message/qpyyezmvuufxkwvw

Doc updates include:

1. Add WADL about the live migration extension to the Compute API so that it shows up on api.openstack.org.
2. Add information about migrate command to the Compute API developer guide.
3. Add information about the migrate command to python-novaclient docs.
4. Add information to define each type of migration of VMs.
5. Include info about billing ramifications.

[Ying Chun Guo (daisy-ycguo)]

Hi, Anne

Does it mean the migration and live migration in admin-actions, which is a compute api extension?
The source code is nova/api/openstack/compute/contrib/admin_actions.py.

I added part of admin_actions when fixing bug 1029560, including pause, unpause and ect. If this bug is related with the same api extension with bug 1029560, I can also do this one.

Daisy

[Tom Fifield (fifieldt)]

Hi Ying Chun,

Yes - I believe that's correct.

I'll mark you as asignee as you've said you might want to have a go - feel free to remove yourself if you don't have time :)

[Ying Chun Guo (daisy-ycguo)]

Hi Tom

I will start from Bug #1042652, and then this one.

Daisy

[Ying Chun Guo (daisy-ycguo)]

Hi,

I need more information about below items:

4. Add information to define each type of migration of VMs.
5. Include info about billing ramifications.

What are the types of migration of VMs? Does it mean: live migration and migration?
What are "billing ramifications"? Where can I find information about them?

Who can help to answer? Thanks in advance.

Daisy

[Anne Gentle (annegentle)]

For 4. about types of migrations, I think a simple section stating what types of migrations can happen with nova would suffice:
live migration with block migration
live migration without block migration
resize/migrate (non-live)
resize

For 5. about billing ramifications, there may be a note similar to "This operation involves you being billed for a snapshot. You may delete the snapshot once the operation has completed" after the user does a resize/migrate.

[Anne Gentle (annegentle)]

Diane, here's another older bug. Migration is a particularly confusing area for users, likely due to the implementation, so this may take some time.

[Diane Fleming (diane-fleming)]

I've done this:
1. Add WADL about the live migration extension to the Compute API so that it shows up on api.openstack.org.
2. Add information about migrate command to the Compute API developer guide.

Still need to do this:
3. Add information about the migrate command to python-novaclient docs.
4. Add information to define each type of migration of VMs.
5. Include info about billing ramifications.

[Diane Fleming (diane-fleming)]

https://review.openstack.org/27917

[OpenStack Infra (hudson-openstack)]

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

[Diane Fleming (diane-fleming)]

Changes to api-ref site here: https://review.openstack.org/27919

[Diane Fleming (diane-fleming)]

Changes to cli-guide here: https://review.openstack.org/27929

[Diane Fleming (diane-fleming)]

moved changes to cli-guide here https://review.openstack.org/28186

[Diane Fleming (diane-fleming)]

moved changes to Compute API Guide to here: https://review.openstack.org/28694