openshift-docs/modules/cnf-installing-the-operators.adoc

// CNF-950 4.7 Installing the operators
// Module included in the following assemblies:
//
// *scalability_and_performance/cnf-provisioning-and-deploying-a-distributed-unit.adoc

:_mod-docs-content-type: PROCEDURE
[id="cnf-installing-the-operators_{context}"]
= Installing the Operators

[id="cnf-installing-the-performnce-addon-operator_{context}"]
== Installing the Performance Addon Operator

Install the Performance Addon Operator using the {product-title} CLI.

.Procedure

. Create the Performance Addon Operator namespace:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: v1
kind: Namespace
metadata:
  labels:
    openshift.io/cluster-monitoring: "true"
  name: openshift-performance-addon-operator
  annotations:
    workload.openshift.io/allowed: management
spec: {}

EOF
----

. Apply the Operator group:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: performance-addon-operator
  namespace: openshift-performance-addon-operator

EOF
----

. Run the following command to get the `channel` value required for the next step.
+
[source,terminal]
----
$ oc get packagemanifest performance-addon-operator -n openshift-marketplace -o jsonpath='{.status.defaultChannel}'
----
+
.Example output
----
4.6
----

. Apply the Subscription CR:
+
.Example subscription
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: openshift-performance-addon-operator-subscription
  namespace: openshift-performance-addon-operator
spec:
  channel: "<channel>" <1>
  name: performance-addon-operator
  source: redhat-operators <2>
  sourceNamespace: openshift-marketplace
EOF
----
<1> Specify the value you obtained in the previous step for the `status.defaultChannel` parameter.
<2> You must specify the `redhat-operators` value.

[id="cnf-installing-the-precision-time-protocol-operator_{context}"]
== Installing the Precision Time Protocol (PTP) Operator

Install the PTP Operator using the {product-title} CLI or the web console.

.Procedure

. Apply the Operator namespace:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: v1
kind: Namespace
metadata:
  name: openshift-ptp
  annotations:
    workload.openshift.io/allowed: management
  labels:
    openshift.io/cluster-monitoring: "true"
EOF
----

. Apply the Operator group:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: ptp-operators
  namespace: openshift-ptp
spec:
  targetNamespaces:
    - openshift-ptp

EOF
----

. Apply the subscription:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: ptp-operator-subscription
  namespace: openshift-ptp
spec:
  channel: "${OC_VERSION}"
  name: ptp-operator
  source: "redhat-operators"
  sourceNamespace: openshift-marketplace
EOF
----

[id="cnf-applying-the-stream-control-transmission-protocol-patch_{context}"]
== Applying the Stream Control Transmission Protocol (SCTP) patch

Load and enable the SCTP kernel module on worker nodes in your cluster.

.Procedure

. Apply the SCTP machine config patch:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: machineconfiguration.openshift.io/v1
kind: MachineConfig
metadata:
  name: load-sctp-module
  labels:
    machineconfiguration.openshift.io/role: worker-cnf
spec:
  config:
    ignition:
      version: 3.2.0
    storage:
      files:
        - path: /etc/modprobe.d/sctp-blacklist.conf
          mode: 0644
          overwrite: true
          contents:
            source: data:,
        - path: /etc/modules-load.d/sctp-load.conf
          mode: 0644
          overwrite: true
          contents:
            source: data:,sctp
EOF
----

[id="cnf-installing-the-sriov-network-operator_{context}"]
== Installing the SR-IOV Network Operator

Install the SR-IOV Network Operator by using the {product-title} CLI or the web console.

. Apply the SR-IOV Operator namespace:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: v1
kind: Namespace
metadata:
  name: openshift-sriov-network-operator
  annotations:
    workload.openshift.io/allowed: management
EOF
----

. Apply the SR-IOV Operator group:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: sriov-network-operators
  namespace: openshift-sriov-network-operator
spec:
  targetNamespaces:
  - openshift-sriov-network-operator
EOF
----

. Apply the SR-IOV Operator subscription:
+
[source,terminal]
----
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: sriov-network-operator-subscription
  namespace: openshift-sriov-network-operator
spec:
  channel: "${OC_VERSION}"
  name: sriov-network-operator
  source: redhat-operators
  sourceNamespace: openshift-marketplace
EOF
----

[id="cnf-installing-the-operators-verifying-your-changes_{context}"]
== Verifying your changes

Use the following command to verify the changes have been applied to the cluster:

[source,terminal]
----
$ oc wait mcp/worker-cnf --for condition="updated"
----