调试您的 Portworx 安装

虚拟私有云 传统基础设施

此故障排除主题仅适用于运行版本 3.11 的 Red Hat OpenShift 集群。

通过 IBM Cloud 目录创建 Portworx 服务实例时，集群中的 Portworx 安装会失败，并且该服务实例会显示 Provision failure 阶段状态。

在集群中安装 Portworx 之前，需要执行若干检查以验证在 IBM Cloud 目录的 Portworx 服务页面上提供的信息。

如果其中一项检查失败，Portworx 服务的阶段状态就会更改为 Provision failure。 您无法查看具体是哪项检查失败，也无法查看完成安装还缺少哪些信息。

请遵循本指南开始对 Portworx 安装进行故障诊断，并验证在 IBM Cloud 目录中输入的信息。

如果发现错误输入了信息，或者必须更改集群的设置，请更正这些信息或集群设置。 然后，创建新的 Portworx 服务实例以重新开始安装。

步骤 1：验证 IBM Cloud 目录信息

首先，验证在 IBM Cloud 目录中输入的信息是否正确。 如果输入的信息不正确，那么安装将无法通过安装前检查并且会失败，不会开始安装。

  1. 验证要安装 Portworx 的集群是否位于所选的 IBM Cloud 区域和资源组中。

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

  2. 验证输入的 IBM Cloud API 密钥是否具有足够的许可权来使用集群。 您必须被授予 “编辑”平台访问角色以及 Red Hat OpenShift on IBM Cloud 的 “管理员”服务访问角色。 有关更多信息，请参阅用户访问许可权。

  3. 验证是否以正确的格式输入了 Databases for etcd 服务实例的 etcd API 端点。

    1. 检索 Databases for etcd 端点。

    2. 以 etcd:<etcd_endpoint1>;etcd:<etcd_endpoint2> 的格式添加 etcd 端点。 如果有多个端点，请包含所有端点，并用分号 (;) 来分隔各端点。

      示例端点：

      etcd:https://1ab234c5-12a1-1234-a123.databases.appdomain.cloud:32059

  4. 验证您是否已将用于访问 Databases for etcd 服务实例的凭证存储在集群的 Kubernetes 私钥中。 有关更多信息，请参阅设置 Databases for etcd 服务实例以存储 Portworx 元数据。

    1. 请检查步骤 4-6，并确认您已获取正确的用户名、密码和证书。
    2. 列出集群中的私钥，然后查找保存 Databases for etcd 服务实例凭证的私钥。
        oc get secrets
    ```
3. 请确保用户名、密码和证书以 base64 编码值的形式存储在您的 Kubernetes 密钥中。
4. 验证是否在 IBM Cloud 目录中输入了正确的私钥名称。

  5. 如果选择使用 IBM Key Protect 来设置卷加密，请确保已在 IBM Key Protect 帐户中创建 IBM Cloud 的实例，并确保将用于访问该实例的凭证存储在集群的 portworx 项目的 Kubernetes 私钥中。 有关更多信息，请参阅对 Portworx 卷启用按卷加密。

    1. 确保服务标识的 API 密钥以及 IBM Key Protect 实例标识、根密钥和 API 端点作为 Base64 值存储在集群的 Kubernetes 私钥中。
    2. 确保已将私钥命名为 px-ibm。
    3. 确保该私钥是在集群的 portworx 项目中创建的。

步骤 2：验证集群设置

如果在 IBM Cloud 目录页面上输入了正确的信息，请验证是否为 Portworx 正确设置了集群。

  1. 请确认您要使用的集群符合 Portworx 的最低硬件要求。
  2. 如果要使用虚拟机集群，请确保已向集群添加未格式化且未安装的原始块存储器，以便 Portworx 可以将磁盘包含在 Portworx 存储层中。

步骤 3：联系 Portworx 和 IBM

请使用下列其中一种方法来联系 Portworx 支持人员。