Backup Agent - Assistente CLI Linux

Objetivo

Este guia explica como utilizar o script ovh-ba-install.sh fornecido pela OVHcloud para instalar e gerir o agente de cópia de segurança Veeam no seu servidor Linux.

Vai descobrir como obter os URL de instalação, iniciar a instalação com um único comando, navegar no menu do assistente CLI e utilizar as ferramentas de diagnóstico.

Requisitos

• Dispor de um serviço Backup Agent ativo.

Acesso à área de cliente OVHcloud

• Link direto: Backup Agent
• Caminho de navegação: Bare Metal Cloud > Backup Agent

Do lado do servidor

Vocabulário mínimo

• curl: programa que descarrega um ficheiro a partir de um endereço web (https://…).
• sudo: "como administrador" — necessário para instalar software de sistema.
• bash: interpretador que executa o script que lhe é fornecido.

Instruções

Apresentação do script ovh-ba-install.sh

O script ovh-ba-install.sh é um assistente em linha de comandos. Com este script, pode:

• Instalar o agente de gestão Veeam (Management Agent) a partir do URL do pacote disponível na sua área de cliente;
• Instalar o comando global ovhbackupagent no servidor, para reabrir o mesmo menu a qualquer momento (sudo ovhbackupagent);
• Apresentar um menu de texto: estado dos agentes, interface Veeam, diagnósticos, ajuda;
• Diagnosticar problemas (ligação à infraestrutura, registos, arquivo para o suporte);
• Desinstalar os pacotes Veeam e, se o desejar, o atalho ovhbackupagent (Uninstall Wizard).

Obter os URL de instalação

Na área de cliente OVHcloud, abra o seu Backup Agent, aceda ao separador Agents e clique no botão Descarregar. Na janela que se abre, selecione Linux para apresentar o comando que contém os dois URL (script e pacote Linux).

Uma única linha para instalar o seu agente e o seu assistente

Através da linha de comandos que lhe fornecemos, pode instalar o agente e o assistente ao mesmo tempo. Substitua URL_DO_SCRIPT (2 vezes) e URL_DO_PACOTE_AGENTE pelos links copiados anteriormente.

curl -sSL "URL_DO_SCRIPT" | sudo bash -s -- --setup "URL_DO_PACOTE_AGENTE" --script-url "URL_DO_SCRIPT"

Exemplo:

curl -sSL "https://ovh-ba-downloads.s3.xxx.xxx/tmp/ovh-ba-install.sh" | sudo bash -s -- --setup "https://s3.xxx.xxx.cloud.ovh.net/xxxx/LinuxAgentPackages.vspc_tenant_xxxx.sh?X-Amz-Algorithm=xxx&X-Amz-Credential=xxx&X-Amz-Date=2xxx&X-Amz-Expires=xxx&X-Amz-SignedHeaders=xxx&X-Amz-Signature=xxx" --script-url "https://ovh-ba-downloads.s3.xxx.xxx/tmp/ovh-ba-install.sh"

Após uma instalação bem-sucedida

1. Um resumo é apresentado durante 15 segundos (o que foi feito, função do menu, lembrete das teclas).
2. O ecrã Agent status abre-se para acompanhar o estado Veeam (veeamconsoleconfig -s), com atualização automática.
3. Enter volta ao menu principal.

Para reabrir o assistente mais tarde:

sudo ovhbackupagent

(Se o comando não for encontrado, tente sudo /usr/local/bin/ovhbackupagent ou verifique que /usr/local/bin está no seu PATH.)

Outros comandos úteis

Voltou a descarregar o script?

Se lançar o script sem argumento com um terminal interativo (sudo bash ovh-ba-install.sh), um breve ecrã de boas-vindas verifica se ovhbackupagent ainda está presente e se o Backup Agent é detetado, propondo depois, se necessário, reinstalar apenas o atalho.

Exemplo passo a passo: primeira instalação

Cenário: novo servidor Linux, dispõe dos dois URL (script e pacote Linux) copiados a partir da janela Descarregar o agente da sua área de cliente.

1. Ligue-se por SSH ao servidor com um utilizador autorizado a utilizar sudo.

ssh <user>@<IP-ou-DNS-do-seu-servidor>

2. Substitua URL_DO_SCRIPT (2 vezes) e URL_DO_PACOTE_AGENTE no comando abaixo pelos seus URL e, em seguida, execute-o.

curl -sSL "URL_DO_SCRIPT" | sudo bash -s -- --setup "URL_DO_PACOTE_AGENTE" --script-url "URL_DO_SCRIPT"

3. Leia a introdução, valide com Enter para iniciar a instalação.

 ▗▄▖ ▗▖  ▗▖▗▖ ▗▖ ▗▄▄▖▗▖    ▗▄▖ ▗▖ ▗▖▗▄▄▄     ▗▖  ▗▖    ▗▖  ▗▖▗▄▄▄▖▗▄▄▄▖ ▗▄▖ ▗▖  ▗▖
▐▌ ▐▌▐▌  ▐▌▐▌ ▐▌▐▌   ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  █     ▝▚▞▘     ▐▌  ▐▌▐▌   ▐▌   ▐▌ ▐▌▐▛▚▞▜▌
▐▌ ▐▌▐▌  ▐▌▐▛▀▜▌▐▌   ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  █      ▐▌      ▐▌  ▐▌▐▛▀▀▘▐▛▀▀▘▐▛▀▜▌▐▌  ▐▌
▝▚▄▞▘ ▝▚▞▘ ▐▌ ▐▌▝▚▄▄▖▐▙▄▄▖▝▚▄▞▘▝▚▄▞▘▐▙▄▄▀    ▗▞▘▝▚▖     ▝▚▞▘ ▐▙▄▄▖▐▙▄▄▖▐▌ ▐▌▐▌  ▐▌




      Backup Agent — CLI Assistant
  ─────────────────────────────────────

  Backup Agent — guided first-time setup

This setup will, in order:
  1) Install the **Veeam Management Agent** from the link you were given.
  2) Install the **ovhbackupagent** command on this server (under /usr/local/bin).
     That command is your permanent shortcut to this menu — you will not need
     to download this script again for everyday use.
  3) Show an installation summary, wait 15 seconds, then open **Agent status** to follow Backup Agent deployment.

