OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bri… by dfitzmau · Pull Request #119740 · openshift/openshift-docs

dfitzmau · 2026-09-11T16:23:41Z

Version(s):
4.16+

Issue:
OCPBUGS-121938

Link to docs preview:

https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/bare-metal-postinstallation-configuration.html

SME has approved this change (Pablo R.).
QE has approved this change (Ros B.).

openshift-ci-robot · 2026-09-11T16:23:48Z

@dfitzmau: This pull request references Jira Issue OCPBUGS-121938, which is invalid:

expected the bug to target the "5.1.0" version, but no target version was set
expected the bug to be in one of the following states: NEW, ASSIGNED, POST, but it is MODIFIED instead

Comment /jira refresh to re-evaluate validity if changes to the Jira bug are made, or edit the title of this pull request to link to a different bug.

The bug has been updated to refer to the pull request using the external bug tracker.

Details

In response to this:

Ask B.Nemec about "It might make sense to provide instructions on how to use butane to generate the machine config from the file, as it is done in other sections of the documentation."

Version(s):
4.16+

Issue:
OCPBUGS-121938

Link to docs preview:

SME has approved this change.

QE has approved this change.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

ocpdocs-previewbot · 2026-09-11T16:31:46Z

🤖 Tue Sep 29 15:16:26 - Prow CI generated the docs preview:

https://119740--ocpdocs-pr.netlify.app/
https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/bare-metal-postinstallation-configuration.html
https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/ipi/ipi-install-installation-workflow.html
https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/upi/installing-bare-metal.html
https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.html
https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.html
https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_with_agent_based_installer/installing-with-agent-based-installer.html

openshift-ci-robot · 2026-09-17T11:47:31Z

@dfitzmau: This pull request references Jira Issue OCPBUGS-121938, which is invalid:

expected the bug to target the "5.1.0" version, but no target version was set
expected the bug to be in one of the following states: NEW, ASSIGNED, POST, but it is MODIFIED instead

Comment /jira refresh to re-evaluate validity if changes to the Jira bug are made, or edit the title of this pull request to link to a different bug.

Details

In response to this:

Ask B.Nemec about "It might make sense to provide instructions on how to use butane to generate the machine config from the file, as it is done in other sections of the documentation."

Version(s):
4.16+

Issue:
OCPBUGS-121938

Link to docs preview:

https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/bare-metal-postinstallation-configuration.html

SME has approved this change.

QE has approved this change.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

palonsoro

Minor improvement suggestion.

palonsoro · 2026-09-22T10:54:16Z

-
+====
+
 The following example sets the MTU to `9000` for both the physical device and the bridge interface in the NMState configuration file. You must base64-encode the file and then embed the output in a `MachineConfig` manifest file. The `MachineConfig` manifest file writes to `/etc/nmstate/openshift/cluster.yml` or a per-node path under `/etc/nmstate/openshift/`.


Not sure if there would be a way to make it clearer is that increasing MTU to 9000 is just a single example among the many things the user could do.

For the rest, it looks good to me as of now.

palonsoro · 2026-09-22T11:29:55Z

/lgtm

…dge to NMState

openshift-ci · 2026-09-29T15:18:04Z

@dfitzmau: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

openshift-ci-robot · 2026-09-29T15:47:10Z

@dfitzmau: Jira Issue OCPBUGS-121938: All pull requests linked via external trackers have merged:

openshift/openshift-docs#119740

Jira Issue OCPBUGS-121938 has been moved to the MODIFIED state.

Details

In response to this:

Version(s):
4.16+

Issue:
OCPBUGS-121938

Link to docs preview:

https://119740--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_bare_metal/bare-metal-postinstallation-configuration.html

SME has approved this change (Pablo R.).

QE has approved this change (Ros B.).

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

dfitzmau · 2026-09-29T15:47:20Z

/cherrypick enterprise-5.0

dfitzmau · 2026-09-29T15:47:27Z

/cherrypick enterprise-4.22

dfitzmau · 2026-09-29T15:47:30Z

/cherrypick enterprise-4.21

