Instalar el agente de Backup and DR en un host Linux
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
En esta página se describe cómo instalar el agente de Backup y DR en un host Linux y cómo realizar otras operaciones, como regenerar una clave secreta, comprobar el estado del agente de Backup y DR y reiniciar el agente de Backup y DR.
Cómo funciona
El agente de copia de seguridad y recuperación tras desastres para Linux se ejecuta como un proceso de daemon con el nombre de usuario raíz.
Escucha en el puerto TCP 5106 para recibir comunicaciones del dispositivo de copia de seguridad o recuperación.
El agente escribe en un archivo de registro en el directorio de instalación
/var/act/log/UDSAgent.log y publica eventos significativos en el repositorio
/var/log/messages.
Después de instalar el agente, debe inicializar las comunicaciones de confianza entre el dispositivo de copia de seguridad o recuperación y el agente de Backup and DR.
Solo tienes que hacerlo una vez.
La clave secreta debe añadirse en un plazo de dos horas desde que se genera.
Si la clave secreta caduca, debes generar una nueva.
En ocasiones, es posible que tengas que volver a generar una clave secreta. Por ejemplo, si un host permanece sin conexión durante un periodo prolongado, el estado de su certificado puede cambiar a "Sin inicializar". Si esto ocurre, debes generar una nueva clave para volver a establecer un certificado válido y reanudar el funcionamiento normal.
Instalar el agente en un host Linux
Sigue estas instrucciones para instalar el agente en un host Linux:
Sube el archivo del instalador a tu servidor Linux.
Para instalar el agente, elige una de las siguientes opciones:
Para instalar Linux de 32 bits, ejecuta el siguiente comando.
rpm -ivh connector-Linux_x86-version.rpm
Para instalar la versión de Linux de 64 bits, ejecuta el siguiente comando.
rpm -ivh connector-Linux-version.rpm
Para instalar Linux Ubuntu, ejecuta el siguiente comando.
dpkg -i connector-linux_ubuntu_amd64-version.deb
El agente siempre se instala en /opt/act. Cuando se haya completado la instalación, se mostrará una clave secreta.
Guarda la clave secreta en un archivo del Bloc de notas o en un editor de texto. Tendrás que añadirla en la sección del agente de Backup and DR. Consulta el artículo Añadir un host Linux.
Volver a generar la clave secreta
La clave secreta que se genera en la sección Instalar el agente en un host Linux solo es válida durante dos horas. Debes añadirlo a la consola de gestión en ese plazo o generar uno nuevo.
Sigue estas instrucciones para generar una clave y añadirla a la consola de gestión.
En el host Linux, inicia sesión como usuario raíz y ejecuta uno de los comandos del directorio:
Para restablecer la clave secreta después de confirmar la acción, ejecuta el siguiente comando:
/opt/act/bin/udsagent secret --reset
Para restablecer el secreto inmediatamente sin confirmación, ejecuta el siguiente comando:
/opt/act/bin/udsagent secret --reset --restart
Guarda la clave secreta en un bloc de notas o en un editor. Esta clave secreta es válida durante dos horas.
Añadir una clave secreta
Si quieres actualizar la clave secreta o no la añadiste la primera vez, puedes hacerlo en el host de Linux siguiendo estas instrucciones.
En la consola de administración, selecciona Gestionar y, a continuación, Hosts.
Haz clic con el botón derecho en el host Linux y elige Editar.
Ve a la sección Ajustes del agente de copia de seguridad y recuperación ante desastres y busca el campo Secreto.
Comprobar el estado del agente de Backup y recuperación ante desastres
Una vez instalado el agente, puedes verificar su estado en los hosts Linux con los siguientes comandos.
En destinos que no sean del sistema (RHEL anterior a 7.0 y SUSE Linux anterior a 12.0),
ejecuta el siguiente comando.
service udsagent status
La salida de la línea udsagent daemon is running es similar a la siguiente:
service udsagent status
udsagent daemon is running
En los destinos systemd (RHEL 7.0, SUSE Linux 12.0 y Ubuntu 16.0 o versiones posteriores), ejecuta el siguiente comando:
systemctl status udsagent
El resultado es similar al siguiente:
```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.
Reiniciar el agente de copia de seguridad y recuperación ante desastres en un host Linux
Para reiniciar el agente de Backup and DR en un host Linux, ejecuta el siguiente comando en el host.
En los hosts que no usan systemd (RHEL anterior a 7.0 y SUSE Linux anterior a 12.0), ejecuta el siguiente comando:
/etc/init.d/udsagent restart
En los hosts Systemd (RHEL 7.0, SUSE Linux 12.0 y Ubuntu 16.0 o versiones posteriores),
ejecuta el siguiente comando:
systemctl restart udsagent
Desinstalar el agente de Backup and DR de un host Linux mediante la línea de comandos
Sigue estas instrucciones para desinstalar el agente de Backup and DR de un host Linux:
CentOS/RHEL/SLES
Inicia sesión como usuario raíz y detén el agente de Backup and DR ejecutando el siguiente comando:
systemctl stop udsagent
En versiones anteriores de Linux, puede que tengas que usar el siguiente comando:
/etc/init.d/udsagent stop
Comprueba el nombre del RPM del agente de Backup y DR de Linux instalado con el siguiente comando:
yum list installed | grep udsagent
También puedes usar el siguiente comando para comprobar el nombre del RPM:
rpm -qa udsagent
El resultado es similar al siguiente:
udsagent-11.0.1-8756.x86_64
Desinstala el paquete con el nombre que has obtenido de la consulta.
Por ejemplo:
yum remove udsagent-11.0.1-8756.x86_64
También puedes usar el siguiente comando para desinstalar el paquete:
rpm -e udsagent-11.0.1-8756.x86_64
Ubuntu
Inicia sesión como usuario raíz y detén el agente de Backup and DR ejecutando el siguiente comando:
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (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)"]]
