Backup Agent - Assistant CLI Linux

Objectif

Ce guide explique comment utiliser le script ovh-ba-install.sh fourni par OVHcloud pour installer et gérer l’agent de sauvegarde Veeam sur votre serveur Linux.

Vous y découvrirez comment récupérer les URL d’installation, lancer l’installation en une commande, naviguer dans le menu de l’assistant CLI et utiliser les outils de diagnostic.

Prérequis

• Disposer d'un service Backup Agent actif.

Accès à l'espace client OVHcloud

• Lien direct : Backup Agent
• Chemin de navigation : Bare Metal Cloud > Backup Agent

Côté serveur

Vocabulaire minimal

• curl : programme qui télécharge un fichier depuis une adresse web (https://…).
• sudo : « en tant qu'administrateur » — nécessaire pour installer des logiciels système.
• bash : interpréteur qui exécute le script que vous lui donnez.

En pratique

Présentation du script ovh-ba-install.sh

Le script ovh-ba-install.sh est un assistant en ligne de commande. Avec ce script, vous pouvez :

• Installer l'agent de gestion Veeam (Management Agent) à partir de l'URL du paquet disponible dans votre espace client ;
• Installer la commande globale ovhbackupagent sur le serveur, pour rouvrir le même menu à tout moment (sudo ovhbackupagent) ;
• Afficher un menu texte : statut des agents, interface Veeam, diagnostics, aide ;
• Diagnostiquer les problèmes (connexion à l'infrastructure, journaux, archive pour le support) ;
• Désinstaller les paquets Veeam et, si vous le souhaitez, le raccourci ovhbackupagent (Uninstall Wizard).

Récupérer les URL d'installation

Dans l'espace client OVHcloud, ouvrez votre Backup Agent, rendez-vous dans l'onglet Agents, puis cliquez sur le bouton Télécharger. Dans la fenêtre qui s'ouvre, sélectionnez Linux pour afficher la commande contenant les deux URL (script et paquet Linux).

Une seule ligne pour installer votre agent et votre assistant

Via la ligne de commande que nous vous fournissons, vous pouvez installer l'agent et l'assistant en même temps. Remplacez URL_DU_SCRIPT (à 2 reprises) et URL_DU_PAQUET_AGENT par les liens copiés précédemment.

curl -sSL "URL_DU_SCRIPT" | sudo bash -s -- --setup "URL_DU_PAQUET_AGENT" --script-url "URL_DU_SCRIPT"

Exemple :

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"

Après une installation réussie

1. Un résumé s'affiche pendant 15 secondes (ce qui a été fait, rôle du menu, rappel des touches).
2. L'écran Agent status s'ouvre pour suivre l'état Veeam (veeamconsoleconfig -s), avec rafraîchissement automatique.
3. Entrée ramène au menu principal.

Pour rouvrir l'assistant plus tard :

sudo ovhbackupagent

(Si la commande n'est pas trouvée, essayez sudo /usr/local/bin/ovhbackupagent ou vérifiez que /usr/local/bin est dans votre PATH.)

Autres commandes utiles

Vous avez retéléchargé le script ?

Si vous lancez le script sans argument avec un terminal interactif (sudo bash ovh-ba-install.sh), un court écran d'accueil vérifie si ovhbackupagent est encore présent et si le Backup Agent est détecté, puis propose au besoin de réinstaller uniquement le raccourci.

Exemple pas à pas : première installation

Scénario : nouveau serveur Linux, vous disposez des deux URL (script et paquet Linux) copiées depuis la fenêtre Télécharger l'agent de votre espace client.

1. Connectez-vous en SSH au serveur avec un utilisateur autorisé à utiliser sudo.

ssh <user>@<IPouDNSdevotreserveur>

2. Remplacez URL_DU_SCRIPT (à 2 reprises) et URL_DU_PAQUET_AGENT dans la commande ci-dessous par vos URL, puis exécutez-la.

curl -sSL "URL_DU_SCRIPT" | sudo bash -s -- --setup "URL_DU_PAQUET_AGENT" --script-url "URL_DU_SCRIPT"

3. Lisez l'introduction, validez avec Entrée pour lancer l'installation.

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




      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. Attendez la fin des étapes Veeam ; le script installe ensuite ovhbackupagent.

5. Lisez le résumé 15 secondes, puis observez l'Agent status ; le Backup Agent peut apparaître après quelques minutes (déploiement côté infrastructure).

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. Appuyez sur Entrée pour accéder au menu ; utilisez A pour revoir le statut, D pour les diagnostics si quelque chose bloque.

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

La ligne de statut en haut du menu indique OK/KO pour les paquets Management (veeamma) et Backup (veeam, veeam-libs), et un indicateur lié au dernier job de sauvegarde.

Dépannage et diagnostics

• D puis T : test de connexion vers la passerelle VSPC.
• D puis B : génération d'une archive (logs + infos système) à envoyer au support.
• D puis I : analyse des messages connus dans les journaux (agent.log, veeaminstaller.log, etc.).
• D puis J : outil d'arrêt forcé d'une session de sauvegarde (à utiliser avec prudence).

Pour aller plus loin dans vos diagnostics, consultez notre guide de diagnostic et de dépannage Backup Agent.

Assistant de désinstallation — Uninstall Wizard (touche U)

• Suppression de votre agent, selon votre famille d'OS (yum/dnf, zypper, apt-get).
• Question optionnelle pour supprimer /usr/local/bin/ovhbackupagent et le README associé.

FAQ

Puis-je lancer le script sans sudo ?
Non : des actions système sont nécessaires et requièrent des droits administrateur (sudo).

Le menu se ferme tout de suite après l'installation en pipe — que faire ?
Vous pouvez le réouvrir avec :

sudo ovhbackupagent

Où est le script une fois installé comme commande ?
En général : /usr/local/bin/ovhbackupagent.

Aller plus loin

Échangez avec notre communauté d'utilisateurs.