The Veeam Backup Agent itself is deployed by our infrastructure after the
Management Agent connects; that step can take a few minutes.

Press Enter to start the installation, or Ctrl+C to cancel...

4. Aguarde o final das etapas Veeam; o script instala em seguida ovhbackupagent.

5. Leia o resumo durante 15 segundos e, em seguida, observe o Agent status; o Backup Agent pode aparecer após alguns minutos (implementação do lado da infraestrutura).

Installation summary

[OK] The Management Agent was installed successfully.
[OK] The **ovhbackupagent** command is now available (example: sudo ovhbackupagent).

[Info] The **Backup Agent** will be deployed shortly by our infrastructure (often within a few minutes).
Next, the **Agent status** screen opens so you can follow **`veeamconsoleconfig -s`** until the Backup Agent appears.

Main menu - reminder (available again after Agent status)

**A** - Agent status: Management / Backup Agent state (this screen refreshes every few seconds).
**V** - Open the Veeam UI on the server (once the Backup Agent is installed).
**D** - Diagnostics: VSPC connectivity test, support bundle, log issue analyzer, force-stop stuck jobs.
**I** - Install or reinstall a Management Agent package from a file or URL (advanced).
**U** - Uninstall Veeam agent packages from this server (with confirmations).
**H** - Help and README.
**Q** - Exit the assistant.

[Info] Waiting 15 seconds, then opening Agent status...

Agent status (veeamconsoleconfig -s)

