From 3b15d543f1cbfcf6367cb95adf9f3f1b0206ccd9 Mon Sep 17 00:00:00 2001 From: Dmitry Tantsur Date: Wed, 16 Dec 2020 19:42:58 +0100 Subject: [PATCH] Document that DHCP-less deploy does work with debian-minimal Change-Id: I9ec4f9ceac0c5517ce59c6db3681ef9dc643ec14 --- doc/source/admin/dhcp-less.rst | 16 ++++++++++------ .../notes/dhcp-less-less-2a35df67d840f9d5.yaml | 3 ++- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/doc/source/admin/dhcp-less.rst b/doc/source/admin/dhcp-less.rst index 3e848389f0..ab6e52ecf4 100644 --- a/doc/source/admin/dhcp-less.rst +++ b/doc/source/admin/dhcp-less.rst @@ -1,12 +1,6 @@ Layer 3 or DHCP-less ramdisk booting ==================================== -.. warning:: - As of the Victoria release, the ramdisk side of this feature does **NOT** - work out-of-box because of a conflict between NetworkManager and Glean_. - To use it properly you need to manually create a ramdisk with Glean_ taking - priority over any other network configuration. - Booting nodes via PXE, while universally supported, suffers from one disadvantage: it requires a direct L2 connectivity between the node and the control plane for DHCP. Using virtual media it is possible to avoid not only @@ -21,6 +15,16 @@ The Glean_ tool will look for a media labeled as ``config-2``. If found, the network information from it will be read, and the node's networking stack will be configured accordingly. +.. code-block:: console + + ironic-python-agent-builder -o /output/ramdisk \ + debian-minimal -e simple-init + +.. warning:: + The simple-init_ element is found to conflict to NetworkManager, which makes + this feature not operational with ramdisks based on CentOS, RHEL and Fedora. + The ``debian-minimal`` element seems to work correctly. + .. note:: If desired, some interfaces can still be configured to use DHCP. diff --git a/releasenotes/notes/dhcp-less-less-2a35df67d840f9d5.yaml b/releasenotes/notes/dhcp-less-less-2a35df67d840f9d5.yaml index f6b5020a19..4b1788272b 100644 --- a/releasenotes/notes/dhcp-less-less-2a35df67d840f9d5.yaml +++ b/releasenotes/notes/dhcp-less-less-2a35df67d840f9d5.yaml @@ -2,4 +2,5 @@ issues: - | Building ramdisks for DHCP-less deploy using the ``simple-init`` element - does not currently work. The team is looking into possible solutions. + is known not to work for distributions using NetworkManager. + The ``debian-minimal`` element seems to work.