dfitzmau · 2026-09-29T15:47:37Z

/cherrypick enterprise-4.20

dfitzmau · 2026-09-29T15:47:54Z

/cherrypick enterprise-4.19

dfitzmau · 2026-09-29T15:47:59Z

/cherrypick enterprise-4.18

dfitzmau · 2026-09-29T15:48:06Z

/cherrypick enterprise-4.17

dfitzmau · 2026-09-29T15:48:10Z

/cherrypick enterprise-4.16

openshift-cherrypick-robot · 2026-09-29T15:48:38Z

@dfitzmau: new pull request created: #120682

Details

In response to this:

/cherrypick enterprise-5.0

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:41Z

@dfitzmau: #119740 failed to apply on top of branch "enterprise-4.19":

Applying: OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState
Using index info to reconstruct a base tree...
M	installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc
M	installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
M	installing/installing_bare_metal/upi/installing-bare-metal.adoc
M	installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
M	installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
M	modules/creating-manifest-file-customized-br-ex-bridge.adoc
A	modules/migrating-br-ex-bridge-nmstate.adoc
Falling back to patching base and 3-way merge...
Auto-merging installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc
Auto-merging installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
Auto-merging installing/installing_bare_metal/upi/installing-bare-metal.adoc
Auto-merging installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
Auto-merging installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
Auto-merging modules/creating-manifest-file-customized-br-ex-bridge.adoc
CONFLICT (modify/delete): modules/migrating-br-ex-bridge-nmstate.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of modules/migrating-br-ex-bridge-nmstate.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState

Details

In response to this:

/cherrypick enterprise-4.19

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:42Z

@dfitzmau: new pull request created: #120683

Details

In response to this:

/cherrypick enterprise-4.22

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:45Z

@dfitzmau: #119740 failed to apply on top of branch "enterprise-4.18":

Applying: OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState
Using index info to reconstruct a base tree...
M	installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc
M	installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
M	installing/installing_bare_metal/upi/installing-bare-metal.adoc
M	installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
M	installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
M	modules/creating-manifest-file-customized-br-ex-bridge.adoc
A	modules/migrating-br-ex-bridge-nmstate.adoc
Falling back to patching base and 3-way merge...
Auto-merging installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc
Auto-merging installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
Auto-merging installing/installing_bare_metal/upi/installing-bare-metal.adoc
Auto-merging installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
Auto-merging installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
Auto-merging modules/creating-manifest-file-customized-br-ex-bridge.adoc
CONFLICT (modify/delete): modules/migrating-br-ex-bridge-nmstate.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of modules/migrating-br-ex-bridge-nmstate.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState

Details

In response to this:

/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:46Z

@dfitzmau: new pull request created: #120684

Details

In response to this:

/cherrypick enterprise-4.21

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:53Z

@dfitzmau: #119740 failed to apply on top of branch "enterprise-4.17":

Applying: OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState
Using index info to reconstruct a base tree...
A	installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc
A	installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
A	installing/installing_bare_metal/upi/installing-bare-metal.adoc
A	installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
M	installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
M	modules/creating-manifest-file-customized-br-ex-bridge.adoc
A	modules/migrating-br-ex-bridge-nmstate.adoc
Falling back to patching base and 3-way merge...
Auto-merging installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
CONFLICT (content): Merge conflict in installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
CONFLICT (modify/delete): installing/installing_bare_metal/upi/installing-bare-metal.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of installing/installing_bare_metal/upi/installing-bare-metal.adoc left in tree.
CONFLICT (modify/delete): installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc left in tree.
Auto-merging installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc
CONFLICT (content): Merge conflict in installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc
Auto-merging installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
CONFLICT (content): Merge conflict in installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
Auto-merging modules/creating-manifest-file-customized-br-ex-bridge.adoc
CONFLICT (modify/delete): modules/migrating-br-ex-bridge-nmstate.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of modules/migrating-br-ex-bridge-nmstate.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState

Details

In response to this:

/cherrypick enterprise-4.17

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:56Z

@dfitzmau: new pull request created: #120685