[Info] Retrieving Veeam status (up to 45s right after install)...
Management agent
    Connection state       : Connected
    Cloud gateway          : vspc-cgw1.prod01.eu-west-rbx.backup.ovhcloud.com:6180
    Connection account     : vspc-tenant-604276/vspc-tenant-cc1-604276
Backup agent
    Version                : 13.0.1.404
    Driver version         : 13.0.1.404
    Status                 : Running

Your agents are running well.

Auto-refresh in 5s... Press Enter to return to menu.

6. Prima Enter para aceder ao menu; utilize A para rever o estado, D para os diagnósticos se algo estiver bloqueado.

Menu principal

 ▗▄▖ ▗▖  ▗▖▗▖ ▗▖ ▗▄▄▖▗▖    ▗▄▖ ▗▖ ▗▖▗▄▄▄     ▗▖  ▗▖    ▗▖  ▗▖▗▄▄▄▖▗▄▄▄▖ ▗▄▖ ▗▖  ▗▖
▐▌ ▐▌▐▌  ▐▌▐▌ ▐▌▐▌   ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  █     ▝▚▞▘     ▐▌  ▐▌▐▌   ▐▌   ▐▌ ▐▌▐▛▚▞▜▌
▐▌ ▐▌▐▌  ▐▌▐▛▀▜▌▐▌   ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  █      ▐▌      ▐▌  ▐▌▐▛▀▀▘▐▛▀▀▘▐▛▀▜▌▐▌  ▐▌
▝▚▄▞▘ ▝▚▞▘ ▐▌ ▐▌▝▚▄▄▖▐▙▄▄▖▝▚▄▞▘▝▚▄▞▘▐▙▄▄▀    ▗▞▘▝▚▖     ▝▚▞▘ ▐▙▄▄▖▐▙▄▄▖▐▌ ▐▌▐▌  ▐▌




      Backup Agent — CLI Assistant
  ─────────────────────────────────────

  ┌──────────────────────────────────────────────────────────────────────────┐
     Management Agent:   OK     Backup Agent:   OK     Last backup:  N/A 
  └──────────────────────────────────────────────────────────────────────────┘

  A  Agent status (veeamconsoleconfig -s)
  V  Open Veeam interface (veeam command)
  D  Diagnostic (test connection, support bundle, issue analyzer, job force stop)
  I  Install Management Agent (only if you want to reinstall it)
  U  Uninstall Wizard
  H  Help / README
  Q  Quit

  Your choice (A/V/D/I/U/H/Q):

A linha de estado no topo do menu indica OK/KO para os pacotes Management (veeamma) e Backup (veeam, veeam-libs), e um indicador relativo à última tarefa de cópia de segurança.

Resolução de problemas e diagnósticos

• D e depois T: teste de ligação ao gateway VSPC.
• D e depois B: geração de um arquivo (registos + informações do sistema) para enviar ao suporte.
• D e depois I: análise das mensagens conhecidas nos registos (agent.log, veeaminstaller.log, etc.).
• D e depois J: ferramenta de paragem forçada de uma sessão de cópia de segurança (a utilizar com prudência).

Para aprofundar os seus diagnósticos, consulte o nosso guia de diagnóstico e resolução de problemas Backup Agent.

Assistente de desinstalação — Uninstall Wizard (tecla U)

• Remoção do seu agente, de acordo com a sua família de SO (yum/dnf, zypper, apt-get).
• Pergunta opcional para remover /usr/local/bin/ovhbackupagent e o README associado.

FAQ

Posso executar o script sem sudo?
Não: são necessárias ações de sistema que requerem permissões de administrador (sudo).

O menu fecha-se imediatamente após a instalação em pipe — o que fazer?
Pode reabri-lo com:

sudo ovhbackupagent

Onde está o script depois de instalado como comando?
Em geral: /usr/local/bin/ovhbackupagent.

Quer saber mais?

Fale com a nossa comunidade de utilizadores.