Ir para o conteúdo principal
Veeam · Atualizado em 27 de outubro de 2026

Veeam Agent for Linux + VSPC: como instalar, ativar e fazer backup para o Cloud Connect

Procedimento completo para instalar o Veeam Agent for Linux e o Management Agent do VSPC em servidores Ubuntu, com checklist de compatibilidade, liberações de firewall (incluindo CRL e IPS) e diagnóstico dos erros mais comuns no backup para nuvem.

E Equipe Callister

Instalar o Veeam Agent for Linux em um servidor Ubuntu gerenciado pelo Veeam Service Provider Console (VSPC) envolve dois componentes distintos — o Management Agent (que conecta o servidor ao portal) e o Backup Agent (o motor de backup) — e uma etapa de ativação no console que costuma ser esquecida. Quando o destino é o Veeam Cloud Connect, ainda entra um terceiro fator que quase ninguém documenta: o firewall do cliente precisa deixar o agente validar certificados.

Este procedimento foi revisado depois de reproduzirmos em laboratório uma falha real de backup Linux para nuvem. Ele cobre do zero até o primeiro backup concluído, e termina com uma tabela de erros e o que cada um significa.

0. Antes de começar: checklist de compatibilidade

A maioria dos problemas que vemos começa aqui, não na instalação.

ItemO que conferirPor quê
Versão do Ubuntulsb_release -a — use LTS (20.04, 22.04, 24.04)Versões interim (21.10, 22.10…) aparecem no VSPC como “Unsupported OS version” e o console recusa instalar o Backup Agent
Kerneluname -r deve terminar em -genericO kernel linux-kvm (imagens “minimal”) não é suportado pelo driver de snapshot
Versão do agente x versão do Cloud ConnectPergunte ao provedor a versão do VCCAgente mais novo que o Cloud Connect quebra o job de nuvem. Ex.: Cloud Connect 12.3 → agente da linha 6.3.x, não a v13
Headers do kernellinux-headers-$(uname -r), dkms, gcc, makeO driver de snapshot é compilado via DKMS na instalação
Saída de redeVer a seção 1Sem as liberações, o agente instala e conecta, mas o backup falha

Atenção à versão distribuída pelo VSPC. O VSPC empurra a versão de agente que ele traz no pacote (em VSPC 9.x, a v13). Se o seu Cloud Connect ainda está na v12, instale o agente manualmente na versão compatível (seção 4) em vez de deixar o console instalar.

1. Liberações de firewall (a parte que derruba o backup)

O Management Agent só precisa falar com o Cloud Gateway do provedor. Já o backup para nuvem pode precisar de bem mais:

DestinoPortaPara quê
Cloud Gateway do provedorTCP 6180Management Agent, autenticação do tenant e controle do job
repository.veeam.comTCP 443Repositório de pacotes (instalação/atualização)
Object storage do repositório (ex.: *.blob.core.windows.net)TCP 443Quando o repositório do Cloud Connect é object storage, o agente grava os dados direto nele
CRL/OCSP da autoridade certificadora do storage (ex.: www.microsoft.com/pkiops, crl.microsoft.com, oneocsp.microsoft.com)TCP 80Validação de revogação do certificado do storage

Por que um servidor Linux acessa um endereço da Microsoft?

No Cloud Connect v12, se o repositório do tenant é um object storage (Azure Blob, S3 compatível etc.), o agente usa backup direto: o Cloud Gateway só cuida do controle e entrega as credenciais, e os dados saem do servidor direto para o storage. No log isso aparece como Direct backup is supported.

Antes de gravar, o agente valida o certificado TLS do storage. Se o storage é Azure, o certificado é emitido por uma CA da Microsoft, e a lista de certificados revogados (CRL) fica em http://www.microsoft.com/pkiops/..., por HTTP, porta 80. O agente Linux baixa essa CRL por conta própria — ele não usa o cache do sistema operacional, como o Windows faz. Por isso o mesmo repositório funciona com agentes Windows e falha com Linux.

IPS, filtro de conteúdo e antivírus de gateway

Liberar a porta na regra de acesso não basta se o firewall faz inspeção. Em um caso real com SonicWall, o servidor já estava na exclusão do filtro de conteúdo, mas o IPS derrubava o download da CRL:

DROPPED, Drop Code: 135 (IDP detection DROP_IP_IDP_RESET_CONNECTION)

