O SDDC Manager é o componente central de orquestração e automação no VMware Cloud Foundation (VCF). Ele gerencia o ciclo de vida completo do ambiente, incluindo atualizações, expansões e correções de componentes como vSphere, NSX-T Data Center, VMware Aria Suite (antigo vRealium) e VMware Site Recovery Manager (SRM). Quando o SDDC Manager apresenta falhas ou comportamentos inesperados, a capacidade de realizar um troubleshooting eficaz é crítica para manter a disponibilidade da infraestrutura virtualizada.
Este guia técnico detalha os procedimentos essenciais para diagnosticar e resolver problemas comuns no SDDC Manager. As instruções são aplicáveis às versões modernas do VCF (4.x e 5.x), focando na linha de comando via SSH, análise de logs e verificação de dependências de serviços.
1. Verificação Inicial do Status dos Serviços
A primeira etapa em qualquer diagnóstico é confirmar se os processos essenciais do SDDC Manager estão em execução. O SDDC Manager roda sobre uma plataforma baseada em Spring Boot, e seus serviços são gerenciados pelo sistema de init.
Acesse o appliance do SDDC Manager via SSH com credenciais de administrador (root) e execute o seguinte comando para verificar o status geral:
service-control --statusVocê deve observar que os seguintes serviços estão ativos:
sddc-manager: O serviço principal da aplicação.nsx-vmware-vcf-sddcmanager: Conector específico para NSX-T.vcf-health-monitor: Monitor de saúde do cluster.
Se algum serviço estiver parado ou falhando, tente reiniciá-lo com o comando abaixo. Note que isso pode causar uma interrupção breve na interface gráfica:
service-control --stop sddc-manager
service-control --start sddc-managerApós a reinicialização, verifique novamente o status para garantir que o serviço não entrou em loop de falha. Se o serviço parar imediatamente após iniciar, isso indica um erro crítico no banco de dados ou na configuração do aplicativo.
2. Análise dos Logs Principais
Os logs são a fonte primária de informação para identificar erros. O SDDC Manager mantém registros detalhados em vários locais. Para problemas gerais da aplicação, o log mais importante é o sddc-manager.log.
2.1. Localização dos Logs
Acesse o diretório padrão onde os logs são armazenados:
cd /var/log/vmware/vcf/sddcmanager/Dentro deste diretório, você encontrará diversos arquivos de log. Os mais críticos para troubleshooting incluem:
- sddc-manager.log: Contém eventos da aplicação principal, incluindo tentativas de operação e erros de execução.
- vcf-health-monitor.log: Logs relacionados à verificação de integridade dos componentes do VCF.
- nsx-vmware-vcf-sddcmanager.log: Específico para interações com o NSX-T Manager.
2.2. Buscando Erros Comuns
Utilize o comando grep para filtrar mensagens de erro. Procure por palavras-chave como ERROR, FATAL, Exception ou Caused by.
grep -i "error" /var/log/vmware/vcf/sddcmanager/sddc-manager.log | tail -n 50Se você estiver investigando um problema específico de atualização ou expansão, filtre pelo ID da tarefa em execução. Os IDs de tarefa são exibidos na interface gráfica do SDDC Manager durante a operação.
grep -i "task-id: SEU_ID_DA_TAREFA" /var/log/vmware/vcf/sddcmanager/sddc-manager.logA análise desses logs revelará se o erro é de conectividade de rede, falha de autenticação ou inconsistência de dados no banco.
3. Verificação do Banco de Dados Integrado
O SDDC Manager utiliza um banco de dados PostgreSQL integrado para armazenar metadados do ambiente VCF. Problemas de conexão com o banco de dados são uma causa frequente de falhas na interface e nos serviços.
3.1. Testando a Conexão
Verifique se o serviço do PostgreSQL está em execução:
service-control --status postgresqlPara testar manualmente a conexão ao banco de dados, use a ferramenta psql. As credenciais são gerenciadas internamente, mas você pode tentar uma conexão rápida para validar o serviço:
su -l vcfdbuser
psql -h localhost -U vcf -d vcfSe a conexão falhar com erro de permissão ou senha incorreta, verifique os arquivos de configuração em /etc/vmware/vcf/. Nunca altere senhas manualmente; utilize as ferramentas de gerenciamento do VCF para resetar credenciais se necessário.
3.2. Verificação de Espaço em Disco
O banco de dados requer espaço livre para operações de escrita e manutenção. Verifique a utilização do disco na partição onde o banco está instalado:
df -h /var/vmware/vcf/dbSe o uso do disco estiver acima de 85%, o SDDC Manager pode começar a falhar em operações de escrita. Libere espaço removendo logs antigos ou expandindo o datastore se estiver em um ambiente virtualizado.
4. Troubleshooting Específico para NSX-T
O NSX-T Data Center é um componente complexo que depende fortemente do SDDC Manager para orquestração. Problemas de integração frequentemente resultam em erros de "Health Check" ou falhas em atualizações.
4.1. Verificação da Conexão com NSX Managers
O SDDC Manager se conecta aos NSX Managers via API REST. Se houver problemas de conectividade, o log nsx-vmware-vcf-sddcmanager.log mostrará erros de timeout ou falhas de handshake TLS.
tail -n 100 /var/log/vmware/vcf/sddcmanager/nsx-vmware-vcf-sddcmanager.log | grep -i "connection refused"Verifique se as regras de firewall permitem a comunicação entre o SDDC Manager e os NSX Managers nas portas padrão (geralmente 443 para API e outras portas específicas para transporte).
4.2. Sincronização de Estado
Às vezes, o estado interno do SDDC Manager pode divergir do estado real do NSX-T. Para forçar uma sincronização manual (apenas se recomendado pelo suporte VMware), você pode executar a verificação de saúde específica para NSX:
vcf-health-monitor --component nsxEste comando retorna o status atualizado e identifica inconsistências que podem precisar de intervenção manual ou scripts de correção fornecidos pela documentação oficial.
5. Problemas com VMware Aria Suite (vRealium) e SRM
O SDDC Manager também orquestra a instalação e atualização do VMware Aria Suite Automation, Operations e License Management, bem como o Site Recovery Manager (SRM).
5.1. VMware Aria Suite
Falhas na integração com o Aria Suite geralmente envolvem certificados SSL ou credenciais de administrador desatualizadas. Verifique se os certificados do vCenter e do NSX estão válidos e foram atualizados no repositório do SDDC Manager.
Se a interface do Aria Suite não carregar após uma atualização, verifique os logs do serviço vrealize-automation ou vrealize-operations nos appliances correspondentes, mas comece a investigação pelos logs do SDDC Manager para ver se houve falha na etapa de "Onboarding" ou "Health Check".
5.2. VMware Site Recovery Manager (SRM)
O SRM requer conectividade específica entre os pares em locais protegidos por desastre. Erros comuns incluem:
- Falha no handshake SSL entre o vCenter e o SRM.
- Incompatibilidade de versão entre o SDDC Manager e o plugin do SRM.
Verifique a integridade da conexão executando um teste de conectividade manual via SSH entre os appliances:
telnet <ip-do-srm-par> 443Se a conexão falhar, revise as regras de firewall e DNS. Certifique-se de que o nome FQDN do SRM resolve corretamente no ambiente.
6. Recuperação de Falhas Críticas
Em casos onde o SDDC Manager não inicia ou os logs indicam corrupção de banco de dados, procedimentos de recuperação mais agressivos podem ser necessários.
6.1. Reinicialização Completa do Serviço
Antes de qualquer ação drástica, tente parar e iniciar todos os serviços relacionados ao SDDC Manager:
service-control --stop --all
service-control --start --allEste processo pode levar vários minutos. Aguarde até que todos os serviços retornem ao status "Running" antes de tentar acessar a interface.
6.2. Coleta de Logs para Suporte VMware
Se o problema persistir, você precisará fornecer logs detalhados ao suporte técnico da VMware. Utilize a ferramenta de coleta de logs integrada:
vcf-collect-logs --output /tmp/vcf_logs.tar.gzEste comando compactará todos os logs relevantes do SDDC Manager, NSX-T, vCenter e componentes do Aria Suite em um arquivo único. Envie este arquivo para o caso de suporte aberto.
7. Boas Práticas para Prevenção
A prevenção é mais eficaz que a correção. Adote as seguintes práticas para manter a estabilidade do SDDC Manager:
- Monitoramento Contínuo: Utilize o VMware Aria Operations ou uma solução de monitoramento externa para alertar sobre falhas nos serviços do SDDC Manager.
- Backups Regulares: Certifique-se de que os backups do SDDC Manager estão sendo realizados conforme a documentação oficial. O backup deve incluir o banco de dados e as configurações críticas.
- Atualizações em Passo: Siga rigorosamente a ordem de atualização definida no Release Notes do VCF. Atualizar componentes fora de ordem pode corromper o estado do SDDC Manager.
- Verificação de Disk Space: Monitore o espaço em disco dos appliances do SDDC Manager semanalmente.
Conclusão
O troubleshooting do SDDC Manager no VMware Cloud Foundation exige uma abordagem sistemática, começando pela verificação de serviços, passando pela análise detalhada de logs e culminando na validação de dependências externas. A maioria dos problemas pode ser resolvida identificando erros específicos nos logs do sddc-manager.log ou corrigindo configurações de rede e certificados.
Lembre-se sempre de documentar as alterações realizadas durante o processo de resolução de problemas. Em ambientes críticos, realize testes em ambiente de homologação antes de aplicar correções em produção. Para problemas complexos que envolvem corrupção de banco de dados ou falhas de hardware, entre em contato com o suporte VMware fornecendo os logs coletados conforme descrito neste tutorial.
A manutenção proativa e a familiaridade com as ferramentas de diagnóstico disponíveis são essenciais para qualquer administrador de infraestrutura virtualizada que utilize o ecossistema VCF. Com este guia, você está preparado para lidar com a maioria dos cenários comuns de falha no SDDC Manager.