Bug 1974154

Summary: update Troubleshooting Operator groups because of new story OLM-2116
Product: OpenShift Container Platform Reporter: kuiwang
Component: DocumentationAssignee: Alex Dellapenta <adellape>
Status: CLOSED CURRENTRELEASE QA Contact: kuiwang
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 4.8CC: aos-bugs, jokerman
Target Milestone: ---   
Target Release: 4.8.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-07-28 14:13:20 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description kuiwang 2021-06-21 00:44:09 UTC
Document URL: 
https://docs.openshift.com/container-platform/4.8/operators/understanding/olm/olm-understanding-operatorgroups.html#olm-operatorgroups-troubleshooting_olm-understanding-operatorgroups
Section Number and Name: 

section Troubleshooting Operator groups

Describe the issue: 

currently for "If more than one Operator group exists in a single namespace, any CSV created in that namespace transitions to a failure state with the reason TooManyOperatorGroups. CSVs in a failed state for this reason transition to pending after the number of Operator groups in their namespaces reaches one.", it is not suitable after OLM-2116.

With OLM-2116, csv will not genereated, and InstallPlan fails with error message.

“attenuated service account query failed - more than one operator group(s) are managing this namespace count=2”, here 2 is the number of og

the example is here:
--
{
    "lastTransitionTime": "2021-04-07T08:31:34Z",
    "lastUpdateTime": "2021-04-07T08:31:34Z",
    "message": "attenuated service account query failed - more than one operator group(s) are managing this namespace count=2",
    "reason": "InstallCheckFailed",
    "status": "False",
    "type": "Installed"
  }
--

Suggestions for improvement: 

Please remove existing descriptions. and add new description to indicate that we need to trouble shooting with Installplan if the og is more than one in one ns.

Additional information:

Comment 1 Alex Dellapenta 2021-06-28 22:17:11 UTC
PR: https://github.com/openshift/openshift-docs/pull/34071

Comment 2 kuiwang 2021-06-29 00:54:26 UTC
verified it.

After it is merged, I will change it to VERIFIED.

Comment 3 Alex Dellapenta 2021-06-29 01:13:14 UTC
Thank you! PR is now merged.