OBSDOCS-3510: Add channel guidance to prevent installation blocker

[johnwilkins]

Adds troubleshooting guidance for OLM channel version mismatch that blocks operator installation with cryptic 'constraints not satisfiable' error.

During real-world installation testing, discovered that users encounter immediate installation failure when the channel attribute doesn't match available channels on their cluster. The error message is cryptic and doesn't indicate how to discover available channels.

Changes:

• Explain that channel version corresponds to OCP minor version
• Add NOTE with discovery command to list available channels
• Provide troubleshooting guidance when channel mismatch occurs

This prevents the #1 installation blocker identified during testing.

Modules updated:

• modules/installing-the-loki-operator-cli.adoc
• modules/installing-the-clo-cli.adoc

Severity: Important
Cherry-pick required: To all supported branches after merge

Related: OBSDOCS-3462 (testing that discovered this issue)
Testing: Validated on SNO cluster during OBSDOCS-3462 work

Version(s): 6.6-6.1

Issue: https://redhat.atlassian.net/browse/OBSDOCS-3510

Link to docs preview: https://113405--ocpdocs-pr.netlify.app/openshift-logging/latest/installing/installing-the-loki-operator.html
https://113405--ocpdocs-pr.netlify.app/openshift-logging/latest/installing/installing-the-red-hat-openshift-logging-operator.html

QE review:

• QE has approved this change.

Additional information:

[openshift-ci-robot]

@johnwilkins: This pull request references OBSDOCS-3510 which is a valid jira issue.

Details

In response to this:

Adds troubleshooting guidance for OLM channel version mismatch that blocks operator installation with cryptic 'constraints not satisfiable' error.

During real-world installation testing, discovered that users encounter immediate installation failure when the channel attribute doesn't match available channels on their cluster. The error message is cryptic and doesn't indicate how to discover available channels.

Changes:

• Explain that channel version corresponds to OCP minor version
• Add NOTE with discovery command to list available channels
• Provide troubleshooting guidance when channel mismatch occurs

This prevents the #1 installation blocker identified during testing.

Modules updated:

• modules/installing-the-loki-operator-cli.adoc
• modules/installing-the-clo-cli.adoc

Severity: Critical - blocks installation from starting
Cherry-pick required: To all supported branches after merge

Related: OBSDOCS-3462 (testing that discovered this issue)
Testing: Validated on SNO cluster during OBSDOCS-3462 work

Version(s):

Issue:

Link to docs preview:

QE review:

• QE has approved this change.

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[ocpdocs-previewbot]

🤖 Mon Jun 15 21:31:53 - Prow CI generated the docs preview:

https://113405--ocpdocs-pr.netlify.app/openshift-logging/latest/installing/installing-the-loki-operator.html
https://113405--ocpdocs-pr.netlify.app/openshift-logging/latest/installing/installing-the-red-hat-openshift-logging-operator.html

[openshift-ci]

@johnwilkins: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.