A exclusão no SonicWall é por serviço: estar excluído do Content Filter não exclui do IPS, Gateway Anti-Virus, Capture ATP ou App Control. A correção foi uma exclusão do servidor na assinatura de IPS que disparava. Para descobrir qual serviço está bloqueando, use o Packet Monitor — o passo a passo está em captura de pacotes no SonicWall.

Teste rápido antes de instalar

Rode no servidor (não altera nada):

t() { printf '%-26s ' "$1"; curl -sS -o /dev/null -m 20 -w '%{http_code} %{time_total}s\n' "$2" 2>&1 | tail -1; }
t "CRL Microsoft (80)"   "http://www.microsoft.com/pkiops/crl/partition/Microsoft%20TLS%20G2%20RSA%20CA%20OCSP%2004_Partition00045.crl"
t "crl.microsoft.com (80)" "http://crl.microsoft.com/pki/crl/products/MicRooCerAut2011_2011_03_22.crl"
t "Azure Blob (443)"     "https://<CONTA>.blob.core.windows.net/"   # conta do repositório: peça ao provedor
t "Repositório Veeam"    "https://repository.veeam.com/"
timeout 5 bash -c '</dev/tcp/<CLOUD_GATEWAY>/6180' && echo "Cloud Gateway 6180   ok"

200 na CRL e qualquer resposta HTTP (até 400/404) no blob significam caminho livre. 000 com “Connection reset by peer” é bloqueio — normalmente IPS, filtro web ou proxy.

2. Preparar o sistema

sudo apt-get update
sudo apt-get install -y linux-headers-$(uname -r) dkms gcc make

Se o servidor ainda está em uma versão do Ubuntu fora de suporte, o apt só funciona apontando para old-releases.ubuntu.com. Isso resolve a instalação, mas não o suporte: planeje a migração para uma LTS.

3. Instalar o Management Agent do VSPC

Gere o script no VSPC para o cliente específico (Discovery → Deploy Agent → Linux). Ele já vem vinculado à organização certa — não reutilize o script de um cliente em outro.

scp LinuxAgentPackages.<CLIENTE>.sh root@<SERVIDOR>:/root/
ssh root@<SERVIDOR>
chmod +x /root/LinuxAgentPackages.<CLIENTE>.sh
/root/LinuxAgentPackages.<CLIENTE>.sh

Confira:

systemctl status veeammaservice
veeamconsoleconfig -s

O status inicial normal é “Disconnected (connection has not been verified yet)”: falta aprovar no console. Em Discovery, localize o computador pendente e aprove a conexão. Depois disso o veeamconsoleconfig -s mostra o Cloud Gateway e o status conectado.

4. Instalar o Backup Agent na versão certa

Caminho 1 — pelo VSPC. Se o SO é suportado e a versão que o VSPC distribui é compatível com o seu Cloud Connect, instale pelo console (Discovery → selecionar o computador → instalar Backup Agent).

Caminho 2 — manual, com versão fixa. Necessário quando o VSPC recusa o SO ou distribui uma versão mais nova que o Cloud Connect:

# Repositório oficial (pacote veeam-release-deb, baixado do site da Veeam)
dpkg -i veeam-release-deb_<versao>_amd64.deb
apt-get update
apt-cache madison veeam          # versões disponíveis

Escolha o driver de snapshot:

  • blksnap — driver atual, para kernels recentes (no Veeam Agent 6.x os módulos se chamam bdevfilter e veeamblksnap);
  • veeamsnap — driver legado, para kernels mais antigos;
  • veeam-nosnap — sem driver, só para containers sem acesso ao kernel (sem snapshot de volume).
V=6.3.2.1501                     # versão compatível com o seu Cloud Connect
apt-get install -y veeam-libs=$V blksnap=$V veeam=$V
# ou: apt-get install -y veeam-libs=$V veeamsnap=$V veeam=$V
apt-mark hold veeam veeam-libs blksnap veeamsnap 2>/dev/null   # evita upgrade automático para a v13

Valide o driver e o serviço:

dkms status
modprobe bdevfilter && modprobe veeamblksnap     # ou: modprobe veeamsnap
lsmod | grep -E 'veeamblksnap|bdevfilter|veeamsnap'
systemctl status veeamservice

Aceite os termos de licença (sem isso o veeamconfig fica perguntando e scripts travam):

