KB ID : 115202
Published : June 22, 2022
Created : June 22, 2022
Last Modified : June 14, 2023

BDRSuite Backup Agent (BBA) runs with the service name - BDRSuite Delegation Service (BDS) is a mandatory component for backup operations and is installed on the backup host (Windows/Linux/Mac).

BDRSuite Backup Agent (BBA) Installation on Individual Backup Hosts:

Install BBA on Windows and Linux Hosts:

  • Download BDRSuite Backup Agent (BBA) based on the host OS (Windows, Linux) from backup server console.

  • Run BBA setup file on the backup host and follow the on-screen instructions to proceed with the installation.

  • During the installation, you will be prompted to enter the following information:

    Display Name: Enter a name to identify the host in the backup server.

    Backup Server DNS Name/IP Address: Enter the BDRSuite Backup Servers's DNS Name/IP Address to register this host with the backup server.

    Choose Backup Type and Reboot Option: Choose the appropriate backup type and reboot option from the following choices based on your preferences: (Applicable only for Windows Installer)

    🔘 No disk image backup required for this host. (Note: You can use this installation for Files/Folders Backup, Integration Service for Hyper-V Backup, and/or Backup Proxy for VMware)

    🔘 Disk image backup required for this host. Automatically reboot the host immediately. (Note: The changed block tracking (CBT) driver for disk image backup will be installed and the host will reboot immediately after installation)

    🔘 Disk image backup required for this host. I will manually reboot the host later. (Note: The changed block tracking (CBT) driver for disk image backup will be installed and disk image backups will only be successful after a manual reboot)

  • Complete the installation process by providing the necessary information.

  • Once the installation is successful, the agent will automatically establish connection and register the host with the backup server.

  • To verify the installation and connection, go to the Data Sources menu on the backup server. You will see the host details, including the display name, Hostname/IP address and connection status.

Install BBA on Mac:

  • Download BDRSuite Backup Agent (BBA) for Mac from backup server console.
  • Execute the command below on the backup host.

    sudo sh BDRSuite_Delegation_Service_5_6_0_2_U2_IMac_arm64.bin "Enter Backup Server IP Address/DNS Name"
    
  • The agent will automatically establish connection and register the host (Mac) with the backup server.

  • To verify the installation and connection, go to the Data Sources menu on the backup server. You will see the host details, including the display name, Hostname/IP address and connection status.

Bulk Installation of BDRSuite Backup Agent (BBA):

Download BBA and install it on multiple backup hosts simultaneously using the command below through any third party tool. You can use the command based on your desired backup type and reboot option.

Windows

To configure disk image backup and reboot the host immediately after BBA installation, use the command below:

msiexec /i BDRSuite_Delegation_Service_x_x_x_x_x.msi /qn BACKUPSERVERINFO="Enter Backup Server IP Address/DNS Name" REBOOT="Force" INSTALLDRIVER="Yes"

To configure disk image backup and to reboot the host later, use the command below:

msiexec /i BDRSuite_Delegation_Service_x_x_x_x_x.msi /qn BACKUPSERVERINFO="Enter Backup Server IP Address/DNS Name" INSTALLDRIVER="Yes"

To configure only files & folders backup, use the command below:

msiexec /i BDRSuite_Delegation_Service_x_x_x_x_x.msi /qn BACKUPSERVERINFO="Enter Backup Server IP Address/DNS Name"

Where x_ x_ x_ x_ x is the BBA installer version. The latest version is 5_ 6_ 0_ 2_ U2 (v5.6.0 Update 2)

Example:

 msiexec /i BDRSuite_Delegation_Service_5_6_0_2_U2.msi /qn BACKUPSERVERINFO=192.168.100.123

Linux:

 bash BDRSuite_Delegation_Service_5_6_0_2_U2_DBN.bin yes admin "/home/vembuintegrationservice" "{Enter Backup Server IP Address/DNS Name}"

Mac:

 sudo sh BDRSuite_Delegation_Service_5_6_0_2_U2_IMac_arm64.bin "{Enter Backup Server IP Address/DNS Name}"

For detailed instructions on Bulk Installation, refer to User Guide.

Establishing Connection between the backup host and backup server:

BBA installed on each backup host will automatically connect to the backup server.

1.If the BBA on the backup host is successfully connected to the BDRSuite Server, then the status will be shown as 'Idle’.

2.If the backup host is not connected, then the status will be shown as 'BBA Not Connected'. In this case, ensure the following on the backup host:

  Make sure BDRSuite Backup Agent(BBA) (runs with service name:BDRSuite Delegation Service) is installed.   

  Make sure the ‘BDRSuite Delegation Service’ status is running.

3.BBA installed on the backup host uses port 32005 to communicate with the BDRSuite Server. To check whether the port is open for communication between the backup host and backup server, open Command Prompt on the backup host and execute the following command.

 telnet [BDRSuite Server IP Address/DNS Name] [port]

If the port is not accessible, it can be due to the firewall settings. Make sure your firewall rules allow port 32005 to be open for communication.

4.If the connection to the backup host has still not been established, please check the logs on the location below for more information. The errors you may encounter in the logs while adding hosts are listed below along with the solutions.

Backup host:

Windows Log Location: <installation location>\Vembu\VembuIntegrationService\log\server.log

Example: C:\Program Files\Vembu\VembuIntegrationService\log\server.log

Linux Log Location:<installationlocation>/vembuintegrationservice/Vembu/VembuIntegrationService/log/server.log

Example: /home/vembuintegrationservice/Vembu/VembuIntegrationService/log/server.log

BDRSuite Backup Server:

Windows Log Location: <installation location>\Vembu\VembuBDR\log\server.log

Example: C:\Program Files\Vembu\VembuBDR\log\server.log

Linux Log Location: /<installation location>/vembubdr/Vembu/VembuBDR/log/server.log

Example: /home/vembubdr/Vembu/VembuBDR/log/server.log

How to resolve the issues you run into when adding backup hosts:

  • Error 117073: Unable to find the host - {Hostname/IP}. Make sure the host is added to the BDRSuite Server. --- To resolve this issue, make sure you add the host details and save them on the backup server under the Data Sources menu

  • Error 117074: Unable to connect to the BDRSuite Server. Make sure the BDRSuite Server is up and running. --- To resolve this issue, make sure you have specified the valid backup server IP address/DNS name and BDRSuite service is up and running.

  • Error 117076: BDRSuite Server isn't compatible with the BDRSuite Delegation Service (BDS) version running on the target host. Make sure the BDS runs the same or lower version than BDRSuite Server. --- To resolve this issue, ensure the BDRSuite Delegation Service runs on the same or lower version than the BDRSuite Server.

  • Error 117072: Unable to register the target host as another host with the same BIOS UUID added already. Hosts with unique BIOS UUID can only be added/registered to the BDRSuite Server. --- You can only add hosts that have unique BIOS UUID.

  • Error 117011: Unsupported Operating System for backup. --- Check the supported OS here.

If the backup host still didn't establish connection to the BDRSuite Backup Server, please contact our support team through vembu-support@vembu.com

edit retag flag offensive close merge delete