Débogage de votre installation Portworx

Cloud privé virtuel Infrastructure classique

Cette rubrique de dépannage s'applique uniquement aux clusters d' Red Hat OpenShift qui exécutent la version 3.11.

Lorsque vous créez une instance de service Portworx à partir du catalogue IBM Cloud, l'installation de Portworx dans votre cluster échoue et l'instance de service affiche le statut Echec de la mise à disposition.

Avant l'installation de Portworx dans votre cluster, un certain nombre de vérifications sont effectuées pour contrôler les informations que vous avez fournies sur la page du service Portworx du catalogue IBM Cloud.

En cas d'échec d'une de ces vérifications, le statut du service Portworx passe à Echec de la mise à disposition. Vous ne pouvez pas voir les détails de l'échec de la vérification ou les informations manquantes pour terminer l'installation.

Suivez ce guide pour commencer à traiter les incidents de votre installation Portworx et pour vérifier les informations que vous avez entrées dans le catalogue IBM Cloud.

Si vous recherchez des informations que vous n'avez pas entrées correctement ou si vous devez modifier la configuration de votre cluster, corrigez les informations ou la configuration du cluster. Créez ensuite une nouvelle instance de service Portworx pour relancer l'installation.

Etape 1 : Vérifier les informations du catalogue IBM Cloud

Commencez par vérifier que les informations que vous avez saisies dans le catalogue IBM Cloud sont correctes. Si ce n'est pas le cas, l'installation ne passera pas l'étape des vérifications de pré-installation et échouera sans démarrer l'installation.

  1. Vérifiez que le cluster dans lequel vous voulez installer Portworx se trouve dans la région et le groupe de ressources IBM Cloud que vous avez sélectionnés.

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

  2. Vérifiez que la clé d'API IBM Cloud que vous avez entrée dispose des droits suffisants pour utiliser votre cluster. Vous devez disposer du rôle d'accès à la plateforme Editeur et du rôle d'accès au service Responsable pour Red Hat OpenShift on IBM Cloud. Pour plus d'informations, voir Droits d'accès des utilisateurs.

  3. Vérifiez que le format du noeud final d'API etcd correspondant à votre instance de service Databases for etcd est correct.

    1. Récupérez le noeud final Databases for etcd.

    2. Ajoutez le noeud final etcd au format etcd:<etcd_endpoint1>;etcd:<etcd_endpoint2>. Si vous possédez plusieurs noeuds finaux, incluez-les tous en les séparant par un point-virgule (;).

      Exemple de noeud final :

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

  4. Vérifiez que vous avez stocké les données d'identification permettant d'accéder à votre instance de service Databases for etcd dans un secret Kubernetes dans votre cluster. Pour plus d'informations, voir Configuration d'une instance de service Databases for etcd pour les métadonnées Portworx.

    1. Passez en revue les étapes 4 à 6 et vérifiez que vous avez récupéré le nom d'utilisateur, le mot de passe et le certificat appropriés.
    2. Affichez la liste des secrets figurant dans votre cluster et recherchez celui qui contient les données d'identification pour votre instance de service Databases for etcd.
        oc get secrets
    ```
3. Vérifiez que le nom d'utilisateur, le mot de passe et le certificat sont stockés sous la forme d'une valeur codée en base64 dans votre secret Kubernetes.
4. Vérifiez que vous avez saisi le nom correct du secret dans le catalogue IBM Cloud.

  5. Si vous avez opté pour le chiffrement des volumes avec IBM Key Protect, vérifiez que vous avez créé une instance d'IBM Key Protect dans votre compte IBM Cloud et que vous avez stocké les données d'identification pour accéder à votre instance dans un secret Kubernetes dans le projet portworx de votre cluster. Pour plus d'informations, voir Activation du chiffrement par volume pour vos volumes Portworx.

    1. Vérifiez que la clé d'API de votre ID de service et que l'ID de l'instance IBM Key Protect, la clé racine et le noeud d'API sont stockés sous forme de valeurs codées en base64 dans le secret Kubernetes de votre cluster.
    2. Vérifiez que vous avez nommé le secret px-ibm.
    3. Vérifiez que vous avez créé le secret dans le projet portworx de votre cluster.

Etape 2 : Vérifier la configuration du cluster

Si vous avez saisi les informations correctes sur la page du catalogue IBM Cloud, vérifiez que votre cluster est configuré correctement pour Portworx.

  1. Vérifiez que le cluster que vous souhaitez utiliser répond à la configuration matérielle minimale requise pour Portworx.
  2. Si vous souhaitez utiliser un cluster de machine virtuelle, assurez-vous d'avoir ajouté du stockage par blocs brut, non formaté et non monté dans votre cluster pour que Portworx puisse inclure les disques dans la couche de stockage Portworx.

Etape 3 : Contacter l'équipe Portworx et IBM

Contactez le support Portworx en utilisant l'une des méthodes suivantes.