Install Backup Agent

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, we check the installation space, download the Backup Agent file, verify Backup Master/Agent information, and perform other preparatory tasks.

Check Backup Agent installation space

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

Download Backup Agent installation file

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

1. Click the All Services > Storage > Backup menu. 1. Go to the Service Home page of Backup.
2. On the Service Home page, click the Backup Agent menu. 2. Go to the Backup Agent List page.
3. On the Backup Agent List page, click the resource to view detailed information. 3. Backup Agent Details page.
4. After checking the installation file URL, go to that URL. 4. 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. After navigating to the download screen, the download will start.

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 referring to the following example.

# wget "다운로드 URL" -OutFile "저장할 파일명"

Check Backup Master and Agent Information

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

Configure Security Group (Linux/Window)

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

• IP: Backup Master IP
• Inbound / Outboud / (TCP) 1556, 13724 port
• Action: allow the connection

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.242.8.4 takre1p1bkm1
   10.252.25.4 agent_tgdrhw.scpbackup
   

Adding a port for Backup Agent (when using Windows Firewall)

If you are using the Windows firewall, you must add the Backup Agent port used 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 all (domain, private, public)

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 set up routing on CentOS/RHEL, follow the steps below.

1. Use the following command to check the backup network Interface information.
   • ip a
   • bash /usr/local/bin/ip.sh

2. Set up routing using the nmcli command.

   # nmcli connection
   NAME                    UUID                 TYPE         DEVICE
   System eth0             abcdefghijklmnop     ethernet     eth0
   Wired connection 1      cdefghijklmnopqr     ethernet     eth1
   
   # nmcli con mod "Wired connection 1" +ipv4.routes "10.242.8.0/24 10.252.25.1"
   # nmcli device reapply eth1
   Connection successfully reapplied to device 'eth1'.
   

3. 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 these steps.

1. Use the following command to check the backup network Interface information.
   • ip a
   • bash /usr/local/bin/ip.sh

2. 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.242.8.0/24
     via:10.252.25.1
     # netplan apply
   

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

1. Right-click the Windows Start icon and run Command Prompt (Admin).
2. Run Windows PowerShell in administrator mode.
3. Use ipconfig, Get-NetAdapter commands to check the backup network interface index (ifindex) settings.

   # ipconfig /all → Agent IP에 할당된 interface name을 확인하세요.
   # Get-NetAdapter → 위에서 확인한 interface name 참고해 interface index를 확인하세요.
   

4. Use the NetRoute command to configure routing.

   # Get-NetRoute -ifindex 100
   # New-NetRoute -ifIndex 100 -DestinationPrefix 10.242.8.0/24 -NextHop 10.252.25.1
   

5. Check that the routing configuration has been applied correctly.

   # telnet [Backup Master명] 1556
   

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.

• Verify that the libnsl package is installed using the following command.

  # rpm -qa | grep libnsl
  

• If the libnsl package is not installed, use the following command to install the package.

  # yum install libnsl
  

Install 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. After moving to the directory where the Backup Agent 10.1.1 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 progress 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 enter 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
   
   ...
   Primary server [s-krw1a-dp-bk-msa] reports the following CA Certificate fingerprints:
   SHA-256 Fingerprint: [A0:C2:70:CA:4A:DA:DA:AF:6E:04:5D:87:38:B1:F0:89:A6:9A:7A:7B:F3:49:D8:5D:A9:9F:DD:55:70:4C:62:DB],
   SHA-1 Fingerprint: [4B:05:C3:21:8B:95:27:A5:5E:B7:D3:72:85:36:5B:CA:6F:18:BA:76].
   
   Is this correct? [y,n] y
   
   ...
   Do you wish to proceed with installation even though NetBackup will not operate? [y,n] (n) y
   

8. When selecting the Java GUI and JRE option, enter 2. 8. Installation of Java GUI and JRE packages is excluded.

   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.

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.

2. In the client selection popup, select the client to install, then click the OK button.
3. Select Yes in the Vertias NetBackup popup window. 3. The installation popup opens, and the installation steps are shown on the left side of the popup.
4. Welcome When the step description is displayed, click the Next button.
5. License Agreement When the step description is displayed, select the Agree with the Veritas Software License Agreement item, then click the Next button.
6. When the Install Type step description is displayed, ensure that Install to the computer only is checked, then select Custom installation. 6. When the selection is finished, click the Next button.

7. When the Option step description is displayed, verify the installation path and click the Next button. 7. Client option information is displayed.
   • You can click the Change… button to change the installation path.
8. After checking the Client Options information, click the Next button. 8. Log on information is displayed.
9. After checking the Log on information, click the Next button.
   • Safe Abort Option: This is an option to abort the installation if a system restart is required (optional).
10. When the System Name step description is displayed, enter the server environment information and click the Next button. 10. Master Server information is displayed.
    • Client Name: Enter Agent information. * Backup Agent name.scpbackup (e.g., agent_tgdrhw.scpbackup)
    • Master Server Name: Enter the Backup Master name.
11. After checking the Master Server information, I recognize the fingerprint for this host. 11. Proceed with the certificate deployment. Please select an item. 11. When the selection is finished, click the Next button.
12. Security When the step description appears, verify that the certificate deployment succeeded, then click the Next button.
13. When the Install step description is displayed, review the Installation Summary and then click the Install button.
14. When the installation is complete, click the Finish button.

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

To conduct a communication test with the Backup Master on Linux OS, follow these steps.

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
     10.252.25.4 agent_tgdrhw.scpbackup 10.252.25.4 45789
     

2. In the Samsung Cloud Platform Console, click the All Services > Storage > Backup menu. 2. Go to the Service Home page of Backup.
3. On the Service Home page, click the Backup Agent menu. 3. Go to the Backup Agent List page.
4. On the Backup Agent List page, click the resource to verify the communication test. 4. Navigate to the Backup Agent Details page.
5. In the Connection Status item, click the Check Connection Status button. 5. When communicating normally with Backup Master, Success is displayed.
   • If an error such as certificate issuance failure occurs, execute the following command.
     • Obtain Backup Master CA public certificate from the Agent: /usr/openv/netbackup/bin/nbcertcmd -getcacertificate -server s-krw1a-dp-bk-msa
     • Authenticate the Agent (HostID) from the Backup Master: /usr/openv/netbackup/bin/nbcertcmd -getcertificate -server s-krw1a-dp-bk-msa
6. Verify that the result values of the Backup Master communication test performed on the OS and the Samsung Cloud Platform Console are the same.

Windows OS

To conduct a communication test with Backup Master on Windows OS, follow these steps.

1. After entering the following command, perform a communication test with the Backup Master and check the results.
   • Command: # [Installation Path]\Veritas\NetBackup\bin\bpclntcmd.exe -pn
   • An example of the communication test inspection results is as follows.

     # C:\Veritas\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. 2. Go to the Service Home page of Backup.
3. On the Service Home page, click the Backup Agent menu. 3. Go to the Backup Agent List page.
4. On the Backup Agent List page, click the resource to verify the communication test. 4. Backup Agent Details Navigate to the page.
5. Click the Check Connection Status button in the Connection Status item. 5. If communication with Backup Master is successful, Success is displayed.
6. Verify that the result values of the Backup Master communication test performed on the OS and the Samsung Cloud Platform Console are identical.

Delete Backup Agent

If you do not use the Backup Agent, you must delete the Backup Agent installed on each operating system.

Linux OS

Follow these steps to uninstall the Backup Agent on Linux OS.

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.

   # [설치경로]\Veritas\NetBackup\bin\bpdown.exe -f -v
   # [설치경로]\Veritas\NetBackup\bin\bpps.exe → 남은 Process 확인 후 kill 수행
   

2. In Control Panel > Programs and Features, remove the Backup Agent program.
3. Delete the Backup Agent installation folder.