Sicherungs- und Notfallwiederherstellungs-Agent auf einem Linux-Host installieren
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie den Sicherungs- und Notfallwiederherstellungs-Agenten auf einem Linux-Host installieren und andere Vorgänge ausführen, z. B. einen geheimen Schlüssel neu generieren, den Status des Sicherungs- und Notfallwiederherstellungs-Agenten prüfen und den Sicherungs- und Notfallwiederherstellungs-Agenten neu starten.
So funktioniert es
Der Sicherungs- und Notfallwiederherstellungs-Agent für Linux wird als Daemonprozess unter dem Nutzernamen „root“ ausgeführt.
Er überwacht den TCP-Port 5106 auf Kommunikation von der Sicherungs-/Wiederherstellungs-Appliance.
Der Agent schreibt in eine Logdatei im Installationsverzeichnis /var/act/log/UDSAgent.log und veröffentlicht wichtige Ereignisse im Repository /var/log/messages.
Nach der Installation des Agents müssen Sie die vertrauenswürdige Kommunikation zwischen der Sicherungs-/Wiederherstellungs-Appliance und dem Sicherungs- und Notfallwiederherstellungs-Agenten initialisieren.
Dies muss nur einmal erfolgen.
Der geheime Schlüssel muss innerhalb von zwei Stunden nach der Generierung hinzugefügt werden.
Wenn der geheime Schlüssel abläuft, müssen Sie einen neuen Schlüssel generieren.
Agent auf einem Linux-Host installieren
So installieren Sie den Agent auf einem Linux-Host:
Laden Sie die Installationsdatei auf Ihren Linux-Server hoch.
Wählen Sie eine der folgenden Optionen aus, um den Agenten zu installieren:
Führen Sie für die 32-Bit-Installation unter Linux den folgenden Befehl aus.
rpm -ivh connector-Linux_x86-version.rpm
Führen Sie für die 64-Bit-Installation unter Linux den folgenden Befehl aus.
rpm -ivh connector-Linux-version.rpm
Führen Sie für die Linux Ubuntu-Installation den folgenden Befehl aus.
dpkg -i connector-linux_ubuntu_amd64-version.deb
Der Agent wird immer unter /opt/act installiert. Wenn die Installation abgeschlossen ist, wird ein geheimer Schlüssel angezeigt.
Speichern Sie den geheimen Schlüssel in einem Notizblock oder Texteditor. Sie müssen ihn im Bereich „Sicherungs- und Notfallwiederherstellungsagent“ hinzufügen. Weitere Informationen finden Sie unter Linux-Host hinzufügen.
Geheimen Schlüssel neu generieren
Der geheime Schlüssel, der im Abschnitt Agent auf einem Linux-Host installieren generiert wird, ist nur zwei Stunden lang gültig. Sie müssen es innerhalb dieses Zeitraums der Verwaltungskonsole hinzufügen oder ein neues generieren.
Folgen Sie der folgenden Anleitung, um einen neuen Schlüssel zu generieren und der Verwaltungskonsole hinzuzufügen.
Melden Sie sich auf dem Linux-Host als Root-Nutzer an und führen Sie einen der Befehle im Verzeichnis aus:
Führen Sie nach der Bestätigung der Aktion den folgenden Befehl aus, um den geheimen Schlüssel zurückzusetzen:
/opt/act/bin/udsagent secret --reset
Wenn Sie das Secret sofort ohne Bestätigung zurücksetzen möchten, führen Sie den folgenden Befehl aus:
/opt/act/bin/udsagent secret --reset --restart
Speichern Sie den geheimen Schlüssel in einem Notizblock oder Editor. Dieser Secret-Schlüssel ist zwei Stunden lang gültig.
Geheimschlüssel hinzufügen
Wenn Sie den geheimen Schlüssel aktualisieren oder ihn nicht beim ersten Mal hinzugefügt haben, können Sie den Linux-Host anhand der folgenden Anleitung hinzufügen.
Wählen Sie in der Verwaltungskonsole Verwalten und dann Hosts aus.
Klicken Sie mit der rechten Maustaste auf den Linux-Host und wählen Sie Bearbeiten aus.
Gehen Sie zum Bereich Einstellungen für Sicherungs- und Notfallwiederherstellungs-Agenten und suchen Sie das Feld Secret.
Status des Sicherungs- und Notfallwiederherstellungs-Agenten prüfen
Nachdem der Agent installiert ist, können Sie seinen Status auf den Linux-Hosts mit den folgenden Befehlen prüfen.
Führen Sie auf Nicht-Systemzielen (RHEL vor 7.0 und SUSE Linux vor 12.0) den folgenden Befehl aus.
service udsagent status
Die Ausgabe sieht für die Zeile udsagent daemon is running in etwa so aus:
service udsagent status
udsagent daemon is running
Führen Sie auf systemd-Zielen (RHEL 7.0 und höher, SUSE Linux 12.0 und höher sowie Ubuntu 16.0 und höher) den folgenden Befehl aus:
systemctl status udsagent
Die Ausgabe sieht dann ungefähr so aus:
```postgres[root@postgres~]# systemctl status udsagent●udsagent.service- Google Cloud BackupandDRserviceLoaded:loaded(/usr/lib/systemd/system/udsagent.service;enabled;vendorpreset:disabled)Active:active(running)sinceWed2022-11-0922:13:45UTC;17minageProcess:1056ExecStart=/act/initscripts/udsagent.initstart(code=exited,status=0/SUCCESS)MainPID:1128(udsagent)CGroup:/system.slice/udsagent.service├─1128/opt/act/bin/udsagentstart└─1132/opt/act/bin/udsagentstartNov0922:13:44postgressystemd[1]:Starting Google Cloud BackupandDRService…Nov0922:13:45postgresudsagent.init[1056]:Starting/opt/act/bin/udsagentasadaemon.Itmaytakeafewminutesfortheservicetostartcompletely.Nov0922:13:45postgresudsagent.init[1056]:Starting/opt/act/bin/udsagentasadaemon.Itmaytakeafewminutesfortheservicetostartcompletely.
Sicherungs- und Notfallwiederherstellungs-Agent auf einem Linux-Host neu starten
Führen Sie den folgenden Befehl auf dem Linux-Host aus, um den Sicherungs- und Notfallwiederherstellungs-Agenten neu zu starten.
Führen Sie auf Hosts ohne systemd (RHEL vor 7.0 und SUSE Linux vor 12.0) den folgenden Befehl aus:
/etc/init.d/udsagent restart
Führen Sie auf Systemd-Hosts (RHEL 7.0 und höher, SUSE Linux 12.0 und höher sowie Ubuntu 16.0 und höher) den folgenden Befehl aus:
systemctl restart udsagent
Sicherungs- und Notfallwiederherstellungs-Agent über die Befehlszeile von einem Linux-Host deinstallieren
So deinstallieren Sie den Sicherungs- und Notfallwiederherstellungs-Agenten auf einem Linux-Host:
CentOS/RHEL/SLES
Melden Sie sich als Root-Nutzer an und beenden Sie den Sicherungs- und Notfallwiederherstellungs-Agenten mit dem folgenden Befehl:
systemctl stop udsagent
Bei älteren Linux-Versionen müssen Sie möglicherweise den folgenden Befehl verwenden:
/etc/init.d/udsagent stop
Prüfen Sie mit dem folgenden Befehl den RPM-Namen des installierten Linux-Sicherungs- und Notfallwiederherstellungs-Agents:
yum list installed | grep udsagent
Sie können den RPM-Namen auch mit dem folgenden Befehl prüfen:
rpm -qa udsagent
Die Ausgabe sieht dann ungefähr so aus:
udsagent-11.0.1-8756.x86_64
Deinstallieren Sie das Paket mit dem Namen, den Sie aus der Abfrage erhalten haben.
Beispiel:
yum remove udsagent-11.0.1-8756.x86_64
Sie können das Paket auch mit dem folgenden Befehl deinstallieren:
rpm -e udsagent-11.0.1-8756.x86_64
Ubuntu
Melden Sie sich als Root-Nutzer an und beenden Sie den Sicherungs- und Notfallwiederherstellungs-Agenten mit dem folgenden Befehl:
systemctl stop udsagent
Deinstallieren Sie den Agenten mit dem folgenden Befehl:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-25 (UTC)."],[[["\u003cp\u003eThis guide covers installing the Backup and DR agent on a Linux host, which runs as a daemon process under root and communicates via TCP port 5106.\u003c/p\u003e\n"],["\u003cp\u003eAfter installation, a secret key is generated for secure communication, which must be added to the management console within two hours or regenerated.\u003c/p\u003e\n"],["\u003cp\u003eThe status of the Backup and DR agent can be checked using either \u003ccode\u003eservice udsagent status\u003c/code\u003e for non-systemd systems or \u003ccode\u003esystemctl status udsagent\u003c/code\u003e for systemd systems.\u003c/p\u003e\n"],["\u003cp\u003eYou can restart the agent using \u003ccode\u003e/etc/init.d/udsagent restart\u003c/code\u003e for non-systemd hosts or \u003ccode\u003esystemctl restart udsagent\u003c/code\u003e for systemd hosts.\u003c/p\u003e\n"],["\u003cp\u003eThe agent can also be uninstalled, either using \u003ccode\u003eyum remove\u003c/code\u003e or \u003ccode\u003erpm -e\u003c/code\u003e for CentOS/RHEL/SLES, or \u003ccode\u003edpkg --remove\u003c/code\u003e for Ubuntu, after stopping the agent service.\u003c/p\u003e\n"]]],[],null,["# Install the Backup and DR agent on a Linux host\n\nThis page describes how to install Backup and DR agent on a Linux host and\nperform other operations such as how to regenerate a secret key, check the\nBackup and DR agent status, and restart the Backup and DR agent.\n\nHow it works\n------------\n\nThe Backup and DR agent for Linux runs as a daemon process under username root.\nIt listens on TCP port 5106 for communication from the backup/recovery appliance.\nThe agent writes to a log file in the installation directory\n`/var/act/log/UDSAgent.log` and posts significant events to the\n`/var/log/messages` repository.\n\nAfter installing the agent, you need to initialize trusted communications\nbetween the backup/recovery appliance and the Backup and DR agent.\nThis only needs to be done once.\nThe secret key needs to be added within two hours of being generated.\nIf the secret key expires, you need to [generate a new key](#regenerate).\n\nSometimes you may need to regenerate a secret key. For example, if a host\nremains offline for an extended period, its certificate status may change to\n\"Uninitialized\". If this occurs, you must [generate a new key](#regenerate) to\nre-establish a valid certificate and resume normal operation.\n\nInstall the agent on a Linux host\n---------------------------------\n\n| **Note:** You must have at least 1 GB of free space in the /opt directory for UDSAgent to install or upgrade on Linux hosts.\n\nUse the following instructions to install the agent on a Linux host:\n\n1. Download the agent installer file, see\n [Obtain the right Backup and DR agent for your host](/backup-disaster-recovery/docs/concepts/about-connector#right-connector).\n\n2. Upload the installer file to your Linux server.\n\n3. To install the agent, choose one of the following:\n\n - For Linux 32-bit installation, run the following command.\n\n rpm -ivh connector-Linux_x86-\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e.rpm\n\n - For Linux 64-bit installation, run the following command.\n\n rpm -ivh connector-Linux-\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e.rpm\n\n - For Linux Ubuntu installation, run the following command.\n\n dpkg -i connector-linux_ubuntu_amd64-\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e.deb\n\n The agent always installs at `/opt/act`. When the installation is\n complete, a secret key displays.\n4. Save the secret key in a notepad or in a text editor, you need to add this\n in Backup and DR agent section, see\n [Add Linux host](/backup-disaster-recovery/docs/configuration/add-linux-hosts).\n\n### Regenerate the secret key\n\nThe secret key that is generated in the\n[Install the agent on a Linux host](#agent-linux) section is\nvalid only for two hours. You need to add it to the management console within\nthis timeframe or generate a new one.\n\nUse the following instructions to generate a new key and add it to the management\nconsole.\n\n1. On the Linux host, sign in as a root user and run either of the commands in\n the directory:\n\n - To reset the secret key after confirmation the action, run the following\n command:\n\n /opt/act/bin/udsagent secret --reset\n\n - To reset the secret immediately without confirmation, run the following\n command:\n\n /opt/act/bin/udsagent secret --reset --restart\n\n2. Save the secret key in a notepad or in editor. This secret key is valid for\n two hours.\n\n### Add a secret key\n\nIf you want to update the secret key or didn't add the secret key\nthe first time, you can add in the [Linux host](/backup-disaster-recovery/docs/configuration/add-linux-hosts)\nusing the following instructions.\n\n1. In the management console, select **Manage** and then select **Hosts**.\n\n2. Right-click the Linux host and choose **Edit**.\n\n3. Go to **Backup and DR agent Settings** section and find the\n **Secret** field.\n\n4. Paste the secret key that you saved earlier in the **Secret** field\n and click **Save** . Ensure the **Certificate** status changes to **Valid** .\n If you get a partial success message, use the instructions to\n [Validate backup/recovery appliance to Backup and DR agent connectivity](/backup-disaster-recovery/docs/concepts/appliance-network-settings#validate).\n\n### Check Backup and DR agent status\n\nAfter the agent is installed, you can verify its status on the Linux hosts using\nthe following commands.\n\n- On non-system targets (RHEL before 7.0 and SUSE Linux before 12.0),\n run the following command.\n\n service udsagent status\n\n The output looks similar to the following for the line `udsagent daemon is running`: \n\n service udsagent status\n udsagent daemon is running\n\n- On `systemd` targets (RHEL 7.0+, SUSE Linux 12.0+, and Ubuntu 16.0+), run the following\n command:\n\n systemctl status udsagent\n\n The output looks similar to the following: \n\n ```postgres\n [root@postgres ~]# systemctl status udsagent\n ● udsagent.service - Google Cloud Backup and DR service\n Loaded: loaded (/usr/lib/systemd/system/udsagent.service; enabled; vendor preset: disabled)\n Active: active (running) since Wed 2022-11-09 22:13:45 UTC; 17min age\n Process: 1056 ExecStart=/act/initscripts/udsagent.init start (code=exited, status=0/SUCCESS)\n Main PID: 1128 (udsagent)\n CGroup: /system.slice/udsagent.service\n ├─1128 /opt/act/bin/udsagent start\n └─1132 /opt/act/bin/udsagent start\n\n Nov 09 22:13:44 postgres systemd[1]: Starting Google Cloud Backup and DR Service...\n Nov 09 22:13:45 postgres udsagent.init[1056]: Starting /opt/act/bin/udsagent as a daemon. It may take a few minutes for the service to start completely.\n Nov 09 22:13:45 postgres udsagent.init[1056]: Starting /opt/act/bin/udsagent as a daemon. It may take a few minutes for the service to start completely.\n\n### Restart the Backup and DR agent on a Linux host\n\nTo restart the Backup and DR agent on a Linux host, execute the following\ncommand on the host.\n\n- For **Non-systemd (RHEL before 7.0 and SUSE Linux before 12.0)** hosts,\n run the following command:\n\n /etc/init.d/udsagent restart\n\n- For **Systemd (RHEL 7.0+, SUSE Linux 12.0+, and Ubuntu 16.0+)** hosts,\n run the following command:\n\n systemctl restart udsagent\n\n### Uninstall the Backup and DR agent from a Linux host using the command line\n\nUse the following instructions to uninstall the Backup and DR agent from a\nLinux host: \n\n### CentOS/RHEL/SLES\n\n1. Sign in as a root user and stop the Backup and DR agent by running the\n following command:\n\n systemctl stop udsagent\n\n For older Linux versions you may need to use the following command: \n\n /etc/init.d/udsagent stop\n\n2. Check the installed Linux Backup and DR agent\n RPM name with the following command:\n\n yum list installed | grep udsagent\n\n You can also use the following command to check the RPM name: \n\n rpm -qa udsagent\n\n The output looks similar to the following: \n\n udsagent-11.0.1-8756.x86_64\n\n3. Uninstall the package using the name you obtained from the query.\n For example:\n\n yum remove udsagent-11.0.1-8756.x86_64\n\n You can also use the following command to uninstall the package: \n\n rpm -e udsagent-11.0.1-8756.x86_64\n\n### Ubuntu\n\n1. Sign in as a root user and stop the Backup and DR agent by running the\n following command:\n\n systemctl stop udsagent\n\n2. Uninstall the agent using the following command:\n\n dpkg --remove udsagent\n\nWhat's next\n-----------\n\n- To install Backup and DR agent on a Linux host, see [Install the Backup and DR agent on a Linux host](/backup-disaster-recovery/docs/configuration/linux-agent)\n\n- To install Backup and DR agent on a Windows host, see [Backup and DR agent on Windows hosts](/backup-disaster-recovery/docs/configuration/windows-agent)\n\n- To configure iSCSI connectivity on a Linux host, see [iSCSI connectivity on a Linux host](/backup-disaster-recovery/docs/configuration/add-linux-hosts#iSCSI)\n\n- To configure NFS connectivity on a Linux host, see [NFS connectivity on a Linux host](/backup-disaster-recovery/docs/configuration/add-linux-hosts#NFS)\n\n- To upgrade Backup and DR agent, see [Maintain Backup and DR agents on hosts](/backup-disaster-recovery/docs/configuration/manage-agent)"]]
