1.9. Creating the ServiceMeshControlPlane

Procedure

1. Log in to the OpenShift Container Platform web console as a user with the cluster-admin role. If you use Red Hat OpenShift Dedicated, you must have an account with the dedicated-admin role.

2. Create a project named istio-system.

   1. Navigate to Home Projects.
   2. Click Create Project.

   3. In the Name field, enter istio-system. The ServiceMeshControlPlane resource must be installed in a project that is separate from your microservices and Operators.

      These steps use istio-system as an example, but you can deploy your Service Mesh control plane in any project as long as it is separate from the project that contains your services.

   4. Click Create.
3. Navigate to Operators Installed Operators.
4. Click the Red Hat OpenShift Service Mesh Operator, then click Istio Service Mesh Control Plane.

5. On the Istio Service Mesh Control Plane tab, click Create ServiceMeshControlPlane.

   1. Accept the default Service Mesh control plane version to take advantage of the features available in the most current version of the product. The version of the control plane determines the features available regardless of the version of the Operator.
   2. Click Create.

   The Operator creates pods, services, and Service Mesh control plane components based on your configuration parameters. You can configure ServiceMeshControlPlane settings at a later time.

Procedure

1. Create a project named istio-system.

   $ oc new-project istio-system

2. Create a ServiceMeshControlPlane file named istio-installation.yaml using the following example. The version of the Service Mesh control plane determines the features available regardless of the version of the Operator.

   Example version 2.5 istio-installation.yaml

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.5
     tracing:
       type: None
       sampling: 10000
     addons:
       kiali:
         enabled: true
         name: kiali
       grafana:
         enabled: true

3. Run the following command to deploy the Service Mesh control plane, where <istio_installation.yaml> includes the full path to your file.

   $ oc create -n istio-system -f <istio_installation.yaml>

4. To watch the progress of the pod deployment, run the following command:

   $ oc get pods -n istio-system -w

   You should see output similar to the following:

   NAME                                   READY   STATUS    RESTARTS   AGE
   grafana-b4d59bd7-mrgbr                 2/2     Running   0          65m
   istio-egressgateway-678dc97b4c-wrjkp   1/1     Running   0          108s
   istio-ingressgateway-b45c9d54d-4qg6n   1/1     Running   0          108s
   istiod-basic-55d78bbbcd-j5556          1/1     Running   0          108s
   jaeger-67c75bd6dc-jv6k6                2/2     Running   0          65m
   kiali-6476c7656c-x5msp                 1/1     Running   0          43m
   prometheus-58954b8d6b-m5std            2/2     Running   0          66m

1. Prerequisites

   • The Red Hat OpenShift Service Mesh Operator must be installed.
   • Access to the OpenShift CLI (oc).
   • You are logged in to OpenShift Container Platform as`cluster-admin`.

Procedure

1. Run the following command to verify the Service Mesh control plane installation, where istio-system is the namespace where you installed the Service Mesh control plane.

   $ oc get smcp -n istio-system

   The installation has finished successfully when the STATUS column is ComponentsReady.

   NAME    READY   STATUS            PROFILES      VERSION   AGE
   basic   10/10   ComponentsReady   ["default"]   2.5.2     66m