From 6e6187dc6e700146ebdf8b1e7c66552c18e8fda3 Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 13:54:59 +0200 Subject: [PATCH 1/9] Add netavark requirement --- ...stalling-and-configuring-insights-iop.adoc | 5 ++ ...stalling-and-configuring-insights-iop.adoc | 2 + ...guring-podman-network-backend-for-iop.adoc | 79 +++++++++++++++++++ ...sights-iop-by-using-export-and-import.adoc | 2 + ...on-a-connected-project-context-server.adoc | 10 +-- ...op-with-the-project-context-iso-image.adoc | 2 + 6 files changed, 93 insertions(+), 7 deletions(-) create mode 100644 guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc diff --git a/guides/common/assembly_installing-and-configuring-insights-iop.adoc b/guides/common/assembly_installing-and-configuring-insights-iop.adoc index 49ff5332cd3..89ce49c1267 100644 --- a/guides/common/assembly_installing-and-configuring-insights-iop.adoc +++ b/guides/common/assembly_installing-and-configuring-insights-iop.adoc @@ -1,12 +1,17 @@ include::modules/con_installing-and-configuring-insights-iop.adoc[] ifdef::installing-satellite-server-connected[] + +include::modules/proc_configuring-podman-network-backend-for-iop.adoc[leveloffset=+1] + include::modules/proc_configuring-podman-to-use-an-http-proxy.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc[leveloffset=+1] endif::[] ifdef::installing-satellite-server-disconnected[] +include::modules/proc_configuring-podman-network-backend-for-iop.adoc[leveloffset=+1] + include::modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-by-using-export-and-import.adoc[leveloffset=+1] diff --git a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc index fc6edc9b081..743002f4091 100644 --- a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc +++ b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc @@ -13,6 +13,8 @@ When you install {insights-iop} locally, you can generate {Insights} recommendat Enabling {insights-iop} prevents you from using any {RHCloud} services on hosts registered to {Project}. * If you install {Project} with external databases, you cannot enable {insights-iop}. Enabling {insights-iop} prevents you from using external databases. +* Podman must be configured to use the netavark network backend. +For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. ==== {insights-iop} follows the standard lifecycle policy for {ProjectName}. diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc new file mode 100644 index 00000000000..15adaa8336d --- /dev/null +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc @@ -0,0 +1,79 @@ +:_mod-docs-content-type: PROCEDURE + +[id="configuring-podman-network-backend-for-iop_{context}"] += Configuring Podman network backend for {insights-iop} + +[role="_abstract"] +{insights-iop} requires the netavark network backend for Podman. +Before enabling {insights-iop}, verify that Podman is configured to use netavark. +The CNI network backend and other network backends are not supported. + +.Prerequisites +* Podman is installed. +ifdef::satellite[] +For more information, see {RHELDocsBaseURL}9/html/building_running_and_managing_containers/assembly_starting-with-containers_building-running-and-managing-containers#proc_getting-container-tools_assembly_starting-with-containers[Getting container tools] in _{RHEL}{nbsp}9 Building, running, and managing containers_. +endif::[] +ifndef::satellite[] +For more information, see https://podman.io/docs/installation#installing-on-linux[Installing Podman on Linux]. +endif::[] + +.Procedure +. Verify your current Podman network backend configuration: ++ +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +# podman info | grep networkBackend +---- ++ +If the output shows `networkBackend: netavark`, your system is already configured correctly. +You can proceed to enable {insights-iop}. + +. If the output shows a different network backend, such as `networkBackend: cni`, migrate to netavark: +.. Copy the Podman configuration file if it does not exist: ++ +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +# cp /usr/share/containers/containers.conf /etc/containers/ +---- + +.. Edit `/etc/containers/containers.conf` and add or modify the `network_backend` setting in the `[network]` section: ++ +[source, ini, options="nowrap", subs="+quotes,verbatim,attributes"] +---- +[network] +network_backend="netavark" +---- + +.. Reset the Podman storage to apply the new backend: ++ +[WARNING] +==== +This command stops all existing containers and removes all container storage. +Ensure that you back up any important container data before proceeding. +==== ++ +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +# podman system reset +---- + +.. Reboot your system: ++ +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +# reboot +---- + +.Verification +. After the system reboots, verify that the network backend is set to netavark: ++ +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +# podman info | grep networkBackend +---- ++ +The output should show `networkBackend: netavark`. + +.Additional resources +* For more information about switching to netavark, see https://access.redhat.com/solutions/7055981[How to switch to netavark network backend in Podman] in the Red{nbsp}Hat Knowledgebase. +* For alternative workarounds, see https://access.redhat.com/solutions/7029361[Alternative workaround for Podman network backend configuration] in the Red{nbsp}Hat Knowledgebase. diff --git a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc index 7ab98f88344..9364730dbe0 100644 --- a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc +++ b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc @@ -20,6 +20,8 @@ ifndef::satellite[] # {project-package-install} podman ---- endif::[] +* Ensure that Podman on the disconnected {ProjectServer} is configured to use the netavark network backend. +For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. .Procedure . On the connected system, log in to the container registry: diff --git a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc index a686a01cfc6..cb4d7445b0d 100644 --- a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc +++ b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc @@ -18,13 +18,9 @@ endif::[] ifndef::satellite[] * Ensure that the {ProjectServer} has access to the Quay container registry. endif::[] -* Ensure that Podman is installed. -ifdef::satellite[] -For more information, see {RHELDocsBaseURL}9/html/building_running_and_managing_containers/assembly_starting-with-containers_building-running-and-managing-containers#proc_getting-container-tools_assembly_starting-with-containers[Getting container tools] in _{RHEL}{nbsp}9 Building, running, and managing containers_. -endif::[] -ifndef::satellite[] -For more information, see https://podman.io/docs/installation#installing-on-linux[Installing Podman on Linux]. -endif::[] +* Ensure that Podman is installed and configured to use the netavark network backend. +For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. + .Procedure ifdef::satellite[] diff --git a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc index f7164eb7024..9bd0fb0bda5 100644 --- a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc +++ b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc @@ -18,6 +18,8 @@ ifndef::satellite[] # {project-package-install} skopeo ---- endif::[] +* Ensure that Podman is configured to use the netavark network backend. +For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. .Procedure . Download and mount the {Project} ISO image: From efdba93a121483112897cd23c9747be614d801a1 Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 14:17:28 +0200 Subject: [PATCH 2/9] Make redhat refs conditionals --- .../proc_configuring-podman-network-backend-for-iop.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc index 15adaa8336d..238649ab54e 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc @@ -6,7 +6,7 @@ [role="_abstract"] {insights-iop} requires the netavark network backend for Podman. Before enabling {insights-iop}, verify that Podman is configured to use netavark. -The CNI network backend and other network backends are not supported. +The Container Network Interface (CNI) network backend and other network backends are not supported. .Prerequisites * Podman is installed. @@ -74,6 +74,8 @@ Ensure that you back up any important container data before proceeding. + The output should show `networkBackend: netavark`. +ifdef::satellite[] .Additional resources * For more information about switching to netavark, see https://access.redhat.com/solutions/7055981[How to switch to netavark network backend in Podman] in the Red{nbsp}Hat Knowledgebase. * For alternative workarounds, see https://access.redhat.com/solutions/7029361[Alternative workaround for Podman network backend configuration] in the Red{nbsp}Hat Knowledgebase. +endif::[] From 867f7f58fa2e322719f97fe821b7684f5ec2cdf2 Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 14:36:38 +0200 Subject: [PATCH 3/9] Fix IDs --- .../modules/con_installing-and-configuring-insights-iop.adoc | 2 +- .../proc_configuring-podman-network-backend-for-iop.adoc | 2 +- ...proc_installing-insights-iop-by-using-export-and-import.adoc | 2 +- ...ling-insights-iop-on-a-connected-project-context-server.adoc | 2 +- ...talling-insights-iop-with-the-project-context-iso-image.adoc | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc index 743002f4091..8441619f2a4 100644 --- a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc +++ b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc @@ -14,7 +14,7 @@ Enabling {insights-iop} prevents you from using any {RHCloud} services on hosts * If you install {Project} with external databases, you cannot enable {insights-iop}. Enabling {insights-iop} prevents you from using external databases. * Podman must be configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. ==== {insights-iop} follows the standard lifecycle policy for {ProjectName}. diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc index 238649ab54e..0a0ac6037ad 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc @@ -1,6 +1,6 @@ :_mod-docs-content-type: PROCEDURE -[id="configuring-podman-network-backend-for-iop_{context}"] +[id="configuring-podman-network-backend-for-{insights-iop-id}"] = Configuring Podman network backend for {insights-iop} [role="_abstract"] diff --git a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc index 9364730dbe0..aae76ad7749 100644 --- a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc +++ b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc @@ -21,7 +21,7 @@ ifndef::satellite[] ---- endif::[] * Ensure that Podman on the disconnected {ProjectServer} is configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. .Procedure . On the connected system, log in to the container registry: diff --git a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc index cb4d7445b0d..57924f9f72c 100644 --- a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc +++ b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc @@ -19,7 +19,7 @@ ifndef::satellite[] * Ensure that the {ProjectServer} has access to the Quay container registry. endif::[] * Ensure that Podman is installed and configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. .Procedure diff --git a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc index 9bd0fb0bda5..154e529d02a 100644 --- a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc +++ b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc @@ -19,7 +19,7 @@ ifndef::satellite[] ---- endif::[] * Ensure that Podman is configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop_{context}[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. .Procedure . Download and mount the {Project} ISO image: From 5ac99c87fa00fcfb77f47d2170a73b281ab89daa Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 14:42:02 +0200 Subject: [PATCH 4/9] fix id --- .../modules/con_installing-and-configuring-insights-iop.adoc | 2 +- .../proc_configuring-podman-network-backend-for-iop.adoc | 2 +- ...proc_installing-insights-iop-by-using-export-and-import.adoc | 2 +- ...ling-insights-iop-on-a-connected-project-context-server.adoc | 2 +- ...talling-insights-iop-with-the-project-context-iso-image.adoc | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc index 8441619f2a4..c320aa4aeb3 100644 --- a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc +++ b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc @@ -14,7 +14,7 @@ Enabling {insights-iop} prevents you from using any {RHCloud} services on hosts * If you install {Project} with external databases, you cannot enable {insights-iop}. Enabling {insights-iop} prevents you from using external databases. * Podman must be configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. +For more information, see xref:configuring-podman-network-backend-for-iop[]. ==== {insights-iop} follows the standard lifecycle policy for {ProjectName}. diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc index 0a0ac6037ad..6fdf6107722 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc @@ -1,6 +1,6 @@ :_mod-docs-content-type: PROCEDURE -[id="configuring-podman-network-backend-for-{insights-iop-id}"] +[id="configuring-podman-network-backend-for-iop"] = Configuring Podman network backend for {insights-iop} [role="_abstract"] diff --git a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc index aae76ad7749..330a7246d2a 100644 --- a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc +++ b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc @@ -21,7 +21,7 @@ ifndef::satellite[] ---- endif::[] * Ensure that Podman on the disconnected {ProjectServer} is configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. +For more information, see xref:configuring-podman-network-backend-for-iop[]. .Procedure . On the connected system, log in to the container registry: diff --git a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc index 57924f9f72c..f6c8681f0b9 100644 --- a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc +++ b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc @@ -19,7 +19,7 @@ ifndef::satellite[] * Ensure that the {ProjectServer} has access to the Quay container registry. endif::[] * Ensure that Podman is installed and configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. +For more information, see xref:configuring-podman-network-backend-for-iop[]. .Procedure diff --git a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc index 154e529d02a..4172e335b49 100644 --- a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc +++ b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc @@ -19,7 +19,7 @@ ifndef::satellite[] ---- endif::[] * Ensure that Podman is configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. +For more information, see xref:configuring-podman-network-backend-for-iop[]. .Procedure . Download and mount the {Project} ISO image: From bb5cb893112bbe1179bb21c3e1ed4a8915ee6e84 Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 15:13:45 +0200 Subject: [PATCH 5/9] fix id and filename --- .../assembly_installing-and-configuring-insights-iop.adoc | 4 ++-- .../modules/con_installing-and-configuring-insights-iop.adoc | 2 +- ...proc_configuring-podman-network-backend-for-insights.adoc} | 2 +- ...oc_installing-insights-iop-by-using-export-and-import.adoc | 2 +- ...ng-insights-iop-on-a-connected-project-context-server.adoc | 2 +- ...lling-insights-iop-with-the-project-context-iso-image.adoc | 2 +- 6 files changed, 7 insertions(+), 7 deletions(-) rename guides/common/modules/{proc_configuring-podman-network-backend-for-iop.adoc => proc_configuring-podman-network-backend-for-insights.adoc} (97%) diff --git a/guides/common/assembly_installing-and-configuring-insights-iop.adoc b/guides/common/assembly_installing-and-configuring-insights-iop.adoc index 89ce49c1267..9da5607ea87 100644 --- a/guides/common/assembly_installing-and-configuring-insights-iop.adoc +++ b/guides/common/assembly_installing-and-configuring-insights-iop.adoc @@ -2,7 +2,7 @@ include::modules/con_installing-and-configuring-insights-iop.adoc[] ifdef::installing-satellite-server-connected[] -include::modules/proc_configuring-podman-network-backend-for-iop.adoc[leveloffset=+1] +include::modules/proc_configuring-podman-network-backend-for-insights.adoc[leveloffset=+1] include::modules/proc_configuring-podman-to-use-an-http-proxy.adoc[leveloffset=+1] @@ -10,7 +10,7 @@ include::modules/proc_installing-insights-iop-on-a-connected-project-context-ser endif::[] ifdef::installing-satellite-server-disconnected[] -include::modules/proc_configuring-podman-network-backend-for-iop.adoc[leveloffset=+1] +include::modules/proc_configuring-podman-network-backend-for-insights.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc[leveloffset=+1] diff --git a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc index c320aa4aeb3..8441619f2a4 100644 --- a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc +++ b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc @@ -14,7 +14,7 @@ Enabling {insights-iop} prevents you from using any {RHCloud} services on hosts * If you install {Project} with external databases, you cannot enable {insights-iop}. Enabling {insights-iop} prevents you from using external databases. * Podman must be configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. ==== {insights-iop} follows the standard lifecycle policy for {ProjectName}. diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc similarity index 97% rename from guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc rename to guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc index 6fdf6107722..0a0ac6037ad 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-iop.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc @@ -1,6 +1,6 @@ :_mod-docs-content-type: PROCEDURE -[id="configuring-podman-network-backend-for-iop"] +[id="configuring-podman-network-backend-for-{insights-iop-id}"] = Configuring Podman network backend for {insights-iop} [role="_abstract"] diff --git a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc index 330a7246d2a..aae76ad7749 100644 --- a/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc +++ b/guides/common/modules/proc_installing-insights-iop-by-using-export-and-import.adoc @@ -21,7 +21,7 @@ ifndef::satellite[] ---- endif::[] * Ensure that Podman on the disconnected {ProjectServer} is configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. .Procedure . On the connected system, log in to the container registry: diff --git a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc index f6c8681f0b9..57924f9f72c 100644 --- a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc +++ b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc @@ -19,7 +19,7 @@ ifndef::satellite[] * Ensure that the {ProjectServer} has access to the Quay container registry. endif::[] * Ensure that Podman is installed and configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. .Procedure diff --git a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc index 4172e335b49..154e529d02a 100644 --- a/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc +++ b/guides/common/modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc @@ -19,7 +19,7 @@ ifndef::satellite[] ---- endif::[] * Ensure that Podman is configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-iop[]. +For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. .Procedure . Download and mount the {Project} ISO image: From a646b07e862bd662ae155fbd072d3fa81d531b8a Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 15:27:32 +0200 Subject: [PATCH 6/9] Fix links and xref --- .../con_installing-and-configuring-insights-iop.adoc | 1 - ...roc_configuring-podman-network-backend-for-insights.adoc | 6 +++--- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc index 8441619f2a4..59cca6208fe 100644 --- a/guides/common/modules/con_installing-and-configuring-insights-iop.adoc +++ b/guides/common/modules/con_installing-and-configuring-insights-iop.adoc @@ -14,7 +14,6 @@ Enabling {insights-iop} prevents you from using any {RHCloud} services on hosts * If you install {Project} with external databases, you cannot enable {insights-iop}. Enabling {insights-iop} prevents you from using external databases. * Podman must be configured to use the netavark network backend. -For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. ==== {insights-iop} follows the standard lifecycle policy for {ProjectName}. diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc index 0a0ac6037ad..f3a35fbb7d3 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc @@ -74,8 +74,8 @@ Ensure that you back up any important container data before proceeding. + The output should show `networkBackend: netavark`. -ifdef::satellite[] .Additional resources -* For more information about switching to netavark, see https://access.redhat.com/solutions/7055981[How to switch to netavark network backend in Podman] in the Red{nbsp}Hat Knowledgebase. -* For alternative workarounds, see https://access.redhat.com/solutions/7029361[Alternative workaround for Podman network backend configuration] in the Red{nbsp}Hat Knowledgebase. +ifdef::satellite[] +* https://access.redhat.com/solutions/7055981[How to switch to netavark network backend in Podman in the Red{nbsp}Hat Knowledgebase] +* https://access.redhat.com/solutions/7029361[Alternative workaround for Podman network backend configuration in the Red{nbsp}Hat Knowledgebase] endif::[] From 6b213d84117ae0e12d5b4101ad654c1567b97f94 Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 15:47:17 +0200 Subject: [PATCH 7/9] Move include out of conditionals --- .../assembly_installing-and-configuring-insights-iop.adoc | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/guides/common/assembly_installing-and-configuring-insights-iop.adoc b/guides/common/assembly_installing-and-configuring-insights-iop.adoc index 9da5607ea87..62ccf6495f7 100644 --- a/guides/common/assembly_installing-and-configuring-insights-iop.adoc +++ b/guides/common/assembly_installing-and-configuring-insights-iop.adoc @@ -1,16 +1,15 @@ include::modules/con_installing-and-configuring-insights-iop.adoc[] -ifdef::installing-satellite-server-connected[] - include::modules/proc_configuring-podman-network-backend-for-insights.adoc[leveloffset=+1] +ifdef::installing-satellite-server-connected[] + include::modules/proc_configuring-podman-to-use-an-http-proxy.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc[leveloffset=+1] endif::[] ifdef::installing-satellite-server-disconnected[] -include::modules/proc_configuring-podman-network-backend-for-insights.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc[leveloffset=+1] From 16eace50c8714e77461ee666e122dd5b292297eb Mon Sep 17 00:00:00 2001 From: jafiala Date: Thu, 9 Jul 2026 17:06:44 +0200 Subject: [PATCH 8/9] Style improvements --- ...c_configuring-podman-network-backend-for-insights.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc index f3a35fbb7d3..ba404145ce6 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc @@ -5,7 +5,7 @@ [role="_abstract"] {insights-iop} requires the netavark network backend for Podman. -Before enabling {insights-iop}, verify that Podman is configured to use netavark. +Before enabling {insights-iop}, verify that the Podman backend is configured to netavark. The Container Network Interface (CNI) network backend and other network backends are not supported. .Prerequisites @@ -25,7 +25,7 @@ endif::[] # podman info | grep networkBackend ---- + -If the output shows `networkBackend: netavark`, your system is already configured correctly. +If the output shows `networkBackend: netavark`, your system is configured correctly. You can proceed to enable {insights-iop}. . If the output shows a different network backend, such as `networkBackend: cni`, migrate to netavark: @@ -57,7 +57,7 @@ Ensure that you back up any important container data before proceeding. # podman system reset ---- -.. Reboot your system: +.. Reboot the system: + [options="nowrap", subs="+quotes,verbatim,attributes"] ---- @@ -65,7 +65,7 @@ Ensure that you back up any important container data before proceeding. ---- .Verification -. After the system reboots, verify that the network backend is set to netavark: +. Verify that the network backend is set to netavark: + [options="nowrap", subs="+quotes,verbatim,attributes"] ---- From 891da4fdd493f4fa6089ac80cc96d0b4c70c7aa9 Mon Sep 17 00:00:00 2001 From: jafiala <56597272+jafiala@users.noreply.github.com> Date: Fri, 10 Jul 2026 09:30:37 +0200 Subject: [PATCH 9/9] Apply suggestions from style review Co-authored-by: Maximilian Kolb --- .../assembly_installing-and-configuring-insights-iop.adoc | 2 -- ...roc_configuring-podman-network-backend-for-insights.adoc | 6 +++--- ...-insights-iop-on-a-connected-project-context-server.adoc | 1 - 3 files changed, 3 insertions(+), 6 deletions(-) diff --git a/guides/common/assembly_installing-and-configuring-insights-iop.adoc b/guides/common/assembly_installing-and-configuring-insights-iop.adoc index 62ccf6495f7..0af605547cf 100644 --- a/guides/common/assembly_installing-and-configuring-insights-iop.adoc +++ b/guides/common/assembly_installing-and-configuring-insights-iop.adoc @@ -3,14 +3,12 @@ include::modules/con_installing-and-configuring-insights-iop.adoc[] include::modules/proc_configuring-podman-network-backend-for-insights.adoc[leveloffset=+1] ifdef::installing-satellite-server-connected[] - include::modules/proc_configuring-podman-to-use-an-http-proxy.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc[leveloffset=+1] endif::[] ifdef::installing-satellite-server-disconnected[] - include::modules/proc_installing-insights-iop-with-the-project-context-iso-image.adoc[leveloffset=+1] include::modules/proc_installing-insights-iop-by-using-export-and-import.adoc[leveloffset=+1] diff --git a/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc index ba404145ce6..7960cbb9cdb 100644 --- a/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc +++ b/guides/common/modules/proc_configuring-podman-network-backend-for-insights.adoc @@ -5,7 +5,7 @@ [role="_abstract"] {insights-iop} requires the netavark network backend for Podman. -Before enabling {insights-iop}, verify that the Podman backend is configured to netavark. +Before enabling {insights-iop}, verify that the Podman backend is configured to use netavark. The Container Network Interface (CNI) network backend and other network backends are not supported. .Prerequisites @@ -65,7 +65,7 @@ Ensure that you back up any important container data before proceeding. ---- .Verification -. Verify that the network backend is set to netavark: +* Verify that the network backend is set to netavark: + [options="nowrap", subs="+quotes,verbatim,attributes"] ---- @@ -74,8 +74,8 @@ Ensure that you back up any important container data before proceeding. + The output should show `networkBackend: netavark`. -.Additional resources ifdef::satellite[] +.Additional resources * https://access.redhat.com/solutions/7055981[How to switch to netavark network backend in Podman in the Red{nbsp}Hat Knowledgebase] * https://access.redhat.com/solutions/7029361[Alternative workaround for Podman network backend configuration in the Red{nbsp}Hat Knowledgebase] endif::[] diff --git a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc index 57924f9f72c..3fbe505c47e 100644 --- a/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc +++ b/guides/common/modules/proc_installing-insights-iop-on-a-connected-project-context-server.adoc @@ -21,7 +21,6 @@ endif::[] * Ensure that Podman is installed and configured to use the netavark network backend. For more information, see xref:configuring-podman-network-backend-for-{insights-iop-id}[]. - .Procedure ifdef::satellite[] . Log in to the Red{nbsp}Hat registry by using Podman: