--- title: "Solução de Problemas do vSocket HA AWS" slug: "aws-ha-vsocket-troubleshooting" updated: 2026-11-17T00:09:10Z published: 2026-11-17T00:09:10Z canonical: "knowledge.catonetworks.com/aws-ha-vsocket-troubleshooting" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Solução de Problemas do vSocket HA AWS ## Visão geral Este guia fornece uma estrutura detalhada de solução de problemas para resolver problemas comuns encontrados durante a implantação do AWS vSocket Alta Disponibilidade (HA). Seja implantando manualmente ou via AWS Marketplace, essas etapas têm como objetivo ajudar a identificar e resolver efetivamente problemas potenciais. ## Sintomas Problemas comuns nas implantações de HA do vSocket AWS podem incluir: - **Falha na Conmutação por erro do HA** - Testes de API de HA falhos a partir da Interface Web do vSocket. - Falha no failover HA, resultando em tráfego não sendo encaminhado para o vSocket secundário. - **Status HA Não Pronto** - CMA exibe o Status de HA do site como "Não Pronto" ## Causas Possíveis Falhas na implantação de HA são frequentemente devido às seguintes causas: - Uso de DNS não público na AWS. - Interface de Gerenciamento sem acesso à Internet. - Configuração incorreta do IAM role. - Configurações restritivas de Grupo de Segurança e Roteamento na AWS. - Falha ao atribuir a Interface de Rede apropriada à Tabela de Roteamento LAN. - Problemas de conectividade LAN. ## Solução de problemas do problema > [!NOTE] > IMPORTANTE: > > IMPORTANTE: Antes de começar a solucionar problemas, certifique-se de que todos os pré-requisitos para implantação do vSocket AWS HA estão verificados. Veja [Implantando um Site vSocket AWS Manualmente](https://support.catonetworks.com/hc/pt-br/articles/4413273479825-Deploying-an-AWS-vSocket-Site-Manually), [Implantando um Site vSocket do AWS Marketplace](https://support.catonetworks.com/hc/pt-br/articles/16150140007069-Deploying-a-vSocket-Site-from-the-AWS-Marketplace) e [Configurando HA para AWS vSockets](https://support.catonetworks.com/hc/pt-br/articles/4413280515985-Configuring-HA-for-AWS-vSockets) ### Resolução de Problemas de Falha na Conmutação por erro do HA Se o tráfego não está sendo direcionado para o vSocket secundário durante o failover, considere as seguintes etapas de solução de problemas: #### Executando o Teste de API de HA - A partir da Interface Web do vSocket, execute a ferramenta de Teste de API para ambos os vSockets. - Esta ferramenta valida que a chamada API para AWS pode ser feita com sucesso. - Qualquer erro relacionado a permissões ou atualizações de tabela de roteamento pode ser visto aqui. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23539990574621.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=phUuttUiClHfFzYKOIFOwYu%2BHi2SymjwH4XL2RhxkB0%3D) #### Configuração incorreta da Função IAM - Erros de permissão do AWS IAM podem ocorrer se a função IAM e o perfil da instância estiverem configurados incorretamente. Se você receber o erro abaixo ao executar o teste da API, verifique para ambos os vSockets se o ARN da função e o ARN do perfil da instância referem-se à mesma Função IAM da AWS, ou seja, o perfil da instância contém essa função. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(310).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=SU3Y09AiIVtcnsom67D4eALQSb1EOEN%2FLSoG%2F8v8L58%3D) #### Verificação da Configuração DNS AWS - Verifique se o **servidor DNS AWS** padrão está configurado para a VPC associada. - Para verificar a Configuração DNS da AWS, consulte [Corrigindo problemas de configuração de DNS](/docs/pt-br/aws-ha-vsocket-troubleshooting#h_01HQ15Z6JN49GPAHHNTMBGAJXA) - Se um servidor DNS personalizado (por exemplo, um servidor DNS privado) estiver configurado, certifique-se de que ele pode resolver domínios públicos. Verifique se ele pode resolver o Nome de domínio totalmente qualificado (FQDN) **ec2.**.amazonaws.com (por exemplo, *ec2.us-east-1.amazonaws.com*), que é usado pela API. - O Grupo de Segurança associado à interface MGMT deve permitir solicitações DNS para 8.8.8.8 e 8.8.4.4, mesmo que o servidor DNS padrão AWS esteja configurado. #### Verificação da Tabela de Roteamento LAN - Para redirecionar o tráfego para o vSocket mestre, a AWS atribui a Interface de Rede LAN do vSocket mestre atual à Tabela de Roteamento LAN. - Vá para **VPC > Tabelas de Roteamento** e selecione a Tabela de Roteamento LAN. Na aba **Rotas**, verifique se a Interface de Rede LAN do vSocket mestre é o gateway (alvo) da rota padrão. Se não, continue com os próximos passos. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543388344861.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=i920xmMvuqzCZDWRBvBmZuoJjqbtrwomGZ%2BizasvMwo%3D) - Observe que modificar manualmente a Tabela de Roteamento LAN pode ser uma solução rápida se a NIC de destino não foi alterada durante o failover. #### Verificação do Role IAM - Durante a [implantação do vSocket AWS](https://support.catonetworks.com/hc/pt-br/articles/4413280515985-Configuring-HA-for-AWS-vSockets), a **Função IAM HA** é criada e associada a ambos os vSockets, principal e secundário. - Na página de detalhes de cada instância, confirme que a função IAM correta é atribuída. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23490131069341.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=5LwADv6qpqHGeO0U9JO7DFERTasoPH1exrEaO3DDBMQ%3D) - Clique no link da Função IAM e, na guia de permissões, verifique se a Política de Implantação da IAM contém a declaração correta, conforme mostrado abaixo. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23490133532701.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=RMuuufQcs6AhAKWtBrvLtHNWDAk8W8v0E3mEulK2NB8%3D) **Nota:** Em caso de Função IAM ausente, uma vez que a função seja adicionada, os sockets devem ser reiniciados para que as funções adicionadas entrem em vigor. #### Verificação das Configurações IMDS - Garanta que ambos os vSockets utilizem configurações IMDS correspondentes (opcionais ou obrigatórias). Para mais informações, consulte [documentação AWS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html?icmpid=docs_ec2_console). - A partir da build 20.0.18221, vSocket suporta IMDSv2. - Para modificar as configurações do IMDS, selecione a instância e, em ações, clique em **Configurações de Instância > Modificar opções de metadados da instância**. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23539832291741.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=QiO8mdOikiSyxc8vr2VeVc%2Fsdyhhtobi9Z4O7tht7pU%3D) #### Verificação do Grupo de Segurança de Rede. - Certifique-se de que o grupo de segurança de rede não está bloqueando o tráfego de saída para a Interface de Gerenciamento. - Em **EC2 > Interfaces de Rede**, encontre o Grupo de Segurança associado à Interface de Gerenciamento. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543388345629.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=6BHo6YUne8H%2Fw%2BAOqCoptoFsAbesger1uvvblatalSg%3D) - Verifique se as regras de saída do Grupo de Segurança permitem as portas 80, 443 e 53. Neste caso, todo o tráfego de saída é permitido. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543372946461.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=Xx82nM6TP6lJmU0pYDIH9zrhkOa0TJ0JJV5jCoUFBTs%3D) #### Verificando o Roteamento da Interface MGMT para Tráfego de Internet. - Se o tráfego da interface MGMT estiver roteado através de um firewall de terceiros na AWS, verifique se as conexões de saída UDP/53, TCP/80 e TCP/443 estão permitidas. - Na página da interface de rede, clique no ID da Sub-rede da interface MGMT. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543372946717.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=PooTX6Sh7UfTUwVJ4OrnMNNbT%2BG%2FTFNM7sDJ6HlJSFM%3D) - Na página de Sub-rede, selecione a aba **Tabela de Roteamento**. A captura de tela abaixo mostra a rota padrão apontando para o Gateway da Internet, então um firewall não está bloqueando o tráfego. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543388350109.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=B4B62yCDWKTkkWIQTScMKx6vdttp%2F%2FyFD4j1IyTBOyw%3D) - Abra a **Tabela de Roteamento** relacionada e verifique se todas as sub-redes MGMT estão listadas como sub-redes associadas. No caso de Zona de Disponibilidade dupla, existirão duas sub-redes MGMT, uma para cada vSocket, conforme explicado em [Criando uma Sub-rede para as Interfaces LAN do vSocket Secundário](https://support.catonetworks.com/hc/pt-br/articles/4413280515985-Configuring-HA-for-AWS-vSockets#h_01JA4VNYFPEPQGXA3KRNMWMTKT). ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24082498314397.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=1CFjd%2BA65sTKIteGAkwgUuGkesbchYIsBosvZ150jXo%3D) - Na aba Mapa de Recursos do VPC, todas as sub-redes associadas e suas configurações de roteamento são visualmente representadas para fácil referência. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24102418615453.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=3DTtrh%2BCSCt7Tmr4QQ9WcFzsY1LPa%2FMpg31tD66n5js%3D) - Confirme que um IP elástico está associado à interface MGMT. Isso pode ser visto na aba de rede da instância. A interface MGMT pode ser identificada por seu **índice de dispositivo** de 0. As interfaces WAN e LAN devem ser associadas aos índices de dispositivo 1 e 2, respectivamente. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23544401804445.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=pECKGbB7Dfy5XtM14aXleQ%2FgYEsAEs9fHdDoxunOiyo%3D) #### Verificando logs do CloudTrail - Habilite AWS CloudTrail para registrar chamadas de API para AWS para depurar modificações falhadas da tabela de roteamento LAN durante a falha do HA. - Você pode seguir o processo para criar um trail, definir o bucket S3 para armazenar logs, e selecionar eventos de gerenciamento que incluem atividade de API. Veja [Criando um Trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html?icmpid=docs_cloudtrail_console). ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23488035472541.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=uEo3PVwI%2B4tc673%2F6YAy4skSM4zvkYkKPuFQpMiF4BQ%3D) ### Solucionando Problemas de Status HA Não Pronto Se o CMA mostrar que o Status HA não está pronto e ambos os vSockets estão em execução, ambos os vSockets assumirão o papel de Mestre (cenário de split-brain). Isso pode ocorrer devido a: - Ambos os vSockets estão executando versões de firmware diferentes - Mensagens de Keepalive HA não chegam ao vSocket secundário ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543474264349.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=kYNsEl8%2F33ibBLfmvpbr6dRkSd%2FSNFxo7pu3re3rqzc%3D) Recomenda-se verificar as páginas [WebUI](https://support.catonetworks.com/hc/pt-br/articles/4413265669905-Using-the-Socket-WebUI) de ambos os vSockets para confirmar o status de HA de cada um deles. Um cenário de split-brain se manifestará se ambos vSockets primário e secundário estiverem em um papel de Mestre. O WebUI mostrará o papel atual no topo da página principal de Monitoramento. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23543474264989.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=8LtsC51PmDMaity9hZgIeMd6Va%2FPD6euRkCMYBG0pF4%3D) #### Verificando versões de firmware Para atender aos Critérios de versão compatível, ambos os vSockets devem executar a mesma versão **MAJOR**, por exemplo, v17.xx.yy ou v18.xx.yy. Os vSockets realizam uma atualização inicial após serem implantados pela primeira vez. Se um dos vSockets falhar em atualizar, este problema deve ser solucionado. Envie um [ticket de Suporte](https://support.catonetworks.com/hc/pt-br/articles/360017066338-Submitting-a-Support-Ticket) para relatar este problema. #### Verificação dos Keepalives HA Pacotes de Keepalive usam a porta UDP/20480 para AWS vSocket e serão enviados apenas do vSocket Mestre para o vSocket de Backup. A condição de split-brain ocorre quando ambos os vSockets têm o papel de Mestre, o que pode acontecer devido a problemas de conectividade LAN entre os vSockets que criam uma situação em que as mensagens Keepalive HA não chegam ao vSocket Secundário. Execute as seguintes verificações para confirmar a conectividade LAN: - Verifique se o Grupo de Segurança de Rede está bloqueando a porta UDP/20480. Um modo rápido de verificar regras NSG é acessar cada interface de rede LAN na AWS e verificar as regras de entrada e saída conforme explicado em [Verifique se o Grupo de Segurança de Rede está bloqueando o tráfego de saída.](/v1/docs/aws-ha-vsocket-troubleshooting#verifying-the-network-security-group) - Confirme que ambas as interfaces LAN estão associadas a diferentes sub-redes LAN. - Execute uma [captura de pacotes](/v1/docs/how-to-capture-traffic-on-a-socket) do WebUI de ambos os vSockets e identifique se o vSocket secundário está recebendo os keepalives enviados pelo principal. ## Resolvendo Questões Descobertas #### Corrigindo problemas de configuração DNS - Para corrigir problemas de Configuração DNS, verifique se o servidor DNS padrão da AWS está configurado para o VPC. - Nos Detalhes do VPC, encontre o **conjunto de opções DHCP** configurado para ele. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23489820776093.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=R0twqzWc71aftLY59VFN9nDX%2BEH7irMTXek9mUkBGIg%3D) - Abra o conjunto de opções DHCP e verifique se o **Nome do Domínio** definido é AmazonProvidedDNS.![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/23489820777629.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A50%3A26Z&se=2026-11-19T05%3A50%3A26Z&sr=b&sp=r&sig=KoA1TiEKYSMbWEtAkyGcjgWljF3aX93RCEm10OqvnDE%3D) - Não é possível alterar os servidores de Nome de Domínio existentes. Para isso, crie um novo conjunto de opções DHCP, que usará o AmazonProvidedDNS por padrão. #### Cancelando Registro e Reimplantando um AWS vSocket - Se após seguir todas as etapas de solução de problemas acima, a falha do HA ainda continuar, é possível cancelar o registro e reimplantar um ou ambos os vSockets. Veja [Reimplantar Sites de Alta Disponibilidade vSocket](https://support.catonetworks.com/hc/pt-br/articles/14201843843869-Unregistering-and-Redeploying-AWS-vSockets#heading-3) - É importante remover a Máquina Virtual, mas reter as interfaces de rede, IPs Públicos associados e a função IAM antes de reimplantar um vSocket. - Além disso, lembre-se de reanexar a função IAM correta ao vSocket selecionando a instância do vSocket > Segurança > Anexar Função IAM e atribuindo a função AWS-HA. ## Levantamento de casos para Suporte Cato Envie um [Ticket de Suporte](/v1/docs/submitting-a-support-ticket) com os resultados dos passos de solução de problemas acima. Por favor, inclua as seguintes informações no ticket: - Uma descrição clara do problema, incluindo quaisquer mensagens de erro. - Configuração DNS na VPC. - Resultados do teste API. - Capturas de tela da Tabela de Roteamento LAN e das Funções IAM configuradas. - Se possível, arquivos de log do CloudTrail no momento da falha da transferência por erro.