Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/ossm/ossm2-migration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,4 +126,4 @@ Now you are ready to migrate. Check the `spec.mode` field on your `ServiceMeshCo
oc get smcp <smcp-name> -n <smcp-namespace> -o jsonpath='{.spec.mode}'
```

For `MultiTenant` meshes, follow [these instructions](./multi-tenancy/README.md). For `ClusterWide` meshes, follow [these instructions](#TODO).
For `MultiTenant` meshes, follow [these instructions](./multi-tenancy/README.md). For `ClusterWide` meshes, follow [these instructions](./cluster-wide/README.md). When the migration is finished, follow [these instructions](./cleaning-2.6/README.md) to remove OpenShift Service Mesh 2.6.
63 changes: 63 additions & 0 deletions docs/ossm/ossm2-migration/cleaning-2.6/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# Cleaning of OpenShift Service Mesh 2.6 after migration
When the migration of all workloads is finished, it's possible to remove OpenShift Service Mesh 2.6 installation.

## Remove 2.6 control planes
1. Find all Service Mesh 2.6 resources:
```sh
oc get smcp,smm,smmr -A
```
1. Remove all found `ServiceMeshControlPlane`
```sh
oc delete smcp basic -n istio-system
```
1. Remove all found `ServiceMeshMemberRoll`
```sh
oc delete smmr default -n istio-system
```
1. Remove all found `ServiceMeshMembers`
```sh
oc delete smm default -n bookinfo
```
1. Verify that all resources were removed:
```sh
oc get smcp,smm,smmr -A
No resources found
```

> **_NOTE:_** that depending on how you created `ServiceMeshMembers` and `ServiceMeshMemberRoll`, those resources might be removed automatically with removal of `ServiceMeshControlPlane` after step 2.

## Remove 2.6 operator and CRDs
1. Make sure there are no Service Mesh 2.6 resources left:
```sh
oc get smcp,smm,smmr -A
No resources found
```
1. Remove the operator
```sh
csv=$(oc get subscription servicemeshoperator -n openshift-operators -o yaml | grep currentCSV | cut -f 2 -d ':')
oc delete subscription servicemeshoperator -n openshift-operators
oc delete clusterserviceversion $csv -n openshift-operators
```
1. Remove Maistra CRDs
```sh
oc get crds -o name | grep ".*\.maistra\.io" | xargs -r -n 1 oc delete
```

## Remove Maistra labels
Optionally you can remove namespace labels created during the migration.
1. Following resources should be already removed in previous steps but it's important to be sure there are no Service Mesh 2.6 resources left before removing the label:
```sh
oc get smcp,smm,smmr -A
No resources found
```
1. Find namespaces with the `maistra.io/ignore-namespace="true"` label:
```sh
oc get namespace -l maistra.io/ignore-namespace="true"
NAME STATUS AGE
bookinfo Active 127m
```
1. Remove the label:
```sh
oc label namespace bookinfo maistra.io/ignore-namespace-
namespace/bookinfo unlabeled
```
5 changes: 4 additions & 1 deletion docs/ossm/ossm2-migration/cluster-wide/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -364,4 +364,7 @@ You can now proceed with the migration of next namespace.
> **_NOTE:_** Even with different versions of the proxies, the communication between services should work normally.

> [!CAUTION]
> Do not remove `maistra.io/ignore-namespace="true"` label until the 2.6 control plane is uninstalled.
> Do not remove `maistra.io/ignore-namespace="true"` label until the 2.6 control plane is uninstalled.

### Cleaning of OpenShift Service Mesh 2.6
Follow [these instructions.](../cleaning-2.6/README.md)
2 changes: 2 additions & 0 deletions docs/ossm/ossm2-migration/multi-tenancy/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -302,3 +302,5 @@ oc create ns istio-system-tenant-a
</dl>
...
```
### Cleaning of OpenShift Service Mesh 2.6
Follow [these instructions.](../cleaning-2.6/README.md)