Portworx インストールのデバッグ

仮想プライベートクラウド クラシック・インフラストラクチャー

このトラブルシューティングのトピックは、バージョン 3.11 を実行している Red Hat OpenShift クラスターにのみ適用されます。

IBM Cloud カタログから Portworx サービス・インスタンスを作成すると、クラスターへの Portworx のインストールが失敗し、サービス・インスタンスの状況に**「プロビジョン失敗」**と表示されます。

Portworx をクラスターにインストールする前に、IBM Cloud カタログの Portworx サービス・ページに指定された情報を検証するためにいくつかの検査が実行されます。

その検査のいずれかに失格すると、Portworx サービスの状況が**「プロビジョン失敗」**に変わります。 インストールを完了するために失敗したチェックや欠落している情報の詳細は表示されません。

このガイドに従って、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:<etcd_endpoint1>;etcd:<etcd_endpoint2> の形式で追加します。 複数のエンドポイントがある場合は、すべてのエンドポイントを追加して、それらをセミコロン (;) で区切ります。

      エンドポイントの例:

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

  4. Databases for etcd サービス・インスタンスにアクセスするための資格情報をクラスター内の Kubernetes シークレットに保管したことを確認します。 詳しくは、Portworx メタデータ用の Databases for etcd サービス・インスタンスのセットアップを参照してください。

    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 エンドポイントが、クラスターの Kubernetes シークレットに base64 値として保管されていることを確認します。
    2. シークレットの名前を px-ibm としたことを確認します。
    3. クラスターの portworx プロジェクト内にシークレットを作成したことを確認します。

ステップ 2: クラスター・セットアップの検証

IBM Cloud カタログ・ページに入力した情報が正しかった場合は、クラスターが Portworx 用に正しくセットアップされていることを確認します。

  1. 使用するクラスターが、 Portworx のハードウェアの最小要件を満たしていることを確認してください。
  2. 仮想マシンのクラスターを使用する場合、Portworx がディスクを Portworx ストレージ層に含められるように、クラスターにマウントされていない未フォーマットのロー・ブロック・ストレージを追加したことを確認します。

ステップ 3: Portworx と IBM への連絡

以下のいずれかの方法を使用して、 Portworx サポートに連絡します。