이 페이지에서는 Linux 호스트에 Backup and DR 에이전트를 설치하고, 비밀 키를 재생성하고, Backup and DR 에이전트 상태를 확인하고, Backup and DR 에이전트를 다시 시작하는 등 다른 작업을 실행하는 방법을 설명합니다.
작동 방식
Linux용 Backup and DR 에이전트는 사용자 이름 root 아래에서 데몬 프로세스로 실행됩니다.
백업/복구 어플라이언스와의 통신을 위해 TCP 포트 5106에서 수신 대기합니다.
에이전트는 설치 디렉터리 /var/act/log/UDSAgent.log의 로그 파일에 쓰고 /var/log/messages 저장소에 중요한 이벤트를 게시합니다.
에이전트를 설치한 후 백업/복구 어플라이언스와 Backup and DR 에이전트 간의 신뢰할 수 있는 통신을 초기화해야 합니다.
이 작업은 한 번만 수행하면 됩니다.
보안 비밀 키는 생성 후 2시간 이내에 추가해야 합니다.
비밀번호 키가 만료되면 새 키를 생성해야 합니다.
보안 비밀 키를 다시 생성해야 하는 경우도 있습니다. 예를 들어 호스트가 장기간 오프라인 상태로 유지되면 인증서 상태가 '초기화되지 않음'으로 변경될 수 있습니다. 이 경우 유효한 인증서를 다시 설정하고 정상 작동을 재개하려면 새 키를 생성해야 합니다.
메모장이나 텍스트 편집기에 보안 키를 저장합니다. 백업 및 DR 에이전트 섹션에 이를 추가해야 합니다. Linux 호스트 추가를 참고하세요.
보안 비밀 키 재생성
Linux 호스트에 에이전트 설치 섹션에서 생성된 보안 비밀 키는 2시간 동안만 유효합니다. 이 기간 내에 관리 콘솔에 추가하거나 새 토큰을 생성해야 합니다.
다음 안내에 따라 새 키를 생성하고 관리 콘솔에 추가합니다.
Linux 호스트에서 루트 사용자로 로그인하고 디렉터리에서 다음 명령어 중 하나를 실행합니다.
작업을 확인한 후 보안 비밀 키를 재설정하려면 다음 명령어를 실행합니다.
/opt/act/bin/udsagent secret --reset
확인 없이 보안 비밀을 즉시 재설정하려면 다음 명령어를 실행합니다.
/opt/act/bin/udsagent secret --reset --restart
메모장이나 편집기에 보안 비밀 키를 저장합니다. 이 보안 비밀 키는 2시간 동안 유효합니다.
보안 키 추가
보안 비밀 키를 업데이트하거나 처음에 보안 비밀 키를 추가하지 않은 경우 다음 안내에 따라 Linux 호스트에 추가할 수 있습니다.
관리 콘솔에서 관리를 선택한 다음 호스트를 선택합니다.
Linux 호스트를 마우스 오른쪽 버튼으로 클릭하고 수정을 선택합니다.
백업 및 DR 에이전트 설정 섹션으로 이동하여 Secret 필드를 찾습니다.
이전에 저장한 보안 비밀 키를 Secret 필드에 붙여넣고 Save를 클릭합니다. 인증서 상태가 유효함으로 변경되었는지 확인합니다.
부분 성공 메시지가 표시되면 안내에 따라 백업/복구 어플라이언스와 백업 및 DR 에이전트 연결을 검증하세요.
백업 및 DR 에이전트 상태 확인
에이전트가 설치되면 다음 명령어를 사용하여 Linux 호스트에서 상태를 확인할 수 있습니다.
시스템이 아닌 타겟 (7.0 이전 RHEL 및 12.0 이전 SUSE Linux)에서는 다음 명령어를 실행합니다.
service udsagent status
udsagent daemon is running 행의 출력은 다음과 유사합니다.
service udsagent status
udsagent daemon is running
systemd 타겟 (RHEL 7.0 이상, SUSE Linux 12.0 이상, Ubuntu 16.0 이상)에서 다음 명령어를 실행합니다.
systemctl status udsagent
결과는 다음과 유사합니다.
```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.
Linux 호스트에서 Backup and DR 에이전트 다시 시작
Linux 호스트에서 Backup and DR 에이전트를 다시 시작하려면 호스트에서 다음 명령어를 실행합니다.
systemd가 아닌 (7.0 이전 RHEL 및 12.0 이전 SUSE Linux) 호스트의 경우 다음 명령어를 실행합니다.
/etc/init.d/udsagent restart
Systemd (RHEL 7.0 이상, SUSE Linux 12.0 이상, Ubuntu 16.0 이상) 호스트의 경우 다음 명령어를 실행합니다.
systemctl restart udsagent
명령줄을 사용하여 Linux 호스트에서 Backup and DR 에이전트 제거
다음 안내에 따라 Linux 호스트에서 Backup and DR 에이전트를 제거합니다.
CentOS/RHEL/SLES
루트 사용자로 로그인하고 다음 명령어를 실행하여 Backup and DR 에이전트를 중지합니다.
systemctl stop udsagent
이전 Linux 버전의 경우 다음 명령어를 사용해야 할 수 있습니다.
/etc/init.d/udsagent stop
다음 명령어를 사용하여 설치된 Linux 백업 및 DR 에이전트 RPM 이름을 확인합니다.
yum list installed | grep udsagent
다음 명령어를 사용하여 RPM 이름을 확인할 수도 있습니다.
rpm -qa udsagent
결과는 다음과 유사합니다.
udsagent-11.0.1-8756.x86_64
쿼리에서 가져온 이름을 사용하여 패키지를 제거합니다.
예를 들면 다음과 같습니다.
yum remove udsagent-11.0.1-8756.x86_64
다음 명령어를 사용하여 패키지를 제거할 수도 있습니다.
rpm -e udsagent-11.0.1-8756.x86_64
Ubuntu
루트 사용자로 로그인하고 다음 명령어를 실행하여 Backup and DR 에이전트를 중지합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(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)"]]
