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 meta 資料。

    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. 確保服務 ID 的 API 金鑰以及 IBM Key Protect 實例 ID、根金鑰和 API 端點作為 Base64 值儲存在叢集的 Kubernetes 密碼中。
    2. 確保已將密碼命名為 px-ibm。
    3. 確保該密碼是在叢集的 portworx 專案中建立的。

步驟 2：驗證叢集設定

如果在 IBM Cloud 型錄頁面上輸入了正確的資訊，請驗證是否為 Portworx 正確設定了叢集。

  1. 請確認您要使用的叢集符合 Portworx 的最低硬體需求。
  2. 如果要使用虛擬機器叢集，請確保已向叢集新增未格式化且未安裝的原始區塊儲存空間，以便 Portworx 可以將磁碟包含在 Portworx 儲存空間層中。

步驟 3：聯繫 Portworx 和 IBM

請使用下列其中一種方法來聯絡 Portworx 支援中心。