Details

In response to this:

/cherrypick enterprise-4.20

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-cherrypick-robot · 2026-09-29T15:48:58Z

@dfitzmau: #119740 failed to apply on top of branch "enterprise-4.16":

Applying: OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState
Using index info to reconstruct a base tree...
A	installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc
A	installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
A	installing/installing_bare_metal/upi/installing-bare-metal.adoc
A	installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
M	installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
M	modules/creating-manifest-file-customized-br-ex-bridge.adoc
A	modules/migrating-br-ex-bridge-nmstate.adoc
Falling back to patching base and 3-way merge...
Auto-merging installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
CONFLICT (content): Merge conflict in installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
CONFLICT (modify/delete): installing/installing_bare_metal/upi/installing-bare-metal.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of installing/installing_bare_metal/upi/installing-bare-metal.adoc left in tree.
CONFLICT (modify/delete): installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc left in tree.
Auto-merging installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc
CONFLICT (content): Merge conflict in installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc
Auto-merging installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
CONFLICT (content): Merge conflict in installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc
Auto-merging modules/creating-manifest-file-customized-br-ex-bridge.adoc
CONFLICT (modify/delete): modules/migrating-br-ex-bridge-nmstate.adoc deleted in HEAD and modified in OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState.  Version OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState of modules/migrating-br-ex-bridge-nmstate.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bridge to NMState

Details

In response to this:

/cherrypick enterprise-4.16

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

openshift-ci Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Sep 11, 2026

openshift-ci-robot added jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. jira/invalid-bug Indicates that a referenced Jira bug is invalid for the branch this PR is targeting. labels Sep 17, 2026

openshift-ci Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Sep 17, 2026

dfitzmau force-pushed the OCPBUGS-121938 branch from c1f5855 to 66cc33f Compare September 17, 2026 11:52

openshift-ci Bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Sep 17, 2026

dfitzmau force-pushed the OCPBUGS-121938 branch 2 times, most recently from 4aa3e6f to b813322 Compare September 22, 2026 10:28

palonsoro reviewed Sep 22, 2026

View reviewed changes

dfitzmau force-pushed the OCPBUGS-121938 branch from b813322 to 4d176b0 Compare September 22, 2026 11:22

openshift-ci Bot assigned palonsoro Sep 22, 2026

dfitzmau force-pushed the OCPBUGS-121938 branch from 0a0689d to b9d1327 Compare September 29, 2026 14:40

OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bri…

f3c8749

…dge to NMState

dfitzmau force-pushed the OCPBUGS-121938 branch from b9d1327 to f3c8749 Compare September 29, 2026 14:57

dfitzmau merged commit 156fa87 into openshift:main Sep 29, 2026
2 checks passed

openshift-cherrypick-robot mentioned this pull request Sep 29, 2026

[enterprise-5.0] OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bri… #120682

Merged

openshift-cherrypick-robot mentioned this pull request Sep 29, 2026

[enterprise-4.22] OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bri… #120683

Merged

openshift-cherrypick-robot mentioned this pull request Sep 29, 2026

[enterprise-4.21] OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bri… #120684

Merged

openshift-cherrypick-robot mentioned this pull request Sep 29, 2026

[enterprise-4.20] OCPBUGS-121938: Reworked the note on Migrating a configured br-ex bri… #120685

Merged

Conversation

dfitzmau commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Sep 11, 2026

Uh oh!

ocpdocs-previewbot commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Sep 17, 2026

Uh oh!

palonsoro left a comment

Choose a reason for hiding this comment

Uh oh!

palonsoro Sep 22, 2026

Choose a reason for hiding this comment

Uh oh!

palonsoro commented Sep 22, 2026

Uh oh!

openshift-ci Bot commented Sep 29, 2026

Uh oh!

Uh oh!

openshift-ci-robot commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

dfitzmau commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

openshift-cherrypick-robot commented Sep 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

dfitzmau commented Sep 11, 2026 •

edited

Loading

ocpdocs-previewbot commented Sep 11, 2026 •

edited

Loading