From 2d5c7f80d8c233181eac7407f81691047e696086 Mon Sep 17 00:00:00 2001 From: Dmitry Tantsur Date: Tue, 10 Nov 2020 11:32:02 +0100 Subject: Docs: a more complete example of ramdisk boot with redfish-virtual-media It proved easy to overlook that it requires changing the deploy_interface. Change-Id: Ibd4b76db4a78e0a71b6dce3d01cd3e9548e5b099 --- doc/source/admin/drivers/redfish.rst | 13 +++++++++---- doc/source/admin/ramdisk-boot.rst | 9 ++------- 2 files changed, 11 insertions(+), 11 deletions(-) (limited to 'doc') diff --git a/doc/source/admin/drivers/redfish.rst b/doc/source/admin/drivers/redfish.rst index b389be52a..bb83e64e2 100644 --- a/doc/source/admin/drivers/redfish.rst +++ b/doc/source/admin/drivers/redfish.rst @@ -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 \ + --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`: diff --git a/doc/source/admin/ramdisk-boot.rst b/doc/source/admin/ramdisk-boot.rst index 815321b0c..dc212d6ea 100644 --- a/doc/source/admin/ramdisk-boot.rst +++ b/doc/source/admin/ramdisk-boot.rst @@ -36,13 +36,8 @@ or update an existing node: baremetal node set --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 +` instead of iPXE. .. TODO(dtantsur): document how exactly to create and boot a ramdisk -- cgit v1.2.1