veeamconfig agreement acceptEula
veeamconfig agreement acceptThirdPartyLicenses

5. Ativar o agente e atribuir a política no VSPC

São duas ações separadas no console:

  1. Ativar o Backup Agent. Mesmo com a conexão aprovada, ao atribuir um job pode aparecer:

    “The selected backup agent is not managed by the backup portal. Please activate this agent and try again.”

    O agente ainda está em modo Standalone. Em Backup & Restore → Backup Agents, localize o computador e ative o modo gerenciado.

  2. Licença e política. Aplique a licença e atribua a Backup Policy com destino ao cloud repository do tenant.

No servidor:

veeamconfig license show     # License source: Backup Portal
veeamconfig job list         # a política aparece como job

6. Primeiro backup e validação

Dispare o job pelo VSPC e acompanhe no servidor:

veeamconfig session list
veeamconfig session log --id <ID_DA_SESSAO>

Um início saudável de backup para object storage mostra, no Job.log, a linha Test connection to Object-storage provider [] ok poucos segundos depois de Direct backup is supported. Se ela demora 30 minutos e termina em Failed, volte à seção 1.

Atenção ao “Running” no VSPC. Quando a primeira tentativa falha e o job está aguardando o retry, o console pode mostrar o job como Running sem erro. A falha só aparece no log da máquina.

7. Onde estão os logs

  • Pelo VSPC, sem acessar o servidor: Managed Computers → Backup Agents → selecionar o computador → Backup Agent → Download Logs. Vem um ZIP com todos os logs do agente. Os do Management Agent ficam em Discovery → Discovered Computers → Management Agent → Download Logs.
  • No servidor: /var/log/veeam/Backup/<nome do job>/Session_<data>_{id}/Job.log (um diretório por sessão) e /var/log/veeamma/ (Management Agent).

Para achar rapidamente a causa de uma sessão com falha:

f=$(ls -td /var/log/veeam/Backup/*/Session_* | head -1)/Job.log
grep -E 'SessionLog\]\[error|ERR \||revocation|Object-storage|Gateway is not available' "$f" | cut -c1-200

8. Erros comuns e o que significam

MensagemCausa provávelO que fazer
”Unsupported OS version” (VSPC, Discovery)Ubuntu interim ou fora do ciclo de suporteMigrar para LTS; enquanto isso, instalação manual (seção 4)
“Cannot install a backup agent as target computer guest OS version is not supported”O VSPC não tem pacote para essa versão do SOInstalação manual na versão compatível
”The selected backup agent is not managed by the backup portal”Agente em modo StandaloneAtivar o agente no console (seção 5)
“Connection failed. 110.” após ~30 min, com Certificate revocation check failed no logDownload da CRL bloqueado (IPS, filtro web, proxy) durante o backup direto para object storageLiberar HTTP 80 para as URLs de CRL/OCSP inclusive no IPS; se a saída é por proxy, configurar httpProxyUrl em /etc/veeam/veeam.ini
”Gateway is not available” / “Connection timed out”Falha ao abrir conexão com o Cloud Gateway na 6180 (o agente Linux abre uma conexão nova para quase cada chamada)Testar a 6180 em sequência; verificar proteção contra flood/SYN no firewall do cliente e do provedor
Job falha logo após atualização automática do agenteAgente mais novo que o Cloud ConnectVoltar para a versão compatível e fixar com apt-mark hold

Para erros de backup fora do contexto Linux, veja também os erros mais comuns do Veeam e como resolver e como funciona o backup offsite com Veeam Cloud Connect.

Resumo

  1. Confira SO LTS, kernel -generic e versão do agente compatível com o Cloud Connect antes de instalar.
  2. Libere a 6180 para o Cloud Gateway e, se o repositório for object storage, 443 para o storage e 80 para a CRL — com exclusão também no IPS.
  3. Instale o Management Agent, aprove no VSPC, instale o Backup Agent na versão certa e ative o agente no console.
  4. Valide o primeiro backup pelo Job.log e use o Download Logs do VSPC para diagnosticar sem precisar de acesso ao servidor.
#Veeam #VSPC #Cloud Connect #Backup Agent #Ubuntu #Linux #Procedimento #Troubleshooting

Precisa de ajuda com o seu backup Veeam?

Implantação, monitoramento e teste de restauração com quem faz isso todo dia.

Conhecer o serviço de backup