IBM Cloud Docs
调试 Portworx 安装

调试 Portworx 安装

虚拟私有云 经典基础架构

通过 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 ks cluster get --cluster <cluster_name_or_ID>

  2. 验证输入的 IBM Cloud API 密钥是否具有足够的许可权来使用集群。 您必须为 IBM Cloud Kubernetes Service 分配编辑器平台访问角色和管理器服务访问角色。 有关更多信息，请参阅用户访问许可权。

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

    1. 检索 Databases for etcd 端点。

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

      示例端点：

      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 服务实例凭证的私钥。
      kubectl get secrets
    3. 确保用户名、密码和证书以 base64 编码值存储在 Kubernetes secret 中。
    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 支持人员。