Este contenido no está disponible en el idioma seleccionado.

Chapter 6. Completing the migration


6.1. Completing the Migration

At this stage, you have completed the migration process. It is safe to remove OpenShift Service Mesh 2.6.9.

Optionally, if you already have Kiali installed, before you delete OpenShift Service Mesh 2.6.9, you can verify that all data plane namespaces have been migrated by checking the Kiali Mesh page. To learn more about the Kiali Mesh page, see "Istio infrastructure status (Kiali.io)".

If you did not re-create your network policies before you migrated your deployment and workloads, you can re-create your network policies after migrating.

Prerequisites

  • You have migrated your deployment.
  • You have migrated your workloads.

Procedure

  1. Recreate necessary network policies in the new OpenShift Service Mesh 3 control plane namespace.
  2. Recreate network policies for each namespace that was part of the OpenShift Service Mesh 2 mesh.
  3. Update labels.

    1. Update corresponding network policy selectors to match the new labels.

      Note

      Use a label scoped specifically to your mesh that you can reuse for discovery selectors.

6.1.2. Completing a multitenant deployment with cert-manager

Prerequisites

  • You have migrated a multitenant deployment with the cert-manager and istio-csr tools.

Procedure

  1. Verify that your new injection label is present in all workload namespaces.
  2. Update the app.controller.configmapNamespaceSelector field by running the following command:

    helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
       --install \
       --reuse-values \
       --namespace istio-system \
       --wait \
       --set "app.controller.configmapNamespaceSelector=tenant=tenant-a"
    Copy to Clipboard Toggle word wrap

Next steps

  • Remove OpenShift Service Mesh 2

6.1.3. Remove the Service Mesh 2.6 control plane

After you have migrated all your workloads and gateways, you can remove the OpenShift Service Mesh 2.x control plane.

Prerequisites

  • You have completed migrating your workloads.
  • You have completed migrating your gateways.
  • You are logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.
Note

Depending on how you created ServiceMeshMember and ServiceMeshMemberRoll resources, those resources might be removed automatically with removal of the ServiceMeshControlPlane resource.

Procedure

  1. Find all Service Mesh 2.6 resources by running the following command:

    $ oc get smcp,smm,smmr -A
    Copy to Clipboard Toggle word wrap
  2. Remove all ServiceMeshControlPlane resources by running the following command:

    $ oc delete smcp --all -A
    Copy to Clipboard Toggle word wrap
  3. Remove all ServiceMeshMemberRoll resources by running the following command:

    $ oc delete smmr --all -A
    Copy to Clipboard Toggle word wrap
  4. Remove all ServiceMeshMember resources by running the following command:

    $ oc delete smm --all -A
    Copy to Clipboard Toggle word wrap
  5. Verify that all resources were removed by running the following command:

    $ oc get smcp,smm,smmr -A
    Copy to Clipboard Toggle word wrap

    Example output

    No resources found
    Copy to Clipboard Toggle word wrap

After you remove the Red Hat OpenShift Service Mesh 2 ServiceMeshControlplane resource, and all other OpenShift Service Mesh 2 resources, you can remove the OpenShift Service Mesh 2.6 Operator and custom resource definitions (CRDs).

Prerequisites

  • You have completed migrating your workloads.
  • You have completed migrating your gateways.
  • You have removed the OpenShift Service Mesh 2 ServiceMeshControlPlane resource.
  • You have removed all other OpenShift Service Mesh 2 resources.
  • You are logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.

Procedure

  1. Check that there are no Red Hat OpenShift Service Mesh 2.6 resources left by running the following command:

    $ oc get smcp,smm,smmr -A
    Copy to Clipboard Toggle word wrap

    Example output

    No resources found
    Copy to Clipboard Toggle word wrap

  2. Remove the Operator by running the following commands:

    1. Find the Operator subscription:

      csv=$(oc get subscription servicemeshoperator -n openshift-operators -o yaml | grep currentCSV | cut -f 2 -d ':')
      Copy to Clipboard Toggle word wrap
    2. Delete the subscription:

      $ oc delete subscription servicemeshoperator -n openshift-operators
      Copy to Clipboard Toggle word wrap
    3. Delete the clusterserviceversion CSV:

      $ oc delete clusterserviceversion $csv -n openshift-operators
      Copy to Clipboard Toggle word wrap
  3. Remove maistra CRDs by running the following command:

    $ oc get crds -o name | grep ".*\.maistra\.io" | xargs -r -n 1 oc delete
    Copy to Clipboard Toggle word wrap

6.1.5. Remove the Maistra labels

After you have removed all OpenShift Service Mesh 2 resources, removed the OpenShift Service Mesh 2 Operator, and OpenShift Service Mesh 2 custom resource definitions (CRDs), you can choose to remove namespace labels created during the migration.

Prerequisites

  • You have completed migrating your workloads.
  • You have completed migrating your gateways.
  • You have removed the OpenShift Service Mesh 2 ServiceMeshControlPlane resource.
  • You have removed all other OpenShift Service Mesh 2 resources.
  • You have removed the OpenShift Service Mesh 2 Operator.
  • You have removed the OpenShift Service Mesh 2 CRDs.
  • You are logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.

Procedure

  1. Verify that all OpenShift Service Mesh 2.6 resources have been removed by running the following command:

    $ oc get smcp,smm,smmr -A
    Copy to Clipboard Toggle word wrap

    Example output

    No resources found
    Copy to Clipboard Toggle word wrap

  2. Find namespaces with the maistra.io/ignore-namespace="true" label by running the following command:

    $ oc get namespace -l maistra.io/ignore-namespace="true"
    Copy to Clipboard Toggle word wrap

    Example output

    NAME       STATUS   AGE
    bookinfo   Active   127m
    Copy to Clipboard Toggle word wrap

  3. Remove the label by running the following command:

    $ oc label namespace bookinfo maistra.io/ignore-namespace-
    Copy to Clipboard Toggle word wrap

    Example output

    namespace/bookinfo unlabeled
    Copy to Clipboard Toggle word wrap

Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat