The page has been translated by Gen AI.

Install Backup Agent

Caution

To install the Backup Agent, you must first request the Backup Agent service. Refer to Create Backup Agent.

  1. Backup Agent Apply
  2. Install Backup Agent
  3. Register backup in the Backup service

To use an Agent-based backup, you must connect to the target server and install the Backup Agent. After installing the Backup Agent, register the backup through the Backup service.

Pre‑setup work

To install the Backup Agent, verify the installation space, download the Backup Agent files, check the Backup Master/Agent information, and perform other preparatory tasks.

Check backup agent installation space

The required storage for installing the Backup Agent is as follows.

OS typePathRequired capacityRemarks
Linux/tmp (temporarily used during installation)3 GBWhen /usr space is insufficient, a separate space can be linked #ln -s separate space /usr/openv
Linux/opt3 GB/usr space is insufficient, a separate space can be linked #ln -s separate space /usr/openv
Linuxopenv installation path (usually /usr)3~5 GB/usr When /usr space is insufficient, you can link a separate space #ln -s separate space /usr/openv
WindowsVeritas installation path (usually C:\)3~5 GBIf space on C:\ is insufficient, you can install on another drive.
-installation file10 GB
Table. Required storage when installing Backup Agent

Download Backup Agent installation file

To download the Backup Agent installation file, follow these steps.

  1. Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
  2. From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
  3. On the Backup Agent List page, click the resource for which you want to view detailed information. You will be taken to the Backup Agent Details page.
  4. After checking the installation file URL, navigate to that URL. You can download the Backup Agent installation file.

Linux OS

If you are using Linux OS, refer to the following example and enter the command.

# cd [다운로드할 위치]
# curl -O 설치파일 → 설치 파일에 복사한 설치 파일 다운로드 URL을 넣어주세요.

Windows OS

If you are using Windows OS, you can download using a web browser or Windows PowerShell.

When using an internet browser

After launching an internet browser, enter the copied installation file download URL into the address bar. Once you navigate to the download page, the download will begin.

Reference
  • It may take some time to navigate to the download screen.
  • If you do not navigate to the download page, use Windows PowerShell to download.

When using Windows PowerShell

  1. Right-click the Windows Start icon, then run Command Prompt (Admin).
  2. Run Windows PowerShell in administrator mode.
  3. Enter the command by referring to the following example.
# wget "다운로드 URL" -OutFile "저장할 파일명"

Check Backup Master and Agent Information

To install the Backup Agent, you need routing settings and Backup Master and Agent information for host file registration. On the Backup Agent Details page, check the Backup Master IP, Backup IP, and Gateway information. Please refer to Check detailed information of Backup Agent.

Configure routing for communication with Backup Master

To communicate with the Backup Master, you must configure routing in the operating system.

Linux OS - CentOS/RHEL

Linux OS - To configure routing on CentOS/RHEL, follow these steps.

Reference
  • The IP, Gateway, and Vlan ID information for the Backup Master and Agent used in the routing configuration example are as follows.
    • Backup Master IP: 10.242.8.4
    • Backup IP (Agent IP): 10.252.25.4
    • Gateway (Agent Gateway): 10.252.25.1
    • vlan: 100
  • vlan can be configured in the Config file of a Bare Metal Server. For more details, refer to Configure Local Subnet.
  1. Use the following command to check the backup network Interface information.
    • ip a
    • bash /usr/local/bin/ip.sh
Reference
If it is a backup of a Virtual Server or GPU Server, check the Interface information of the Subnet selected when creating the Backup Agent Service in the Console.
  1. Configure routing using the nmcli command.
    # nmcli con mod "Vlan bond-srv.100" +ipv4.routes "10.252.8.0/24 10.252.25.1"
    # nmcli device reapply bond-srv.100
    
  2. Check that the routing configuration has been applied correctly.
    # telnet [Backup Master명] 1556
    

Linux OS - ubuntu

Linux OS - To set up routing on Ubuntu, follow the steps below.

Reference
  • The IP, Gateway, and Vlan ID information for the Backup Master and Agent used in the routing configuration example are as follows.
    • Backup Master IP: 10.242.8.4
    • Backup IP (Agent IP): 10.252.25.4
    • Gateway (Agent Gateway): 10.252.25.1
    • vlan: 100
  • vlan can be configured in the Config file of a Bare Metal Server. For more details, see Local Subnet Configuration.
  1. Use the following command to check the backup network Interface information.
    • ip a
    • bash /usr/local/bin/ip.sh
Reference
If it is a backup of a Virtual Server or GPU Server, check the Interface information of the Subnet selected when creating the Backup Agent Service Creation in the Console.
  1. Open the 50-cloud-init.yaml file and configure routing.

    # vi /etc/netplan/50-cloud-init.yaml (기존 내용에 routes 내용 추가)
      network:
      bonds:
      ...................... 생략
      ethernets:
      ...................... 생략
      vlans:
      bond.srv.100:
      addresses:
      ...................... 생략
      routes:
      - to:10.252.8.0/24
      via:10.252.25.1
      # netplan apply
    
  2. Check that the routing configuration has been applied correctly.

    # telnet [Backup Master명] 1556
    

Windows OS

To set up routing on Windows OS, follow these steps.

Reference
  • The IP, Gateway, and Vlan ID information for the Backup Master and Agent used in the routing configuration example are as follows.
    • Backup Master IP: 10.242.8.4
    • Backup IP (Agent IP): 10.252.25.4
    • Gateway (Agent Gateway): 10.252.25.1
    • ifindex: 100
  • ifindex can be set in the Config file of a Bare Metal Server. For more details, refer to Setting Local Subnet.
  1. Right-click the Windows Start icon and then launch Command Prompt (Admin).
  2. Run Windows PowerShell in administrator mode.
  3. Use the ipconfig and Get‑NetAdapter commands to check the backup network interface index (ifindex) settings.
    # ipconfig /all → Agent IP에 할당된 interface name을 확인하세요.
    # Get-NetAdapter → 위에서 확인한 interface name 참고해 interface index를 확인하세요.
    
Reference
If it is a backup of a Virtual Server or GPU Server, check the interface index (ifindex) information of the selected Subnet in the Console when creating the Backup Agent service.
  1. Set up routing using the NetRoute command.

    # Get-NetRoute -ifindex 100
    # New-NetRoute -ifIndex 100 -DestinationPrefix 10.252.8.0/24 -NextHop 10.252.25.1
    
  2. Check that the routing configuration has been applied correctly.

    # telnet [Backup Master명] 1556
    

Register Backup Master information in the hosts file

To register Backup Master information in the hosts file, follow these steps.

  1. Open the host file using a file editing tool.
    • Linux operating system: /etc/hosts
    • Windows operating system: C:\Windows\System32\drivers\etc\hosts
  2. Open the hosts file and register the Backup Master and Backup Agent information (IP, name).
    • You must add .scpbackup after the Backup Agent name as shown in the following example.
    10.252.8.4 takre1p1bkm1
    10.252.25.4 agent_tgdrhw.scpbackup
    

Adding ports for Backup Agent (when using Windows Firewall)

If you are using the Windows firewall, you must add the Backup Agent port for communicating with the Backup Master to the Windows firewall.

The ports and settings to add to the Windows firewall are as follows.

  • Inbound Rule: (TCP) 1556, 13724 port
  • Action: allow the connection
  • Profile: select domain, private, and public

Check if the package is installed (when using RHEL 8)

If you are using RHEL 8, the libnsl package must be installed to install the Backup Agent.

  • Use the following command to verify that the libnsl package is installed.
    # rpm -qa | grep libnsl
    
  • If the libnsl package is not installed, use the following command to install the package.
    # yum install libnsl
    

Installing Backup Agent

Install the Backup Agent appropriate for the operating system.

Linux OS

To install the Backup Agent on Linux OS, follow these steps.

  1. Backup Agent 10.1.1 After moving to the path where the installation file was extracted, change the permissions of the installation-related files.
    # chmod 755 installs
    # chmod –R 755 NBClients
    
  2. Run ./install.
    • [root@bkclientlin ~]# ./install
  3. After the install description, when confirming whether to proceed with the installation, enter y and press the Enter key.
    Do you wish to continue? [y,n] (y) y
    
  4. When checking the installation status of Software on the client, enter y and press the Enter key.
    Do you want to install the ~~~~~~~~~~~~ software for this client? [y,n] (y) y
    
  5. When checking the Backup master server name, enter Backup Master name and press the Enter key.
    Enter the name of the ~~~~~~ master server : bkmaster 
    
  6. When checking the client server configuration name, enter n and then input the Agent information.
    • Agent information required: Backup Agent name.scpbackup (e.g., agent_tgdrhw.scpbackup)
    Would you like to use "bkclientlin" as the configured
    name of the ~~~~~~~ client? [y,n] (y) n
    agent_tgdrhw.scpbackup
    
  7. Check the Master Server information, and if there are no issues, enter y.
    Master server [bkmaster] reports the following CA Certificate fingerprints:
    SHA-256 Fingerprint: [BB:38:~~~~~~~~]
    SHA-1 Fingerpritn: [0D:E6:~~~~~~~]
    
    Is this correct [y,n] y
    
  8. When selecting the Java GUI and JRE option, enter 2. The installation of the Java GUI and JRE packages will be omitted.
    Choose an option from the list below.
      1) Include the Java GUI and JRE
      2) Exclude the Java GUI and JRE
    
    Java GUI and JRE option: [1,2] (2) :2
    Excluding the installation of Java GUI and JRE packages
    
  9. Check that the installation completed successfully.

Windows OS

To install the Backup Agent on Windows OS, follow these steps.

guide
The Backup Agent installation must be performed with the Default Administrator account. If you are not using the Default Administrator account, log in with the Default Administrator account before proceeding with the installation.
  1. After moving to the folder where the Backup Agent 10.1.1 installation file has been extracted, run the Setup.exe file with administrator privileges.
guide
  • If the installation archive contains an EEB directory in the format NB_10.4.0.1_ETXXXXXX_1, you must perform the patch procedure after installing the Backup Agent, following the steps below.
    1. When the Backup Agent installation is complete, go to the NB_10.4.0.1_ETXXXXXX_1 folder.
    2. eebinstaller_XXXXXXX_1_AMD64.exe Run the file with administrator privileges.
      • If there are multiple files, install all of them.
  1. In the popup window for selecting the Client to install, select the Client to install, then click the OK button.
  2. In the Vertias NetBackup popup, select Yes. The installation popup opens, and the installation steps are displayed on the left side of the popup.
  3. Welcome When the step description is displayed, click the Next button.
  4. License Agreement When the step description is displayed, select the Agree with the veritas Software License Agreement item, then click the Next button.
  5. When the Install Type step description is displayed, make sure the Install to the computer only option is checked, then select the Custom installation option. After completing the selection, click the Next button.
guide
If any option other than Install to the computer only is checked, verify whether the program is already installed.
  1. When the Option step description is displayed, verify the installation path and click the Next button. Client option information is displayed.
    • Click the Change… button to change the installation path.
  2. After checking the Client Options information, click the Next button. The Log on information will be displayed.
  3. After checking the Log on information, click the Next button.
    • Safe Abort Option: This option aborts the installation when a system restart is required (optional).
  4. When the System Name step description is displayed, enter the server environment information and click the Next button. The Master Server information will be displayed.
    • Client Name: Enter the Agent information. Backup Agent Name.scpbackup (e.g.: agent_tgdrhw.scpbackup)
    • Master Server Name: Enter the Backup Master name.
  5. After checking the Master Server information, select the I recognize the fingerprint for this host. Proceed with the certificate deployment. item. When you have finished selecting, click the Next button.
  6. When the Security step description is displayed, verify that the certificate deployment succeeded, then click the Next button.
  7. When the Install step description is displayed, review the Installation Summary and then click the Install button.
  8. When the installation is complete, click the Finish button.

Configure Security Group (Linux/Window)

If backing up a Virtual Server or GPU Server, you must configure a Security Group to communicate with the Backup Master. To configure the Security Group, check the backup information on the Backup Agent Details page and register it with the Security Group attached to the Server.

  • IP: Backup Master IP
  • Inbound / Outboud / (TCP) 1556, 13724 port
  • Action: allow the connection
Reference
For detailed information about Backup, see View detailed information of Backup Agent.

Check Backup Agent status

After the Backup Agent installation is complete, perform a communication test with the Backup Master and check the status.

Linux OS

Follow these steps to perform a communication test with the Backup Master on Linux OS.

  1. After entering the following command, perform a communication test with Backup Master and check the results.
    • Command: # /usr/openv/netbackup/bin/bpclntcmd -pn
    • An example of the communication test inspection results is as follows.
      # /usr/openv/netbackup/bin/bpclntcmd -pn
      expecting response from server takre1p1bkm1
      agent_tgdrhw.scpbackup agent_tgdrhw.scpbackup 10.252.25.4 52096
      
  2. Click the All Services > Storage > Backup menu in the Samsung Cloud Platform Console. Go to the Service Home page of Backup.
  3. On the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent List page.
  4. On the Backup Agent List page, click the resource to verify the communication test. You will be taken to the Backup Agent Details page.
  5. In the Connection Status item, click the Check Connection Status button. If communication with Backup Master is successful, Success will be displayed.
  6. Verify that the result values of the Backup Master communication test performed on the OS and the Samsumg Cloud Platform Console are identical.
Reference
If the result values of the Backup Master communication test performed on the OS and the Samsumg Cloud Platform Console differ, please contact the Support Center. Please refer to Contact Support.

Windows OS

Follow these steps to perform a communication test with Backup Master on Windows OS.

  1. After entering the following command, perform a communication test with Backup Master and check the results.
    • Command: # [installation path]\Vertitas\NetBackup\bin\bpclntcmd.exe -pn
    • An example of the communication test inspection results is as follows.
      # C:\Vertitas\NetBackup\bin\bpclntcmd.exe -pn
      expecting response from server takre1p1bkm1
      agent_tgdrhw.scpbackup agent_tgdrhw.scpbackup 10.252.25.4 52096
      
  2. In the Samsung Cloud Platform Console, click the All Services > Storage > Backup menu. Navigate to the Service Home page of Backup.
  3. From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
  4. On the Backup Agent List page, click the resource to verify the communication test. You will be taken to the Backup Agent Details page.
  5. In the Connection Status item, click the Check Connection Status button. If communication with Backup Master is successful, Success will be displayed.
  6. Verify that the result values of the Backup Master communication test performed on the OS and Samsumg Cloud Platform Console are identical.
Reference
If the result of the Backup Master communication test performed on the OS and the Samsung Cloud Platform Console differs, please contact the Support Center. Refer to Contact Support.

Delete Backup Agent

If you are not using the Backup Agent, you must remove the Backup Agent installed on each operating system.

Linux OS

To uninstall the Backup Agent on Linux OS, follow the steps below.

  1. Stop the Backup Agent service.
    # /usr/openv/netbackup/bp.kill_all
    # /opt/VRTSpbx/bin/vxpbx_exchanged stop
    # /usr/openv/netbackup/bin/vxlogcfg -r -p 51216
    
  2. Delete the Backup Agent installation file.
    # rpm –qa | grep –i VRTS → Backup Agent package 확인
    # rpm –e VRTSnbcfg
    # /opt/pdde/pddeuninstall.sh –forceclean
    # rpm -e VRTSnbjava
    # rpm -e VRTSnbjre
    # rpm -e VRTSnbclt
    # rpm -e VRTSpbx
    # rpm -e VRTSnbpck
    # rpm -qa | grep -i VRTS → Backup Agent package 확인 후 남은 package 삭제
    # rm -rf /usr/openv
    

Windows OS

To uninstall the Backup Agent on Windows OS, follow these steps.

  1. Stop the Backup Agent service.
    # [설치경로]\Vertitas\NetBackup\bin\bpdown.exe -f -v
    # [설치경로]\Vertitas\NetBackup\bin\bpps.exe → 남은 Process 확인 후 kill 수행
    
  2. From Control Panel > Programs and Features, uninstall the Backup Agent program.
  3. Delete the Backup Agent installation folder.
Use Backup Agent
Use Replication