Backup Agent - Assistente CLI Linux

Obiettivo

Questa guida spiega come utilizzare lo script ovh-ba-install.sh fornito da OVHcloud per installare e gestire l'agente di backup Veeam sul tuo server Linux.

Scoprirai come recuperare gli URL di installazione, avviare l'installazione con un solo comando, navigare nel menu dell'assistente CLI e utilizzare gli strumenti di diagnostica.

Prerequisiti

• Disporre di un servizio Backup Agent attivo.

Accesso allo Spazio Cliente OVHcloud

• Link diretto: Backup Agent
• Percorso di navigazione: Bare Metal Cloud > Backup Agent

Lato server

Vocabolario minimo

• curl: programma che scarica un file da un indirizzo web (https://…).
• sudo: "come amministratore" — necessario per installare software di sistema.
• bash: interprete che esegue lo script che gli viene fornito.

Procedura

Presentazione dello script ovh-ba-install.sh

Lo script ovh-ba-install.sh è un assistente a riga di comando. Con questo script puoi:

• Installare l'agente di gestione Veeam (Management Agent) a partire dall'URL del pacchetto disponibile nel tuo Spazio Cliente;
• Installare il comando globale ovhbackupagent sul server, per riaprire lo stesso menu in qualsiasi momento (sudo ovhbackupagent);
• Visualizzare un menu testuale: stato degli agenti, interfaccia Veeam, diagnostica, aiuto;
• Diagnosticare i problemi (connessione all'infrastruttura, log, archivio per il supporto);
• Disinstallare i pacchetti Veeam e, se lo desideri, il collegamento ovhbackupagent (Uninstall Wizard).

Recuperare gli URL di installazione

Nello Spazio Cliente OVHcloud, apri il tuo Backup Agent, vai nella scheda Agent, quindi clicca sul pulsante Scarica. Nella finestra che si apre, seleziona Linux per visualizzare il comando contenente i due URL (script e pacchetto Linux).

Una sola riga per installare l'agente e l'assistente

Tramite la riga di comando che ti forniamo, puoi installare l'agente e l'assistente contemporaneamente. Sostituisci URL_DELLO_SCRIPT (2 volte) e URL_DEL_PACCHETTO_AGENTE con i link copiati in precedenza.

curl -sSL "URL_DELLO_SCRIPT" | sudo bash -s -- --setup "URL_DEL_PACCHETTO_AGENTE" --script-url "URL_DELLO_SCRIPT"

Esempio:

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"

Dopo un'installazione riuscita

1. Un riepilogo viene visualizzato per 15 secondi (operazioni eseguite, ruolo del menu, promemoria dei tasti).
2. Si apre la schermata Agent status per seguire lo stato Veeam (veeamconsoleconfig -s), con aggiornamento automatico.
3. Invio riporta al menu principale.

Per riaprire l'assistente in seguito:

sudo ovhbackupagent

(Se il comando non viene trovato, prova sudo /usr/local/bin/ovhbackupagent o verifica che /usr/local/bin sia nel tuo PATH.)

Altri comandi utili

Hai scaricato nuovamente lo script?

Se avvii lo script senza argomenti con un terminale interattivo (sudo bash ovh-ba-install.sh), una breve schermata di benvenuto verifica se ovhbackupagent è ancora presente e se il Backup Agent è rilevato, quindi propone eventualmente di reinstallare solo il collegamento.

Esempio passo dopo passo: prima installazione

Scenario: nuovo server Linux, disponi dei due URL (script e pacchetto Linux) copiati dalla finestra Scaricare l'agente del tuo Spazio Cliente.

1. Connettiti in SSH al server con un utente autorizzato a utilizzare sudo.

ssh <user>@<IP-o-DNS-del-server>

2. Sostituisci URL_DELLO_SCRIPT (2 volte) e URL_DEL_PACCHETTO_AGENTE nel comando seguente con i tuoi URL, quindi eseguilo.

curl -sSL "URL_DELLO_SCRIPT" | sudo bash -s -- --setup "URL_DEL_PACCHETTO_AGENTE" --script-url "URL_DELLO_SCRIPT"

3. Leggi l'introduzione, conferma con Invio per avviare l'installazione.

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




      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. Attendi il completamento delle fasi Veeam; lo script installa quindi ovhbackupagent.

5. Leggi il riepilogo per 15 secondi, quindi osserva l'Agent status; il Backup Agent può apparire dopo qualche minuto (distribuzione lato infrastruttura).

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. Premi Invio per accedere al menu; utilizza A per rivedere lo stato, D per la diagnostica se qualcosa si blocca.

Menu principale

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




      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):

La riga di stato in cima al menu indica OK/KO per i pacchetti Management (veeamma) e Backup (veeam, veeam-libs), e un indicatore relativo all'ultimo job di backup.

Risoluzione dei problemi e diagnostica

• D poi T: test di connessione verso il gateway VSPC.
• D poi B: generazione di un archivio (log + informazioni di sistema) da inviare al supporto.
• D poi I: analisi dei messaggi noti nei log (agent.log, veeaminstaller.log, ecc.).
• D poi J: strumento di arresto forzato di una sessione di backup (da utilizzare con cautela).

Per approfondire la diagnostica, consulta la nostra guida alla diagnostica e alla risoluzione dei problemi Backup Agent.

Assistente di disinstallazione — Uninstall Wizard (tasto U)

• Rimozione dell'agente, in base alla famiglia del tuo sistema operativo (yum/dnf, zypper, apt-get).
• Domanda opzionale per rimuovere /usr/local/bin/ovhbackupagent e il README associato.

FAQ

Posso avviare lo script senza sudo?
No: sono necessarie operazioni di sistema che richiedono permessi di amministratore (sudo).

Il menu si chiude subito dopo l'installazione in pipe — cosa fare?
Puoi riaprirlo con:

sudo ovhbackupagent

Dove si trova lo script una volta installato come comando?
In genere: /usr/local/bin/ovhbackupagent.

Per saperne di più

Contatta la nostra Community di utenti.