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

  • Direkter Link:
  • Navigationspfad: Bare Metal Cloud > Backup Agent

Auf dem Server

ElementDetail
BetriebssystemLinux, kompatibel mit Veeam Agent for Linux (siehe Veeam-Systemanforderungen und Backup Agent Einschränkungen).
BerechtigungenAdministrator-Zugang: Installationsbefehle verwenden in der Regel sudo.
NetzwerkDer Server muss das Skript und das Agentenpaket herunterladen (HTTPS) und das Backup-Gateway VSPC (Veeam Service Provider Console) gemäß den Regeln Ihres Angebots erreichen können.
TerminalEine SSH-Sitzung oder Serverkonsole, interaktiv für das Menü.

Grundlegendes Vokabular

BefehlFunktion
curlProgramm, das eine Datei von einer Webadresse (https://…) herunterlädt.
sudo"Als Administrator" — erforderlich, um Systemsoftware zu installieren.
bashShell, 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).
Warning

Das Skript vereinfacht die Installation und die tägliche Überwachung auf dem Server; es ersetzt nicht die Konfiguration Ihrer Backups in der Veeam Agent Oberfläche. Die Kündigung des Dienstes erfolgt im OVHcloud Kundencenter, nicht über dieses Skript.

Installation

Schritt 1 — Installations-URLs abrufen

Öffnen Sie im OVHcloud Kundencenter Ihren , 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.

Backup Agent Download — Linux-Installationsbefehle
Info

Kopieren Sie jede URL einzeln in eine Textdatei, bevor Sie sich per SSH verbinden.

Schritt 2 — Mit dem Server verbinden

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

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

Schritt 3 — Installation ausführen

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"

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"

Schritt 4 — Willkommensbildschirm

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...

Schritt 5 — Installation läuft

Warten Sie, bis die Veeam-Schritte abgeschlossen sind; das Skript installiert anschließend den Befehl ovhbackupagent.

Schritt 6 — Zusammenfassung und Agentenstatus

Lesen Sie die Zusammenfassung, die 15 Sekunden lang angezeigt wird, und beobachten Sie dann den Bildschirm 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...

Nach 15 Sekunden öffnet sich automatisch der Bildschirm 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.

Drücken Sie Enter, um das Hauptmenü aufzurufen.

Assistenten erneut öffnen

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.

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.

TasteFunktion
AAgentenstatus (automatische Aktualisierung).
VVeeam-Oberfläche auf dem Server öffnen, um Ihre Backups und Wiederherstellungen zu verwalten (sobald der Backup Agent bereit ist).
DDiagnose-Untermenü: VSPC-Test, Support-Archiv, Log-Analyse, erzwungener Stopp eines hängenden Backups.
IManagement Agent von einer Datei oder URL neu installieren (erweitert).
UDeinstallationsassistent: Veeam-Pakete deinstallieren + optionale Entfernung von ovhbackupagent.
HIntegrierte Hilfe / README.
QBeenden.

Fehlerbehebung und Diagnose

TastenAktion
D dann TKonnektivitätstest zum VSPC-Gateway.
D dann BArchiv erstellen (Logs + Systeminformationen), um es an den Support zu senden.
D dann IAnalyse bekannter Meldungen in den Logs (agent.log, veeaminstaller.log usw.).
D dann JTool 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.
Warning

Die Deinstallation der Agents kündigt nicht Ihr Backup Agent Abonnement. Der Dienst bleibt bei OVHcloud aktiv, bis Sie ihn im Kundencenter kündigen. Sie können die Agents später über Ihre Backup-Oberfläche neu installieren.

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?
Öffnen Sie es erneut mit sudo ovhbackupagent.

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

Die Agents sind bereits installiert, wie installiere ich nur den Assistenten?
Verwenden Sie sudo bash ovh-ba-install.sh --setup-local.

Ich habe das Skript erneut heruntergeladen, was passiert, wenn ich es ohne Argumente ausführe?
Ein kurzer Begrüßungsbildschirm prüft, ob ovhbackupagent noch vorhanden ist und ob der Backup Agent erkannt wird, und bietet anschließend an, nur die Verknüpfung neu zu installieren.

Wie zeige ich die integrierte Hilfe an?
Verwenden Sie sudo bash ovh-ba-install.sh --readme.

Weiterführende Informationen

Sobald Ihre Agents laufen, konfigurieren Sie Ihre Backups über die Veeam Agent Oberfläche auf dem Server (Taste V im Assistenten).

Treten Sie unserer User Community bei.

War diese Seite hilfreich?