From a7809b15ae8ebb7dbcde39bfe330f60d429031ff Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Thu, 28 Sep 2023 09:27:50 -0700 Subject: [PATCH] OSDOCS-6844: Added a warning about using a .nmconnection file name extension to a network manager connection profile.. --- ...ines-advanced-customizing-live-network-config.adoc | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/modules/installation-user-infra-machines-advanced-customizing-live-network-config.adoc b/modules/installation-user-infra-machines-advanced-customizing-live-network-config.adoc index 39b3d5675b..3f276ad3f5 100644 --- a/modules/installation-user-infra-machines-advanced-customizing-live-network-config.adoc +++ b/modules/installation-user-infra-machines-advanced-customizing-live-network-config.adoc @@ -8,6 +8,11 @@ = Modifying a live install {boot-media} with customized network settings You can embed a NetworkManager keyfile into the live {boot-media} and pass it through to the installed system with the `--network-keyfile` flag of the `customize` subcommand. +[WARNING] +==== +When creating a connection profile, you must use a `.nmconnection` filename extension in the filename of the connection profile. If you do not use a `.nmconnection` filename extension, the cluster will apply the connection profile to the live environment, but it will not apply the configuration when the cluster first boots up the nodes, resulting in a setup that does not work. +==== + .Procedure . Download the `coreos-installer` binary from the link:https://mirror.openshift.com/pub/openshift-v4/clients/coreos-installer/latest/[`coreos-installer` image mirror] page. @@ -38,7 +43,7 @@ method=auto [proxy] ---- -+ + . Create a connection profile for a secondary interface to add to the bond. For example, create the `bond0-proxy-em1.nmconnection` file in your local directory with the following content: + [source,ini] @@ -55,7 +60,7 @@ slave-type=bond [ethernet] mac-address-blacklist= ---- -+ + . Create a connection profile for a secondary interface to add to the bond. For example, create the `bond0-proxy-em2.nmconnection` file in your local directory with the following content: + [source,ini] @@ -72,7 +77,7 @@ slave-type=bond [ethernet] mac-address-blacklist= ---- -+ + ifeval::["{boot-media}" == "ISO image"] . Retrieve the {op-system} ISO image from the link:https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/latest/[{op-system} image mirror] page and run the following command to customize the ISO image with your configured networking: +