outdated --block-device doc for nova boot in user guide

Bug #1367537 reported by Mike Spreitzer
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
Medium
Tom Fifield

Bug Description

http://docs.openstack.org/user-guide/content/attach_volume_to_instance.html and siblings document a --block-device argument to `nova boot` but that is outdated. Now `nova boot` takes a --block-device-mapping argument instead, with a difference syntax for its value.

Revision history for this message
Andreas Jaeger (jaegerandi) wrote :

Where does it say that --block-device is outdated? Looking at "nova help boot" I see no deprecation notice.

Revision history for this message
Mike Spreitzer (mike-spreitzer) wrote :

Perhaps the vintage I am running was some bad interim state, but there was no --block-device available.

But there is now a --block-device-mapping now available and it needs documentation, right?

Revision history for this message
Andreas Jaeger (jaegerandi) wrote :

Sure, it's nice to document it. But there's no need IMHO to change the existing documentation...

Btw. the CLI Reference documents both options.

Revision history for this message
Anne Gentle (annegentle) wrote :

I agree that the user guide instructions themselves can be updated. Apparently there's also a --block-device-mapping-v2 which makes things even more confusing.

Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → Medium
Revision history for this message
Anne Gentle (annegentle) wrote :

Woops, I don't mean there's a second parameter. I mean there's this:

http://developer.openstack.org/api-ref-compute-v2-ext.html#ext-os-block-device-mapping-v2-boot

which causes confusion.

The basic explanation for the v2 is that in that call, nova is passing info on to cinder and booting, but in in the other version, (block-device-mapping) you've already done the volume creation and you're just using nova to boot from it.

Revision history for this message
Tom Fifield (fifieldt) wrote :
Changed in openstack-manuals:
assignee: nobody → Tom Fifield (fifieldt)
status: Confirmed → Fix Released
milestone: none → liberty
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.