networkBackend

skupperproject · Nov 15, 2024 · 25cb5a3 · 25cb5a3
1 parent f8cc4c8
commit 25cb5a3
Show file tree

Hide file tree

Showing 2 changed files with 37 additions and 21 deletions.
diff --git a/cli/networkBackend.adoc b/cli/networkBackend.adoc
@@ -0,0 +1,35 @@
+include::../partials/attributes.adoc[]
+// Category: skupper-cli
+// Type: procedure
+[id='podman-networkbackend']
+= Configuring Podman networkBackend for {skupper-name}
+
+By default, Podman v4 and later use Netavark which works with {skupper-name}.
+However, if you upgraded from an earlier version of Podman, you might need to configure Podman to use Netavark.
+
+If you are using CNI, for example, if you upgrade from Podman v3, you must also install the `podman-plugins` package.
+For example, `dnf install podman-plugins` for RPM based distributions.
+
+NOTE: CNI will be deprecated in the future in preference of Netavark.
+
+.Procedure
+
+. To install `netavark` on rpm based Linux, for example, RHEL8:
++
+----
+$ sudo dnf install netavark
+----
+
+. Configure podman to use `netavark` by making sure the following lines exist in the `/etc/containers/containers.conf` file:
++
+----
+[network]
+network_backend = "netavark"
+----
+
+. Confirm that `netavark` is configured as the podman network backend:
++
+----
+$ podman info --format {{.Host.NetworkBackend}}
+----
+
diff --git a/cli/podman.adoc b/cli/podman.adoc
@@ -68,32 +68,13 @@ See link:{cli-link} for information about using the Skupper CLI to create Podman
 * `netavark` is configured as the podman network backend.
 +
 --
-By default, Podman v4 uses Netavark which works with Skupper.
-
-If you are using CNI, for example, if you upgrade from Podman v3, you must also install the `podman-plugins` package.
-For example, `dnf install podman-plugins` for RPM based distributions.
-
-NOTE: CNI will be deprecated in the future in preference of Netavark.
-
 To check if `netavark` is configured as the podman network backend:
 
 ----
-$ podman info | grep networkBackend
-----
-
-To install `netavark` on rpm based Linux, eg RHEL8:
-
-----
-$ sudo dnf install netavark
-----
-
-Configure podman to use `netavark` by making sure the following lines exist in the `/etc/containers/containers.conf` file:
-
-----
-[network]
-network_backend = "netavark"
+$ podman info --format {{.Host.NetworkBackend}}
 ----
 
+If the output is something other than `netavark`, see link:networkBackend.adoc[Configuring Podman networkBackend for {skupper-name}].
 
 --