Skip to content

Commit e62710e

Browse files
authored
Merge pull request #46748 from rohennes/conPR-telcodocs-593
TELCODOCS-593: Removing PAO subscriptions from deployed clusters
2 parents 711e13b + c3e2250 commit e62710e

File tree

2 files changed

+58
-0
lines changed

2 files changed

+58
-0
lines changed
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
// Module included in the following assemblies:
2+
// Epic CNF-4767 (4.11), Story TELCODOCS-593
3+
// * scalability_and_performance/ztp-deploying-disconnected.adoc
4+
5+
:_content-type: PROCEDURE
6+
[id="talm-PAO-update_{context}"]
7+
= Removing Performance Addon Operator subscriptions from deployed clusters
8+
9+
In earlier versions of {product-title}, the Performance Addon Operator provided automatic, low latency performance tuning for applications. In {product-title} 4.11 or later, these functions are part of the Node Tuning Operator.
10+
11+
Do not install the Performance Addon Operator on clusters running {product-title} 4.11 or later. If you upgrade to {product-title} 4.11 or later, the Node Tuning Operator automatically removes the Performance Addon Operator. However, you need to manually remove any policies that create Performance Addon Operator subscriptions to prevent a reinstallation of the Operator. The reference DU profile includes the Performance Addon Operator in the `common-ranGen.yaml` `PolicyGenTemplate`. To remove the subscription from deployed spoke clusters, you must update `common-ranGen.yaml`.
12+
13+
[NOTE]
14+
====
15+
If you install Performance Addon Operator 4.10.3-5 or later on {product-title} 4.11 or later, the Performance Addon Operator detects the cluster version and automatically hibernates to avoid interfering with the Node Tuning Operator functions. However, to ensure best performance, remove the Performance Addon Operator from your {product-title} 4.11 clusters.
16+
====
17+
18+
19+
.Prerequisites
20+
21+
* Create a Git repository where you manage your custom site configuration data. The repository must be accessible from the hub cluster and be defined as a source repository for Argo CD.
22+
* Update to {product-title} 4.11 or later.
23+
* Log in as a user with `cluster-admin` privileges.
24+
25+
.Procedure
26+
27+
. Change the `complianceType` to `mustnothave` for the Performance Addon Operator namespace, Operator group, and subscription in the `common-ranGen.yaml` file.
28+
+
29+
[source,yaml]
30+
----
31+
- fileName: PaoSubscriptionNS.yaml
32+
policyName: "subscriptions-policy"
33+
complianceType: mustnothave
34+
- fileName: PaoSubscriptionOperGroup.yaml
35+
policyName: "subscriptions-policy"
36+
complianceType: mustnothave
37+
- fileName: PaoSubscription.yaml
38+
policyName: "subscriptions-policy"
39+
complianceType: mustnothave
40+
----
41+
+
42+
. Merge the changes with your custom site repository and wait for the ArgoCD application to synchronize the change to the hub cluster. The status of the `common-subscriptions-policy` policy changes to `Non-Compliant`.
43+
. Apply the change to your target clusters by using the {cgu-operator-full}. For more information about rolling out configuration changes, see the _Additional resources_ section.
44+
. Monitor the process. When the status of the `common-subscriptions-policy` policy for a target cluster is `Compliant`, the Performance Addon Operator has been removed from the cluster. Get the status of the `common-subscriptions-policy` by running the following command:
45+
+
46+
[source,terminal]
47+
----
48+
$ oc get policy -n common-subscriptions-policy
49+
----
50+
+
51+
. Delete the Performance Addon Operator namespace, Operator group and subscription CRs from `.spec.sourceFiles` in the `common-ranGen.yaml` file.
52+
. Merge the changes with your custom site repository and wait for the ArgoCD application to synchronize the change to the hub cluster. The policy remains compliant.

scalability_and_performance/ztp-deploying-disconnected.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -250,5 +250,11 @@ include::modules/cnf-topology-aware-lifecycle-manager-operator-update.adoc[level
250250

251251
* For more information about updating GitOps ZTP, see xref:../scalability_and_performance/ztp-deploying-disconnected.adoc#ztp-upgrading-gitops-ztp_ztp-deploying-disconnected[Upgrading GitOps ZTP].
252252
253+
include::modules/cnf-topology-aware-lifecycle-manager-PAO-update.adoc[leveloffset=+2]
254+
255+
[role="_additional-resources"]
256+
.Additional resources
257+
258+
* xref:../scalability_and_performance/ztp-deploying-disconnected.adoc#ztp-roll-out-the-configuration-changes_ztp-deploying-disconnected[Upgrading GitOps ZTP].
253259
254260
include::modules/cnf-topology-aware-lifecycle-manager-operator-and-platform-update.adoc[leveloffset=+2]

0 commit comments

Comments
 (0)