Veeam Agent for Linux + VSPC: como instalar e ativar em servidores Ubuntu

Instalar o Veeam Agent for Linux em um servidor Ubuntu gerenciado pelo Veeam Service Provider Console (VSPC) envolve dois componentes distintos — o Backup Agent (motor de backup) e o Management Agent (que conecta o servidor ao portal) — e uma etapa final de ativação que costuma ser esquecida. Este procedimento cobre o passo a passo completo, do zero até o agente aparecer como gerenciado no console.

Pré-requisitos

• Servidor Ubuntu com acesso root (ou sudo) via SSH
• Acesso de saída a repository.veeam.com (porta 443)
• Pacote veeam-release-deb (instalador do repositório oficial Veeam)
• Script de instalação do Management Agent gerado pelo VSPC para o cliente específico (Discovery → Deploy Agent → Linux). Esse script já vem vinculado à organização correta do cliente — não reutilize o script de um cliente em outro.

Os arquivos .deb e .sh não ficam neste post por conterem token de vinculação específico de cada cliente. Baixe o veeam-release-deb genérico do repositório oficial da Veeam e gere o script do Management Agent direto no VSPC (por cliente).

1. Copiar os instaladores para o servidor

scp veeam-release-deb_<versao>_amd64.deb root@<IP_DO_SERVIDOR>:/root/
scp LinuxAgentPackages.<NOME_DO_CLIENTE>.sh root@<IP_DO_SERVIDOR>:/root/

2. Adicionar o repositório oficial da Veeam

ssh root@<IP_DO_SERVIDOR>
dpkg -i /root/veeam-release-deb_<versao>_amd64.deb
apt-get update

3. Verificar a versão exigida do Backup Agent

Antes de instalar, confirme qual versão do agente é compatível com o ambiente do cliente (algumas integrações exigem uma versão fixa, ex: 6.3):

apt-cache madison veeam

Instale a versão pinada (substitua pela versão exigida):

apt-get install -y veeam=6.3.2.1405 veeam-libs=6.3.2.1405

Servidor é container (LXC/Docker) sem acesso ao kernel do host? O pacote veeam compila via DKMS o driver veeamsnap, necessário para snapshot/CBT em backup de volume — isso falha em containers não privilegiados. Nesse cenário específico, use a variante sem driver:

apt-get remove -y --purge veeam veeamsnap
apt-get install -y veeam-nosnap=6.3.2.1405

Em servidores físicos ou VMs completas (o caso normal de produção), use sempre o pacote veeam padrão.

Verifique o serviço:

systemctl status veeamservice

4. Instalar o Management Agent do VSPC

chmod +x /root/LinuxAgentPackages.<NOME_DO_CLIENTE>.sh
/root/LinuxAgentPackages.<NOME_DO_CLIENTE>.sh

Ao final, confira o status:

veeamconfig mode info
veeamconsoleconfig -s
systemctl status veeammaservice

Nesse ponto o status normal é “Disconnected (connection has not been verified yet)” — aguardando aprovação manual no console.

5. Aprovar e ativar no console VSPC

Esta é a etapa que mais gera confusão, porque são duas ações separadas no console:

1. Aprovar a conexão: em Discovery (ou na empresa do cliente), localize o computador pendente e aprove a conexão do Management Agent.

2. Ativar o Backup Agent: mesmo já aprovado, ao tentar criar/atribuir um job de backup pode aparecer o erro:

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

   Isso acontece porque o agente ainda está em modo Standalone — o portal aprovou a conexão, mas não assumiu o gerenciamento do backup ainda. Resolva em Backup & Restore → Backup Agents, localize o computador, e use a opção de ativação/managed mode (transforma o agente de Standalone para “Managed by backup policy”). Depois disso, atribua a Backup Policy normalmente.

6. Confirmação final

No servidor, o comando abaixo deve mostrar o agente vinculado ao portal com modo definido (não mais “Not set”):

veeamconfig mode info
veeamconfig license show

Com isso o servidor Ubuntu está com o Veeam Agent for Linux instalado, conectado ao VSPC e pronto para receber a política de backup do cliente.

Artigos relacionados

Veeam Backup como Serviço (BaaS) vs Recuperação de Desastres como Serviço (DRaaS) 17 de jul. de 2026 Veeam Guia Essencial para a Regra de Backup 3-2-1-1-0 para Segurança de Dados 17 de jul. de 2026 Veeam Veeam Cloud Connect: Backup offsite para a nuvem sem infraestrutura própria 27 de mai. de 2025