diff options
author | Mathieu Mitchell <mmitchell@iweb.com> | 2016-09-13 20:29:46 -0400 |
---|---|---|
committer | Mathieu Mitchell <mmitchell@iweb.com> | 2016-09-27 17:09:09 -0400 |
commit | a62c8c9c4b55fe07b11e875ab2ce5d6e900c4ea1 (patch) | |
tree | 1082fc3b273295e5cf23316558e6ac3ac2abc7df /install-guide/source/include | |
parent | e2359a13ac20ff330702c8d22a856508bec4e26a (diff) | |
download | ironic-a62c8c9c4b55fe07b11e875ab2ce5d6e900c4ea1.tar.gz |
[install-guide] Import "Local boot with partition images"
Create a new "Advanced features" section and import local boot under
it.
Change-Id: Icb24adf37a2874f6fd6fb446243dbe894e5cb63f
Partial-bug: #1612278
(cherry picked from commit 123b5456da01af3244d352c9a49b1d7f6eda6372)
Diffstat (limited to 'install-guide/source/include')
-rw-r--r-- | install-guide/source/include/local-boot-partition-images.rst | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/install-guide/source/include/local-boot-partition-images.rst b/install-guide/source/include/local-boot-partition-images.rst new file mode 100644 index 000000000..e12ac85dc --- /dev/null +++ b/install-guide/source/include/local-boot-partition-images.rst @@ -0,0 +1,58 @@ +.. _local-boot-partition-images: + +Local boot with partition images +-------------------------------- + +Starting with the Kilo release, Bare Metal service supports local boot with +partition images, meaning that after the deployment the node's subsequent +reboots won't happen via PXE or Virtual Media. Instead, it will boot from a +local boot loader installed on the disk. + +It's important to note that in order for this to work the image being +deployed with Bare Metal service **must** contain ``grub2`` installed within it. + +Enabling the local boot is different when Bare Metal service is used with +Compute service and without it. +The following sections will describe both methods. + +.. note:: + The local boot feature is dependent upon a updated deploy ramdisk built + with diskimage-builder_ **version >= 0.1.42** or ironic-python-agent_ + in the kilo-era. + +.. _diskimage-builder: http://docs.openstack.org/developer/diskimage-builder/ +.. _ironic-python-agent: http://docs.openstack.org/developer/ironic-python-agent/ + + +Enabling local boot with Compute service +======================================== + +To enable local boot we need to set a capability on the bare metal node, +for example:: + + ironic node-update <node-uuid> add properties/capabilities="boot_option:local" + + +Nodes having ``boot_option`` set to ``local`` may be requested by adding +an ``extra_spec`` to the Compute service flavor, for example:: + + nova flavor-key baremetal set capabilities:boot_option="local" + + +.. note:: + If the node is configured to use ``UEFI``, Bare Metal service will create + an ``EFI partition`` on the disk and switch the partition table format to + ``gpt``. The ``EFI partition`` will be used later by the boot loader + (which is installed from the deploy ramdisk). + + +Enabling local boot without Compute +=================================== + +Since adding ``capabilities`` to the node's properties is only used by +the nova scheduler to perform more advanced scheduling of instances, +we need a way to enable local boot when Compute is not present. To do that +we can simply specify the capability via the ``instance_info`` attribute +of the node, for example:: + + ironic node-update <node-uuid> add instance_info/capabilities='{"boot_option": "local"}' |