Installing the Operators

Maistra requires the ElasticSearch, Jaeger, and Kiali operators to be installed before Maistra operator itself can be installed. Please reference documentation on adding operators to a cluster for detailed instructions on how to install operators using OLM.

Installing the Maistra Operator

Open the OpenShift web console in a Web browser and:

  • Navigate to CatalogOperatorHub.

  • Select the community Maistra Operator to display information about the Operator.

  • Click Install. On the Create Operator Subscription page, selecting All namespaces on the cluster (default).

  • Select either Automatic or Manual approval strategy. Click Subscribe.

This installs the Maistra operator and makes it available to all projects in the cluster.

Verifying Installation

The above instructions will create a new deployment within the istio-operator project, executing the operator responsible for managing the state of the Istio control plane through the ServiceMeshControlPlane.

To verify the operator is installed correctly, wait for the operator to reach the running state

$ oc get pods -n openshift-operators -l name=istio-operator

NAME                              READY     STATUS    RESTARTS   AGE
istio-operator-5cd6bcf645-fvb57   1/1       Running   0          1h

Removing the Operator

Removing the Maistra Operator

Open the OpenShift web console in a Web browser and:

  • Navigate to CatalogOperator Management.

  • Select the openshift-operators project from the Projects drop-down.

  • Locate the Maistra operator and click View Subscription.

  • Click the More Operations menu and select Remove Subscription.

The Maistra operator creates several resources that are not managed by OLM (OperatorHub). These must be removed manually after uninstalling the Maistra operator. As a cluster administrator, execute the following commands.

$ oc delete  validatingwebhookconfiguration/<operator-namespace>.servicemesh-resources.maistra.io
$ oc delete -n <operator-namespace> daemonset/istio-node
$ oc delete clusterrole/istio-admin
$ oc get crds -o name | grep '.*\.istio\.io' |xargs -r -n 1 oc delete
$ oc get crds -o name | grep '.*\.maistra\.io' |xargs -r -n 1 oc delete

Removing the Kiali Operator

Open the OpenShift web console in a Web browser and:

  • Navigate to CatalogOperator Management.

  • Select the openshift-operators project from the Projects drop-down.

  • Locate the Kiali operator and click View Subscription.

  • Click the More Operations menu and select Remove Subscription.

Removing the Jaeger Operator

Open the OpenShift web console in a Web browser and:

  • Navigate to CatalogOperator Management.

  • Select the openshift-operators project from the Projects drop-down.

  • Locate the Jaeger operator and click View Subscription.

  • Click the More Operations menu and select Remove Subscription.

Removing the Elasticsearch Operator

Open the OpenShift web console in a Web browser and:

  • Navigate to CatalogOperator Management.

  • Select the openshift-operators project from the Projects drop-down.

  • Locate the Elasticsearch operator and click View Subscription.

  • Click the More Operations menu and select Remove Subscription.