Data de Publicação: 13 de Agosto de 2025
Autora: Patrícia Canossa Gagliardi
Este artigo técnico aborda um erro comum encontrado por administradores de sistemas e entusiastas de virtualização: a falha na importação de um arquivo OVA (Open Virtualization Appliance) em plataformas VMware, causada pela ausência do arquivo descritor OVF (Open Virtualization Format). O documento detalha as causas do problema e apresenta um guia passo a passo para a solução principal, que consiste na reconstrução manual da máquina virtual, além de métodos alternativos de diagnóstico e correção.
O formato OVA é um padrão da indústria para distribuir appliances virtuais pré-configurados. Trata-se de um pacote de arquivamento (baseado em TAR) que encapsula todos os componentes de uma Máquina Virtual (VM), incluindo discos, metadados de configuração e certificados. O componente central desses metadados é o arquivo .ovf, um descritor XML que instrui o hypervisor (neste caso, VMware ESXi ou Workstation) sobre como provisionar a VM – suas especificações de hardware, estrutura de disco, configurações de rede, entre outros.
O erro “Failed to deploy OVF package” ou “The OVF descriptor is not available” ocorre quando o VMware descompacta o pacote .ova mas não localiza o arquivo .ovf esperado, tornando a importação automática impossível. As causas mais frequentes incluem:
.ova não foi baixado completamente ou sofreu corrupção durante a transferência..ova na origem falhou em incluir o arquivo .ovf.Este guia foca na solução prática, partindo do princípio que o componente mais valioso – o disco virtual (.vmdk) – está intacto dentro do pacote.
A estratégia mais eficaz é extrair o disco virtual do pacote .ova e utilizá-lo para criar uma nova máquina virtual manualmente.
Um arquivo .ova é funcionalmente um arquivo .tar. Para extrair seu conteúdo, siga os procedimentos abaixo:
.ova para .tar.
meu_appliance.ova -> meu_appliance.tar.tar e selecione a opção para extrair seu conteúdo para uma nova pasta.tar no terminal.
# Crie um diretório de destino para manter a organização
mkdir /caminho/para/minha_vm
# Execute o comando de extração
tar -xvf /caminho/do/meu_appliance.tar -C /caminho/para/minha_vm/
Ao final da extração, a pasta de destino deverá conter um ou mais arquivos de disco (.vmdk) e, possivelmente, um arquivo de manifesto (.mf), que pode agora ser ignorado.
Com o disco virtual em mãos, o próximo passo é criar o “invólucro” da VM no VMware.
Inicie o Assistente de Criação: No VMware vSphere Client ou Workstation, inicie o fluxo de “Create a New Virtual Machine”.
Configuração Personalizada: Opte pela criação “Custom” (Personalizada) para ter controle granular sobre todas as etapas.
Especificações da VM: Defina o nome, o local de armazenamento (datastore) e a versão de compatibilidade de hardware.
Sistema Operacional Convidado (Guest OS): Selecione o sistema operacional correspondente ao do appliance. Se não tiver certeza, escolha uma versão genérica compatível (ex: “Other 64-bit” ou “Linux 5.x kernel 64-bit”).
Provisionamento do Disco (Passo Crítico): Na seção de configuração de disco (“Select a Disk”), não selecione “Create a new virtual disk”. Escolha a opção “Use an existing virtual disk”.
Anexar o Disco Existente: Navegue até o diretório onde você extraiu o conteúdo do .ova e selecione o arquivo .vmdk principal.
Finalização: Conclua o assistente.
Revisão de Hardware: Antes de ligar a VM, acesse “Edit Settings”. Valide e ajuste a alocação de CPU, memória RAM e, fundamentalmente, a configuração do adaptador de rede (Network Adapter) para a VLAN/Port Group correto. Appliances de segurança são especialmente sensíveis a esta configuração.
Primeira Inicialização: Ligue a máquina virtual.
Instalação do VMware Tools: Após o boot bem-sucedido do sistema, instale ou atualize o VMware Tools para garantir a otimização de drivers de vídeo, mouse, rede e funcionalidades de gerenciamento.
Antes de partir para a reconstrução manual, considere as seguintes alternativas:
Se a fonte do download fornecer um checksum (MD5, SHA1, SHA256), utilize uma ferramenta para calcular o hash do seu arquivo .ova localmente e compare os valores. Uma divergência confirma que o arquivo está corrompido e a solução é realizar o download novamente.
A ferramenta de linha de comando ovftool da VMware é mais robusta e fornece logs mais detalhados que a interface gráfica. Em alguns casos, ela consegue contornar problemas menores no pacote.
ovftool [opções] <origem.ova> <destino.vmx>
# O destino pode ser um caminho para um novo arquivo .vmx
ovftool C:\ova\meu_appliance.ova C:\VMs\novo_appliance\novo_appliance.vmx
# Ou diretamente para um host ESXi
ovftool C:\ova\meu_appliance.ova "vi://usuario:senha@host-esxi/datacenter/host/cluster"
Analise a saída do comando em busca de erros específicos que possam indicar a causa raiz do problema.
A ausência de um descritor OVF em um pacote de appliance virtual, embora bloqueie a importação direta, raramente significa a perda total do appliance. O disco virtual (.vmdk), que contém o sistema e os dados, geralmente permanece íntegro. Seguindo o procedimento de extração manual e reconstrução da máquina virtual, é possível recuperar a funcionalidade do appliance de forma eficaz e confiável, garantindo a continuidade das operações em ambientes VMware.