View a markdown version of this page

Solução de problemas de instalações de cluster incorporado do Wickr - Wickr Enterprise
Problemas geraisProblemas de atualização

Este guia fornece documentação para o Wickr Enterprise. Se você estiver usando o AWS Wickr, consulte o Guia de Administração do AWS Wickr ou o Guia do Usuário do AWS Wickr.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas de instalações de cluster incorporado do Wickr

Todas as instâncias dessas etapas de solução de problemas pressupõem que você tenha acesso ao shell à instância que executa a instalação do Wickr Embedded Cluster e tenha executado o ./wickr-enterprise-ha shell comando para poder interagir diretamente com a instalação do Kubernetes.

Problemas gerais

Botão Adicionar nó ausente na tela de gerenciamento de cluster

Instalações Airgapped

Se você estiver em uma instalação de airgap, entre em contato com o Wickr Support para obter ajuda na correção desse comportamento.

Instalações padrão

Se sua licença incluir o direito ao Embedded Cluster Multi-Node, execute uma sincronização de licenças para obter a versão mais recente. Se você não tiver certeza ou não tiver esse direito, entre em contato com o Wickr Support.

Para realizar uma sincronização de licenças, conclua as etapas a seguir.

  1. Navegue até o painel de controle do KOTS.

  2. Na página Painel, localize a seção de licença na área superior direita da página.

  3. Nessa seção, no canto superior direito, você verá um hiperlink de licença de sincronização. Selecione o hiperlink.

  4. Depois que a licença é sincronizada, a interface do usuário é atualizada e a última sincronização é exibida há alguns segundos.

  5. Escolha Reimplantar na seção Versão da página do painel do KOTS.

  6. Quando a reimplantação for concluída, volte para o gerenciamento de clusters e você poderá adicionar nós.

Problemas de atualização

Atualização travada na atualização do cluster

Se sua atualização travar no Upgrading Cluster, isso provavelmente significa que alguns pods não estão sendo encerrados adequadamente. Faça login na instância e use o ./wickr-enteprise-ha shell comando para entrar no ambiente de shell para gerenciar a instalação do kubernetes.

  1. Identifique os pods que ainda estão em execução:

    kubectl -n kotsadm get pods | grep Running

  2. kubectl -n kotsadm delete pod name-of-running-pod

    nota

    Se um dos pods em execução for embedded-cluster-upgrade-XXXXXXXXXXXXXX-xxxxx kotsadm-xxxxxxx ou similar, não o exclua, pois esses pods são necessários para realizar a atualização.

  3. Verifique se não há mais pods em execução.

    kubectl -n kotsadm get pods | grep Running

Esse procedimento deve permitir que a atualização do cluster continue com a atualização do Wickr.

O aplicativo não foi atualizado durante a atualização do cluster e não pode implantar uma nova versão

Se o aplicativo permanecer na versão antiga após a atualização, a nova versão poderá estar em um estado inconsistente.

Confira os registros de instalação do Kubernetes:

  1. Abra o shell do Kubernetes a partir do instalador.

    ./wickr-enterprise-ha shell

  2. Execute o seguinte comando kubectl:

    kubectl get installations

  3. A saída será mais ou menos assim:

    
      [root@ip-172-31-6-72 ~]# kubectl get installations
NAME             STATE      INSTALLERVERSION   CREATEDAT              AGE
20251113170603   Obsolete   2.1.3+k8s-1.30     2025-11-13T17:06:05Z   22h
20251113180133   Failed     2.6.0+k8s-1.31     2025-11-13T18:01:37Z   21h

  4. Exclua a instalação com falha.

    kubectl delete installation 20251113180133

  5. Tente executar a atualização novamente através do painel de administração do KOTS.

Falha no pod RabbitMQ com linhas de registro Error while waiting for Mnesia tables: {timeout_waiting_for_tables}

O segredo e o armazenamento do RabbitMQ estão fora de sincronia. Isso geralmente acontece quando várias instâncias do RabbitMQ são executadas e causam erro na seleção do líder ou no quórum. Para corrigir isso, exclua o serviço RabbitMQ e seus volumes de armazenamento e reimplante.

Para excluir o RabbitMQ com falha, conclua as etapas a seguir.

  1. Exclua o RabbitMQ Statefulset.

    kubectl -n kotsadm delete statefulset rabbitmq —cascade=orphan

  2. Exclua os pods restantes do RabbitMQ. Se houver vários pods do RabbitMQ-x em execução, emita esse comando várias vezes atualizando o valor do RabbitMQ-x para corresponder aos nomes adicionais dos pods.

    kubectl -n kotsadm delete pod rabbitmq-0

  3. Exclua o correspondente PVCs. Se houver vários pods em execução, emita esse comando várias vezes atualizando o data-RabbitMQ-X para corresponder aos pods apropriados.

    kubectl -n kotsadm delete pvc data-rabbitmq-0

  4. Verifique se há pods restantes; isso não deve gerar nada se for bem-sucedido.

    kubectl -n kotsadm get pods|grep -i rabbitmq

  5. Verifique se há algum restante PVCs, isso não deve gerar nada se for bem-sucedido.

    kubectl -n kotsadm get pvc|grep -i rabbitmq

  6. Reimplante por meio do painel de administração do KOTS.

Para obter mais informações sobre solução de problemas, consulte Solução de problemas.