Chapter 2. Installing the Operator

Procedure

1. Log in to OpenShift as a cluster administrator. For example:

   $ oc login -u system:admin

2. Complete the steps described in Red Hat Container Registry Authentication.

3. Create a file named subscription-all.yaml with the following:

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: skupper-operator
     namespace: openshift-operators
   spec:
     channel: stable-1
     installPlanApproval: Automatic
     name: skupper-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: skupper-operator.v1.5.3-rh-1

   Note

   If you want to keep updates confined to 1.5.x releases, set the value of channel to stable-1.5.

   If you do not specify startingCSV, the subscription defaults to the latest operator version.

   If you specify installPlanApproval as Manual, sites are not automatically upgraded to the latest version of Service Interconnect. See Chapter 4, Upgrading the Red Hat Service Interconnect Operator and sites for information on manually upgrading sites.

4. Apply the subscription YAML:

   $ oc apply -f subscription-all.yaml

Procedure

1. Log in to OpenShift as a cluster administrator. For example:

   $ oc login -u system:admin

2. Complete the steps described in Red Hat Container Registry Authentication.

3. Create an Operator group in the namespace where you want to create a site:

   1. Create a file named operator-group.yaml with the following:

      kind: OperatorGroup
      apiVersion: operators.coreos.com/v1
      metadata:
        name: skupper-operator
        namespace: my-namespace
      spec:
        targetNamespaces:
        - my-namespace

      where my-namespace is the name of the namespace you want to create the site.

   2. Apply the Operator group YAML:

      $ oc apply -f operator-group.yaml

4. Create a file named subscription-myns.yaml with the following:

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: skupper-operator
     namespace: my-namespace
   spec:
     channel: stable-1
     installPlanApproval: Automatic
     name: skupper-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: skupper-operator.v1.5.3-rh-1

   where my-namespace is the name of the namespace you want to create the site.

   Note

   If you want to keep updates confined to 1.5.x releases, set the value of channel to stable-1.5.

   If you do not specify startingCSV, the subscription defaults to the latest operator version.

   If you specify installPlanApproval as Manual, sites are not automatically upgraded to the latest version of Service Interconnect. See Chapter 4, Upgrading the Red Hat Service Interconnect Operator and sites for information on manually upgrading sites.

5. Apply the subscription YAML:

   $ oc apply -f subscription-myns.yaml

Procedure

1. In the OpenShift web console, navigate to Operators OperatorHub.
2. Choose Red Hat Service Interconnect Operator from the list of available Operators, and then click Install.

3. On the Operator Installation page, two Installation mode options are available:

   • All namespaces on the cluster

   • A specific namespace on the cluster

     For this example, choose A specific namespace on the cluster.

4. Choose an Update approval option.

   By default, Automatic approval is selected, and sites will upgrade to the latest version of Service Interconnect. If you choose Manual approval, sites will not be automatically upgraded to the latest version of Service Interconnect. See Chapter 4, Upgrading the Red Hat Service Interconnect Operator and sites for information on manually upgrading sites.

5. Select the namespace into which you want to install the Operator, and then click Install.

   The Installed Operators page appears displaying the status of the Operator installation.

6. Verify that the Red Hat Service Interconnect Operator is displayed and wait until the Status changes to Succeeded.

7. If the installation is not successful, troubleshoot the error:

   1. Click Red Hat Service Interconnect Operator on the Installed Operators page.
   2. Select the Subscription tab and view any failures or errors.