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.
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.
| Item | O que conferir | Por quê |
|---|---|---|
| Versão do Ubuntu | lsb_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 |
| Kernel | uname -r deve terminar em -generic | O kernel linux-kvm (imagens “minimal”) não é suportado pelo driver de snapshot |
| Versão do agente x versão do Cloud Connect | Pergunte ao provedor a versão do VCC | Agente 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 kernel | linux-headers-$(uname -r), dkms, gcc, make | O driver de snapshot é compilado via DKMS na instalação |
| Saída de rede | Ver a seção 1 | Sem 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:
| Destino | Porta | Para quê |
|---|---|---|
| Cloud Gateway do provedor | TCP 6180 | Management Agent, autenticação do tenant e controle do job |
repository.veeam.com | TCP 443 | Repositório de pacotes (instalação/atualização) |
Object storage do repositório (ex.: *.blob.core.windows.net) | TCP 443 | Quando 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 80 | Validaçã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 chamambdevfiltereveeamblksnap);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:
-
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.
-
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
| Mensagem | Causa provável | O que fazer |
|---|---|---|
| ”Unsupported OS version” (VSPC, Discovery) | Ubuntu interim ou fora do ciclo de suporte | Migrar 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 SO | Instalação manual na versão compatível |
| ”The selected backup agent is not managed by the backup portal” | Agente em modo Standalone | Ativar o agente no console (seção 5) |
“Connection failed. 110.” após ~30 min, com Certificate revocation check failed no log | Download da CRL bloqueado (IPS, filtro web, proxy) durante o backup direto para object storage | Liberar 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 agente | Agente mais novo que o Cloud Connect | Voltar 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
- Confira SO LTS, kernel
-generice versão do agente compatível com o Cloud Connect antes de instalar. - 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.
- Instale o Management Agent, aprove no VSPC, instale o Backup Agent na versão certa e ative o agente no console.
- Valide o primeiro backup pelo
Job.loge use o Download Logs do VSPC para diagnosticar sem precisar de acesso ao servidor.
Artigos relacionados
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