Merge pull request #74739 from ShaunaDiaz/OSDOCS-9428

OSDOCS-9428: install multus running cluster MicroShift

Author: ShaunaDiaz

microshift_networking/microshift_multiple_networks/microshift-cni-multus.adoc

@@ -9,3 +9,7 @@ toc::[]
 In addition to the default OVN-Kubernetes Container Network Interface (CNI) plugin, {microshift-short} uses the Multus CNI to chain other CNI plugins.
 
 include::modules/microshift-multus-intro.adoc[leveloffset=+1]
+
+//TODO: add more detail on supported plugins
+
+include::modules/microshift-install-multus-running-cluster.adoc[leveloffset=+1]

modules/microshift-install-multus-running-cluster.adoc

@@ -0,0 +1,61 @@
+// Module included in the following assemblies:
+//
+// * microshift_networking/microshift-cni-multus.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="microshift-multus-installing-on-running-cluster_{context}"]
+= Installing the Multus CNI plugin on a running cluster
+
+If you want to attach additional networks to a pod for high-performance network configurations, you can install the {microshift-short} Multus RPM package. After installation, a host restart is required to recreate all the pods with the Multus annotation.
+
+[IMPORTANT]
+====
+Uninstalling the Multus CNI plugin is not supported.
+====
+
+.Prerequisites
+
+. You have root access to the host.
+
+.Procedure
+
+. Install the Multus RPM package by running the following command:
++
+[source,terminal]
+----
+$ sudo dnf install microshift-multus
+----
++
+[TIP]
+====
+If you create your custom resources (CRs) for additional networks now, you can complete your installation and apply configurations with one restart.
+====
+
+. To apply the package manifest to an active cluster, restart the host by running the following command:
++
+[source,terminal]
+----
+$ sudo systemctl restart
+----
+
+.Verification
+
+. After restarting, ensure that the Multus CNI plugin components are created by running the following command:
++
+[source,terminal]
+----
+$ oc get pod -A | grep multus
+----
++
+.Example output
+[source,terminal]
+----
+openshift-multus      dhcp-daemon-ktzqf     1/1   Running   0     45h
+openshift-multus      multus-4frf4          1/1   Running   0     45h
+----
+
+.Next steps
+
+. If you have not done so, configure and apply the additional networks you want to use.
+
+. Deploy your applications that use the created CRs.