Backup Agent Install
To install the Backup Agent, you must first apply for the Backup Agent service. Please refer to Backup Agent Apply.
To use Agent-based Backup, you need to connect to the target server and install the Backup Agent. After installing the Backup Agent, register the backup through the Backup service.
Pre-preparation 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.
Backup Agent Check Installation Space
The required capacity for installing the Backup Agent is as follows.
| OS type | Path | Required capacity | Remarks |
|---|---|---|---|
| Linux | /tmp (temporarily used during installation) | 3 GB | /usr space shortage, possible through linking a separate space #ln -s separate space /usr/openv |
| Linux | /opt | 3 GB | When /usr space is insufficient, it is possible to link a separate space #ln -s separate space /usr/openv |
| Linux | openv installation path (usually /usr) | 3~5 GB | If /usr space is insufficient, possible via linking separate space #ln -s separate space /usr/openv |
| Windows | Veritas installation path (usually C:) | 3~5 GB | If space on C:\ is insufficient, can be installed on another drive |
| - | installation file | 10 GB |
Backup Agent installation file download
To download the Backup Agent installation file, follow these steps.
- All Services > Storage > Backup Click the menu. Go to the Service Home page of Backup.
- Click the Backup Agent menu on the Service Home page. You will be taken to the Backup Agent List page.
- Click the resource to view detailed information on the Backup Agent list page. It navigates to the Backup Agent details page.
- Installation file URL After confirming, go to the 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 [download location]
# curl -O installation file → Please insert the copied installation file download URL into the installation file.
Windows OS
If you use Windows OS, you can download using a web browser or Windows PowerShell.
When using an internet browser
After launching the internet browser, enter the copied installation file download URL into the address bar. After moving to the download screen, the download will start.
- It may take some time until it moves to the download screen.
- If you do not go to the download screen, download using Windows PowerShell.
When using Windows PowerShell
- Right-click the Windows Start icon, then run Command Prompt (Admin).
- Windows PowerShell in administrator mode.
- Please enter the command referring to the following example.
# wget "download URL" -OutFile "filename to save"
Check Backup Master and Agent information
To install the Backup Agent, routing settings and Backup Master and Agent information for host file registration are required. On the Backup Agent Details page, check the Backup Master IP, Backup IP, Gateway information. Backup Agent detailed information Please refer.
Setting up routing for communication with Backup Master
To communicate with Backup Master, you need to set up routing in the operating system.
Linux OS - CentOS/RHEL
Linux OS - To set up routing on CentOS/RHEL, follow the steps below.
- The IP, Gateway, and Vlan ID information of 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 set in the Config file of the Bare Metal Server. For more details, see Local Subnet Setup.
- Use the following command to check the backup network Interface information.
- ip a
- bash /usr/local/bin/ip.sh
- Set up 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 - Check that the routing settings have been applied correctly.
# telnet [Backup Master name] 1556
Linux OS - ubuntu
Linux OS - To set up routing on Ubuntu, follow the steps below.
- The IP, Gateway, and Vlan ID information of 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 set in the Config file of the Bare Metal Server. For more details, see Local Subnet Setup.
Use the following command to check the backup network Interface information.
- ip a
- bash /usr/local/bin/ip.sh
50-cloud-init.yaml Open the file and set up routing.
# vi /etc/netplan/50-cloud-init.yaml (Add routes to existing content) network: bonds: ...................... omitted ethernets: ...................... omitted vlans: bond.srv.100: addresses: ...................... omitted routes: - to:10.252.8.0/24 via:10.252.25.1 # netplan applyCheck that the routing settings have been applied correctly.
# telnet [Backup Master name] 1556
Windows OS
To set up routing in Windows OS, follow the steps below.
- The IP, Gateway, and Vlan ID information of 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, see Setting Local Subnet.
Right-click the Windows Start icon, then run Command Prompt (Admin).
Run Windows PowerShell in administrator mode.
Using the ipconfig, Get-NetAdapter commands, check the backup network interface index (ifindex) setting.
# ipconfig /all → Check the interface name assigned to the Agent IP. # Get-NetAdapter → Refer to the interface name checked above to find the interface index.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.1Check that the routing settings have been applied correctly.
# telnet [Backup Master name] 1556
Register Backup Master information in the hosts file
To register Backup Master information in the hosts file, follow these steps.
- Open the host file using a file editing tool.
- Linux operating system: /etc/hosts
- Windows operating system: C:\Windows\System32\drivers\etc\hosts
- Open the hosts file and register the Backup Master and Backup Agent information (IP, name).
- After the Backup Agent name, you must add .scpbackup as shown in the following example.
10.252.8.4 takre1p1bkm1 10.252.25.4 agent_tgdrhw.scpbackup
Add port for Backup Agent (when using Windows firewall)
If you are using the Windows firewall, you need to add the port for the Backup Agent, which communicates with the Backup Master, to the Windows firewall.
The ports and settings to add to the Windows firewall are as follows.
- Inbound Rule: (TCP) 443, 1556, 13720, 13724, 13782 port
- Action: allow the connection
- Profile: domain, private, public select all
Check whether 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.
- Check if the libnsl package is installed using the following command.
# rpm -qa | grep libnsl - If the libnsl package is not installed, install the package using the following command.
# yum install libnsl
Backup Agent Install
Install the Backup Agent suitable for the operating system.
Linux OS
To install the Backup Agent on Linux OS, follow the steps below.
- Backup Agent 10.1.1 Move to the path where the installation file was extracted and change the permissions of the installation-related files.
# chmod 755 installs # chmod –R 755 NBClients - ./install을 실행하세요.
- [root@bkclientlin ~]# ./install
- 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 - 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 - When checking the Backup master server name, enter Backup Master name and press the Enter key.
Enter the name of the ~~~~~~ master server : bkmaster - When checking the client server configuration name, enter n and then enter the Agent information.
- Agent information input 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 - 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 - When selecting the Java GUI and JRE option, enter 2. Java GUI and JRE package installation will be 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 - Verify that the installation was completed correctly.
Windows OS
To install the Backup Agent on Windows OS, follow these steps.
- 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.
- If the installation zip file contains an EEB directory in the format
NB_10.4.0.1_ETXXXXXX_1, after installing the Backup Agent, you must proceed with the patch work according to the following procedure.- When the Backup Agent installation is finished, go to the
NB_10.4.0.1_ETXXXXXX_1folder. eebinstaller_XXXXXXX_1_AMD64.exeRun the file with administrator privileges.- If there are multiple files, install all of them.
- When the Backup Agent installation is finished, go to the
- After selecting the client to install in the client selection popup, click the OK button.
- Select Yes in the Vertias NetBackup popup window. The installation popup window opens, and the installation steps are displayed on the left side of the popup.
- Welcome When the step description is displayed, click the Next button.
- License Agreement When the step description is displayed, select the Agree with the veritas Software License Agreement item, then click the Next button.
- Install Type when the step description is displayed, confirm that Install to the computer only is checked, then select Custom installation. When selection is finished, click the Next button.
- Option When the step description is displayed, verify the installation path and click the Next button. Client option information is displayed.
- Change… You can click the button to change the installation path.
- After checking the Client Options information, click the Next button. Log on information will be displayed.
- After checking the Log on information, click the Next button.
- Safe Abort Option: If a system restart is required, this is an option to halt the installation (optional).
- System Name If the step description is displayed, enter the server environment information and click the Next button. 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.
- After checking the Master Server information, I recognize the fingerprint for this host. Proceed with the certificate deployment. select the item. When selection is finished, click the Next button.
- Security When the step description is displayed, confirm that the certificate deployment succeeded, then click the Next button.
- Install When the step description is displayed, after checking the Installation Summary content, click the Install button.
- When installation is complete, click the Finish button.
Backup Agent Check Status
When the installation of Backup Agent is finished, perform a communication test with Backup Master and check the status.
Linux OS
To conduct a communication test with the Backup Master on Linux OS, follow the steps below.
- After entering the following command, conduct a communication test with Backup Master and check the results.
- Command: # /usr/openv/netbackup/bin/bpclntcmd -pn
- The 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
- Samsung Cloud Platform Console에서 All Services > Storage > Backup 메뉴를 클릭하세요. Backup의 Service Home 페이지로 이동합니다.
- Click the Backup Agent menu on the Service Home page. You will be taken to the Backup Agent List page.
- Click the resource to check the communication test on the Backup Agent List page. You will be taken to the Backup Agent Details page.
- Click the Check Connection Status button in the Connection Status item. If it communicates normally with Backup Master, Success is displayed.
- Verify that the result values of the Backup Master communication test performed on the OS and Samsumg Cloud Platform Console are the same.
Windows OS
To conduct a communication test with Backup Master on Windows OS, follow the steps below.
- 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
- The 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
- Click the All Services > Storage > Backup menu in the Samsung Cloud Platform Console. Go to the Backup Service Home page.
- Click the Backup Agent menu on the Service Home page. Navigate to the Backup Agent List page.
- Click the resource to verify the communication test on the Backup Agent List page. It navigates to the Backup Agent Details page.
- Click the Check Connection Status button in the Connection Status item. If it communicates properly with Backup Master, Success is displayed.
- Verify that the result values of the Backup Master communication test performed on the OS and the Samsumg Cloud Platform Console are the same.
Backup Agent Delete
If you do not use the Backup Agent, you must delete the Backup Agent installed on each operating system.
Linux OS
To delete the Backup Agent on Linux OS, follow the steps below.
- 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 - Delete the Backup Agent installation file.
# rpm –qa | grep –i VRTS → Backup Agent package check # 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 after confirming, delete remaining package # rm -rf /usr/openv
Windows OS
To delete the Backup Agent on Windows OS, follow the steps below.
- Stop the Backup Agent service.
# [Installation Path]\Vertitas\NetBackup\bin\bpdown.exe -f -v # [Installation Path]\Vertitas\NetBackup\bin\bpps.exe → Check remaining Process and then perform kill - Control Panel > Programs and Features: remove the Backup Agent program.
- Delete the Backup Agent installation folder.