红帽全球峰会此内容没有您所选择的语言版本。
Chapter 14. Troubleshooting common installation problems
If you are experiencing difficulties installing the Red Hat OpenShift Data Science Add-on, read this section to understand what could be causing the problem, and how to resolve the problem.
If you cannot see the problem here or in the release notes, contact Red Hat Support.
Problem
When attempting to retrieve the Red Hat OpenShift AI Operator from the image registry, an Failure to pull from quay error message appears. The Red Hat OpenShift AI Operator might be unavailable for retrieval in the following circumstances:
- The image registry is unavailable.
- There is a problem with your network connection.
- Your cluster is not operational and is therefore unable to retrieve the image registry.
Diagnosis
Check the logs in the Events section in OpenShift Dedicated for further information about the Failure to pull from quay error message.
Resolution
- To resolve this issue, contact Red Hat support.
Problem
When attempting to install OpenShift AI, an error message appears stating that installation prerequisites have not been met.
Diagnosis
- Log in to OpenShift Cluster Manager (https://console.redhat.com/openshift/).
Click Clusters.
The Clusters page opens.
Click the name of the cluster you want to install OpenShift AI on.
The Details page for the cluster opens.
- Click the Add-ons tab and locate the Red Hat OpenShift Data Science tile.
- Click Install. The Configure Red Hat OpenShift Data Science pane appears.
- If the installation fails, click the Prerequisites tab.
- Note down the error message. If the error message states that you require a new machine pool, or that more resources are required, take the appropriate action to resolve the problem.
Resolution
- You might need to add more resources to your cluster, or increase the size of your machine pool. To increase your cluster’s resources, contact your infrastructure administrator. For more information about increasing the size of your machine pool, see Nodes and Allocating additional resources to OpenShift AI users.
Problem
The Role-based access control (RBAC) policy for the dedicated-admins group in the target project cannot be created. This issue occurs in unknown circumstances.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Attempt to create the RBAC policy for dedicated admins group in $target_project failed.error message.
Resolution
- Contact Red Hat support.
Problem
Customer deploying on an environment not documented as being supported by the RHODS operator.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Deploying on $infrastructure, which is not supported. Failing Installationerror message.
Resolution
Before proceeding with a new installation, ensure that you have a fully supported environment on which to install OpenShift AI. For more information, see Requirements for OpenShift AI.
Problem
During the installation process, the OpenShift AI Custom Resource (CR) does not get created. This issue occurs in unknown circumstances.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Attempt to create the ODH CR failed.error message.
Resolution
Contact Red Hat support.
Problem
During the installation process, the OpenShift AI Notebooks Custom Resource (CR) does not get created. This issue occurs in unknown circumstances.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Attempt to create the RHODS Notebooks CR failed.error message.
Resolution
Contact Red Hat support.
Problem
An issue with Managed Tenants SRE automation process causes the Dead Man’s Snitch operator’s secret to not get created.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Dead Man Snitch secret does not exist.error message.
Resolution
Contact Red Hat support.
14.8. The PagerDuty secret does not get created
Problem
An issue with Managed Tenants SRE automation process causes the PagerDuty’s secret to not get created.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Pagerduty secret does not existerror message.
Resolution
Contact Red Hat support.
14.9. The SMTP secret does not exist
Problem
An issue with Managed Tenants SRE automation process causes the SMTP secret to not get created.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: SMTP secret does not existerror message.
Resolution
Contact Red Hat support.
14.10. The ODH parameter secret does not get created
Problem
An issue with the OpenShift Data Science Add-on’s flow could result in the ODH parameter secret to not get created.
Diagnosis
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Workloads
Pods. - Set the Project to All Projects or redhat-ods-operator.
Click the
rhods-operator-<random string>pod.The Pod details page appears.
- Click Logs.
- Select rhods-deployer from the drop-down list
-
Check the log for the
ERROR: Addon managed odh parameter secret does not exist.error message.
Resolution
Contact Red Hat support.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}