

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](https://docs.aws.amazon.com/wickr/latest/adminguide/what-is-wickr.html) do Usuário do [AWS Wickr.](https://docs.aws.amazon.com/wickr/latest/userguide/what-is-wickr.html)

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
<a name="troubleshooting-installation"></a>

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
<a name="general-issues"></a>

**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.

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

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

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

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

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

## Problemas de atualização
<a name="upgrade-issues"></a>

**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`

1. `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.

1. 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`

1. Execute o seguinte comando kubectl:

   `kubectl get installations`

1. 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
   ```

1. Exclua a instalação com falha.

   `kubectl delete installation 20251113180133`

1. 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`

1. 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`

1. 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`

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

   `kubectl -n kotsadm get pods|grep -i rabbitmq`

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

   `kubectl -n kotsadm get pvc|grep -i rabbitmq`

1. 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](https://docs.aws.amazon.com/wickr/latest/wickrenterpriseinstall/troubleshooting.html).