Create SMCP :: Maistra.io -- Istio for OpenShift

Create SMCP

You can deploy a basic installation of the ServiceMeshControlPlane by using either the OpenShift Container Platform web console or from the command line using the oc client tool.

Note	The Maistra documentation uses `istio-system` as the example project, but you can deploy the service mesh to any project.

Note	This basic installation is configured based on the default OpenShift settings and is not designed for production use. Use this default installation to verify your installation, and then configure your `ServiceMeshControlPlane` for your environment.

Deploying the control plane from the web console

You can deploy a basic ServiceMeshControlPlane by using the web console. In this example, istio-system is the name of the control plane project.

Prerequisites

The Maistra Service Mesh Operator must be installed.
An account with the cluster-admin role.

Procedure

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.
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 control plane in any project as long as it is separate from the project that contains your services.
4. Click Create.
Navigate to Operators → Installed Operators.
Click the Maistra Service Mesh Operator, then click Istio Service Mesh Control Plane.
On the Istio Service Mesh Control Plane tab, click Create ServiceMeshControlPlane.
On the Create ServiceMeshControlPlane page, accept the default 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.

You can configure ServiceMeshControlPlane settings later. For more information, see Configuring Maistra Service Mesh.
1. Click Create. The Operator creates pods, services, and Maistra control plane components based on your configuration parameters.
To verify the control plane installed correctly, click the Istio Service Mesh Control Plane tab.
1. Click the name of the new control plane.
2. Click the Resources tab to see the Maistra Service Mesh control plane resources the Operator created and configured.

Deploying the control plane from the CLI

You can deploy a basic ServiceMeshControlPlane from the command line.

Prerequisites

The Maistra Service Mesh Operator must be installed.
Access to the OpenShift CLI (oc).

Procedure

Log in to the OpenShift Container Platform CLI 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.
```
$ oc login https://{HOSTNAME}:6443
```
Create a project named istio-system.
```
$ oc new-project istio-system
```

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

Example version 2.0 istio-installation.yaml

apiVersion: maistra.io/v2
kind: ServiceMeshControlPlane
metadata:
  name: basic
  namespace: istio-system
spec:
  version: v2.0
  tracing:
    type: Jaeger
    sampling: 10000
  addons:
    jaeger:
      name: jaeger
      install:
        storage:
          type: Memory
    kiali:
      enabled: true
      name: kiali
    grafana:
      enabled: true

Run the following command to deploy the control plane, where <istio_installation.yaml> includes the full path to your file.
```
$ oc create -n istio-system -f <istio_installation.yaml>
```
Run the following command to verify the control plane installation.
```
$ oc get smcp -n istio-system
```
The installation has finished successfully when the STATUS column is ComponentsReady.

Maistra Service Mesh supports multiple independent control planes within the cluster. You can create reusable configurations with ServiceMeshControlPlane profiles. For more information, see Creating control plane profiles.

Next steps

Create a ServiceMeshMemberRoll resource to specify the namespaces associated with the Maistra. For more information, see Adding services to a service mesh.