Depurando sua instalação do Portworx

Nuvem Privada Virtual Infraestrutura clássica

Este tópico de solução de problemas se aplica apenas aos clusters do Red Hat OpenShift que executam a versão 3.11.

Ao criar uma instância de serviço do Portworx por meio do catálogo do IBM Cloud, a instalação do Portworx em seu cluster falha e a instância de serviço mostra um status de Falha de provisão.

Antes de o Portworx ser instalado em seu cluster, um número de verificações é executado para verificar as informações fornecidas na página do serviço do Portworx do catálogo do IBM Cloud.

Se uma dessas verificações falhar, o status do serviço do Portworx será mudado para Falha de provisão. Não é possível ver os detalhes de qual verificação falhou ou quais informações estão faltando para concluir a instalação.

Siga este guia para iniciar a resolução de problemas de sua instalação do Portworx e verificar as informações inseridas no catálogo do IBM Cloud.

Se você localizar informações que inseriu incorretamente ou tiver que mudar a configuração do seu cluster, corrija as informações ou a instalação do cluster. Em seguida, crie uma nova instância de serviço do Portworx para reiniciar a instalação.

Etapa 1: verificando as informações do catálogo do IBM Cloud

Comece verificando se as informações inseridas no catálogo do IBM Cloud estão corretas. Se as informações foram inseridas incorretamente, a instalação não passará nas verificações de pré-instalação e falhará sem iniciar a instalação.

  1. Verifique se o cluster no qual deseja instalar o Portworx está localizado na região do IBM Cloud e no grupo de recursos que você selecionou.

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

  2. Verifique se a chave de API do IBM Cloud inserida tem permissões suficientes para funcionar com seu cluster. Deve-se estar designado à função de acesso à plataforma Editor e à função de acesso ao serviço Gerenciador para o Red Hat OpenShift on IBM Cloud. Para obter mais informações, consulte Permissões de acesso do usuário.

  3. Verifique se você inseriu o terminal de API etcd para seus Bancos de dados para a instância de serviço etcd no formato correto.

    1. Recupere os bancos de dados para o terminal etcd.

    2. Inclua o terminal etcd no formato etcd:<etcd_endpoint1>;etcd:<etcd_endpoint2>. Se você tiver mais de um terminal, inclua todos os terminais e separe-os com um ponto e vírgula (;).

      Exemplo de terminal:

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

  4. Verifique se você armazenou as credenciais para acessar seus Bancos de dados para a instância de serviço etcd em um segredo do Kubernetes em seu cluster. Para obter mais informações, consulte Configurando um banco de dados para a instância de serviço etcd para os metadados do Portworx.

    1. Revise as etapas 4-6 e verifique se você recuperou o nome de usuário, a senha e o certificado corretos.
    2. Liste os segredos em seu cluster e procure pelo segredo que contenha as credenciais de seus Bancos de dados para a instância de serviço etcd.
        oc get secrets
    ```
3. Certifique-se de que o nome de usuário, a senha e o certificado sejam armazenados como um valor codificado em base64 em seu segredo do Kubernetes.
4. Verifique se você inseriu o nome correto do segredo no catálogo do IBM Cloud.

  5. Se você optou por configurar a criptografia de volume com o IBM Key Protect, assegure-se de ter criado uma instância do IBM Key Protect em sua conta do IBM Cloud e de que armazenou as credenciais para acessar sua instância em um segredo do Kubernetes no projeto portworx do seu cluster. Para obter mais informações, consulte Ativando a criptografia por volume para seus volumes do Portworx.

    1. Assegure-se de que a chave de API de seu ID do serviço e o ID de instância, a chave raiz e o terminal de API do IBM Key Protect sejam armazenados como valores base64 no segredo do Kubernetes de seu cluster.
    2. Assegure-se de que nomeou seu segredo como px-ibm.
    3. Assegure-se de que criou o segredo no projeto portworx do seu cluster.

Etapa 2: verificando a instalação do cluster

Se você inseriu as informações corretas na página do catálogo do IBM Cloud, verifique se seu cluster está configurado corretamente para o Portworx.

  1. Verifique se o cluster que você deseja usar atende aos requisitos mínimos de hardware para o Portworx.
  2. Se você quiser usar um cluster de máquina virtual, certifique-se de que ter incluído armazenamento de bloco bruto, não formatado e desmontado para o seu cluster para que o Portworx possa incluir os discos na camada de armazenamento do Portworx.

Etapa 3: entrar em contato com a Portworx e com a IBM

Entre em contato com o suporte Portworx usando um dos métodos a seguir.