Backup Agent - Linux CLI-Assistent

Ziel

Diese Anleitung erklärt, wie Sie das Skript ovh-ba-install.sh von OVHcloud verwenden, um den Veeam Backup Agent auf Ihrem Linux-Server zu installieren und zu verwalten.

Sie erfahren, wie Sie die Installations-URLs abrufen, die Installation mit einem einzigen Befehl durchführen, im Menü des CLI-Assistenten navigieren und die Diagnosetools verwenden.

Voraussetzungen

• Sie verfügen über einen aktiven Backup Agent Dienst.

Zugang zum OVHcloud Kundencenter

• Direktlink: Backup Agent
• Navigationspfad: Bare Metal Cloud > Backup Agent

Auf dem Server

Grundlegendes Vokabular

• curl: Programm, das eine Datei von einer Webadresse (https://…) herunterlädt.
• sudo: "als Administrator" — erforderlich, um Systemsoftware zu installieren.
• bash: Shell, die das übergebene Skript ausführt.

In der praktischen Anwendung

Übersicht über das Skript ovh-ba-install.sh

Das Skript ovh-ba-install.sh ist ein Kommandozeilen-Assistent, mit dem Sie:

• Den Veeam Management Agent mithilfe der Paket-URL aus Ihrem Kundencenter installieren können;
• Den globalen Befehl ovhbackupagent auf dem Server installieren können, um das Menü jederzeit aufzurufen (sudo ovhbackupagent);
• Ein Textmenü anzeigen können: Agentenstatus, Veeam-Oberfläche, Diagnose, Hilfe;
• Probleme diagnostizieren können (Verbindung zur Infrastruktur, Logs, Archiv für den Support);
• Veeam-Pakete und optional den Befehl ovhbackupagent deinstallieren können (Deinstallationsassistent).

Installations-URLs abrufen

Öffnen Sie im OVHcloud Kundencenter Ihren Backup Agent, wechseln Sie zum Tab Agents und klicken Sie auf die Schaltfläche Herunterladen. Wählen Sie im daraufhin geöffneten Fenster Linux aus, um den Befehl mit beiden URLs (Skript und Linux-Paket) anzuzeigen.

Eine Zeile zur Installation von Agent und Assistent

Mithilfe des von uns bereitgestellten Befehls können Sie den Agent und den Assistenten gleichzeitig installieren. Ersetzen Sie SCRIPT_URL (an 2 Stellen) und AGENT_PACKAGE_URL durch die zuvor kopierten Links.

curl -sSL "SCRIPT_URL" | sudo bash -s -- --setup "AGENT_PACKAGE_URL" --script-url "SCRIPT_URL"

Beispiel:

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"

Nach einer erfolgreichen Installation

1. Eine Zusammenfassung wird 15 Sekunden lang angezeigt (durchgeführte Aktionen, Menüfunktion, wichtige Hinweise).
2. Der Bildschirm Agent status öffnet sich, um den Veeam-Status zu verfolgen (veeamconsoleconfig -s), mit automatischer Aktualisierung.
3. Mit Enter gelangen Sie zurück zum Hauptmenü.

Um den Assistenten später erneut zu öffnen:

sudo ovhbackupagent

(Falls der Befehl nicht gefunden wird, versuchen Sie sudo /usr/local/bin/ovhbackupagent oder prüfen Sie, ob /usr/local/bin in Ihrem PATH enthalten ist.)

Weitere nützliche Befehle

Skript erneut heruntergeladen?

Wenn Sie das Skript ohne Argumente in einem interaktiven Terminal ausführen (sudo bash ovh-ba-install.sh), prüft ein kurzer Begrüßungsbildschirm, ob ovhbackupagent noch vorhanden ist und ob der Backup Agent erkannt wird, und bietet anschließend an, nur die Verknüpfung neu zu installieren.

Schritt-für-Schritt-Beispiel: Erstinstallation

Szenario: Neuer Linux-Server; Sie haben beide URLs (Skript und Linux-Paket) aus dem Fenster Download Agent in Ihrem Kundencenter kopiert.

1. Verbinden Sie sich per SSH mit dem Server, mit einem Benutzer, der sudo verwenden darf.

ssh <user>@<server-ip-or-hostname>

2. Ersetzen Sie im folgenden Befehl SCRIPT_URL (an 2 Stellen) und AGENT_PACKAGE_URL durch Ihre URLs und führen Sie ihn aus.

curl -sSL "SCRIPT_URL" | sudo bash -s -- --setup "AGENT_PACKAGE_URL" --script-url "SCRIPT_URL"

3. Lesen Sie die Einführung und drücken Sie dann Enter, um die Installation zu starten.

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




      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. Warten Sie, bis die Veeam-Schritte abgeschlossen sind; das Skript installiert anschließend ovhbackupagent.

5. Lesen Sie die Zusammenfassung für 15 Sekunden und beobachten Sie dann den Agent status; der Backup Agent kann nach einigen Minuten erscheinen (Bereitstellung auf Infrastrukturseite).

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. Drücken Sie Enter, um das Menü aufzurufen; verwenden Sie A, um den Status erneut anzuzeigen, oder D für die Diagnose, falls etwas hängt.

Hauptmenü

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




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

Die Statuszeile oben im Menü zeigt OK/KO für Management (veeamma) und Backup (veeam, veeam-libs) Pakete sowie einen Indikator zum letzten Backup-Job an.

Fehlerbehebung und Diagnose

• D dann T: Konnektivitätstest zum VSPC-Gateway.
• D dann B: Archiv erstellen (Logs + Systeminformationen), um es an den Support zu senden.
• D dann I: Analyse bekannter Meldungen in den Logs (agent.log, veeaminstaller.log usw.).
• D dann J: Tool zum erzwungenen Stopp einer Backup-Sitzung (mit Vorsicht verwenden).

Für eine weiterführende Diagnose lesen Sie unsere Anleitung zur Fehlerbehebung des Backup Agent.

Deinstallationsassistent (Taste U)

• Entfernt Ihren Agent entsprechend Ihrer Betriebssystemfamilie (yum/dnf, zypper, apt-get).
• Optionale Aufforderung zur Entfernung von /usr/local/bin/ovhbackupagent und der zugehörigen README.

FAQ

Kann ich das Skript ohne sudo ausführen?
Nein: Es sind Aktionen auf Systemebene erforderlich, die Administratorrechte (sudo) benötigen.

Das Menü wird nach einer Installation per Pipe sofort geschlossen — was tun?
Sie können es erneut öffnen mit:

sudo ovhbackupagent

Wo befindet sich das Skript nach der Installation als Befehl?
In der Regel unter /usr/local/bin/ovhbackupagent.

Weiterführende Informationen

Treten Sie unserer User Community bei.