Risoluzione dei problemi nell'installazione di Portworx

Virtual Private Cloud Infrastruttura classica

Questa guida alla risoluzione dei problemi si applica esclusivamente ai cluster di Red Hat OpenShift che utilizzano la versione 3.11.

Quando crei un'istanza del servizio Portworx dal catalogo IBM Cloud, l'installazione di Portworx nel tuo cluster non riesce e l'istanza del servizio mostra lo stato Errore di provisioning.

Prima dell'installazione di Portworx nel tuo cluster, vengono eseguiti numerosi controlli per verificare le informazioni che hai fornito nella pagina del servizio Portworx del catalogo IBM Cloud.

Se uno di questi controlli non riesce, lo stato del servizio Portworx viene modificato in Errore di provisioning. Non è possibile visualizzare i dettagli relativi all'errore verificatosi o alle informazioni mancanti necessarie per completare l'installazione.

Segui questa guida per iniziare a risolvere i problemi relativi all'installazione di Portworx e per verificare le informazioni che hai immesso nel catalogo IBM Cloud.

Se trovi informazioni che hai immesso in modo errato o devi modificare la configurazione del tuo cluster, correggi le informazioni o la configurazione del cluster. Quindi, crea una nuova istanza del servizio Portworx per riavviare l'installazione.

Passo 1: verifica delle informazioni del catalogo IBM Cloud

Inizia verificando che le informazioni che hai immesso nel catalogo IBM Cloud siano corrette. Se le informazioni sono state immesse in modo errato, l'installazione non supera i controlli di pre-installazione e pertanto non viene avviata.

  1. Verifica che il cluster in cui vuoi installare Portworx si trovi nella regione e nel gruppo di risorse IBM Cloud che hai selezionato.

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

  2. Verifica che la chiave API IBM Cloud che hai immesso disponga di autorizzazioni sufficienti per lavorare con il tuo cluster. È necessario che ti siano stati assegnati il ruolo di accesso alla piattaforma “Editor” e il ruolo di accesso al servizio “Manager” per Red Hat OpenShift on IBM Cloud. Per ulteriori informazioni, vedi Autorizzazioni di accesso utente.

  3. Verifica che l'endpoint API etcd per la tua istanza del servizio Databases for etcd sia stato immesso nel formato corretto.

    1. Richiama l'endpoint di Databases for etcd.

    2. Aggiungi l'endpoint etcd nel formato etcd:<etcd_endpoint1>;etcd:<etcd_endpoint2>. Se hai più di un endpoint, includili tutti e separali con un punto e virgola (;).

      Endpoint di esempio:

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

  4. Verifica di aver archiviato le credenziali per accedere alla tua istanza del servizio Databases for etcd in un segreto Kubernetes nel tuo cluster. Per ulteriori informazioni, vedi Configurazione di un'istanza del servizio Databases for etcd per i metadati Portworx.

    1. Rivedi i passi 4-6 e verifica di aver richiamato il nome utente, la password e il certificato corretti.
    2. Elenca i segreti nel tuo cluster e cerca il segreto che contiene le credenziali della tua istanza del servizio Databases for etcd.
        oc get secrets
    ```
3. Assicurati che il nome utente, la password e il certificato siano archiviati come valore con codifica base64 nel tuo segreto Kubernetes.
4. Verifica di aver immesso il nome corretto del segreto nel catalogo IBM Cloud.

  5. Se scegli di configurare la crittografia del volume con IBM Key Protect, assicurati di aver creato un'istanza di IBM Key Protect nel tuo account IBM Cloud e di aver archiviato le credenziali per accedere alla tua istanza in un segreto Kubernetes nel progetto portworx del tuo cluster. Per ulteriori informazioni, vedi Abilitazione della crittografia per ogni singolo volume per i tuoi volumi Portworx.

    1. Assicurati che la chiave API del tuo ID servizio e l'ID istanza, la chiave root e l'endpoint del servizio IBM Key Protect siano archiviati come valori con codifica base64 nel segreto Kubernetes del tuo cluster.
    2. Assicurati di aver denominato il tuo segreto px-ibm.
    3. Assicurati di aver creato il segreto nel progetto portworx del tuo cluster.

Passo 2: Verifica della configurazione del cluster

Se hai immesso le informazioni corrette nella pagina del catalogo IBM Cloud, verifica che il tuo cluster sia configurato correttamente per Portworx.

  1. Verificare che il cluster che si intende utilizzare soddisfi i requisiti hardware minimi indicati all'indirizzo Portworx.
  2. Se vuoi utilizzare un cluster di macchine virtuali, assicurati di aver aggiunto archiviazione blocchi non elaborata, non formattata e non montata al tuo cluster in modo che Portworx possa includere i dischi nel livello di archiviazione Portworx.

Passo 3: Contatta Portworx e IBM

Contatta il supporto Portworx utilizzando uno dei seguenti metodi.