openstack/ironic
Code Issues Proposed changes

Docs: a more complete example of ramdisk boot with redfish-virtual-media

Browse Source 
It proved easy to overlook that it requires changing the deploy_interface.

Change-Id: Ibd4b76db4a78e0a71b6dce3d01cd3e9548e5b099
This commit is contained in:
Dmitry Tantsur 2020-11-10 11:32:02 +01:00
parent 08bf8dee65
commit 2d5c7f80d8
2 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/source/admin/drivers/redfish.rst
View File

@ -185,12 +185,15 @@ property can be used to pass user-specified kernel command line parameters.
For ramdisk kernel, ``[instance_info]/kernel_append_params`` property serves
the same purpose.
.. _redfish-virtual-media-ramdisk:
Virtual Media Ramdisk
~~~~~~~~~~~~~~~~~~~~~
The ``ramdisk`` deploy interface can be used in concert with the
``redfish-virtual-media`` boot interface to facilitate the boot of a remote
node utilizing pre-supplied virtual media.
node utilizing pre-supplied virtual media. See :doc:`/admin/ramdisk-boot` for
information on how to enable and configure it.
Instead of supplying an ``[instance_info]/image_source`` parameter, a
``[instance_info]/boot_iso`` parameter can be supplied. The image will
@ -201,12 +204,14 @@ of ``ACTIVE``.
.. code-block:: bash
baremetal node set \
--instance_info boot_iso=http://url/to.iso node-0
baremetal node set <node name or UUID> \
--boot-interface redfish-virtual-media \
--deploy-interface ramdisk \
--instance_info boot_iso=http://url/to.iso
This initial interface does not support bootloader configuration
parameter injection, as such the ``[instance_info]/kernel_append_params``
setting is ignored.
setting is ignored. Configuration drives are not supported yet.
.. _`dhcpless_booting`:

9
doc/source/admin/ramdisk-boot.rst
View File

@ -36,13 +36,8 @@ or update an existing node:
baremetal node set <NODE> --deploy-interface ramdisk
Using virtual media:
.. code-block:: shell
baremetal node create --driver redfish \
--deploy-interface ramdisk \
--boot-interface redfish-virtual-media
You can also use it with :ref:`redfish virtual media
<redfish-virtual-media-ramdisk>` instead of iPXE.
.. TODO(dtantsur): document how exactly to create and boot a ramdisk