openstack/ironic
Code Issues Proposed changes

Clarify that size in root device hints and local_gb are often different

Browse Source 
We often set local_gb = size - 1, while in root device hints size
is expected to be real.

Change-Id: Ia1d53fa66870b13bff53324c85cef9731d59f71b
This commit is contained in:
Dmitry Tantsur 2016-01-12 16:39:59 +01:00
parent 53e5171db1
commit 7a5acbd7bf
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/source/deploy/install-guide.rst
View File

@ -1816,6 +1816,14 @@ The list of support hints is:
* vendor (STRING): device vendor * vendor (STRING): device vendor
* serial (STRING): disk serial number * serial (STRING): disk serial number
* size (INT): size of the device in GiB * size (INT): size of the device in GiB
.. note::
A node's 'local_gb' property is often set to a value 1 GiB less than the
actual disk size to account for partitioning (this is how DevStack, TripleO
and Ironic Inspector work, to name a few). However, in this case ``size``
should be the actual size. For example, for a 128 GiB disk ``local_gb``
will be 127, but size hint will be 128.
* wwn (STRING): unique storage identifier * wwn (STRING): unique storage identifier
* wwn_with_extension (STRING): unique storage identifier with the vendor extension appended * wwn_with_extension (STRING): unique storage identifier with the vendor extension appended
* wwn_vendor_extension (STRING): unique vendor storage identifier * wwn_vendor_extension (STRING): unique vendor storage identifier