Steps To Add KVM Hosts through Manual Agent Installation

Steps To Add KVM Hosts through Manual Agent Installation

KB ID: 115211

Overview

This article provides step-by-step instructions to add KVM hosts to the BDRSuite Backup Server by manually installing the BDRSuite Delegation Service (BDS). This setup ensures seamless connectivity and allows efficient backup management for KVM hosts.

Supported Platforms

  • Debian Linux (64-bit): Debian Linux 11, Ubuntu 20.04, Ubuntu 22.04
  • Redhat Linux (64-bit): CentOS 8 Core, CentOS Stream 9, AlmaLinux 8, AlmaLinux 9, Rocky Linux 9

How to Video

Watch the following video to know more on how to add KVM hosts through manual agent installation

Step-by-Step Instructions

1. Install BDS on KVM Hosts

  • Download BDRSuite Delegation Service (BDS):

    • Download the appropriate BDRSuite Delegation Service (BDS) version for the host OS from the backup server console.
  • Run BDS Setup:

    • On the KVM host, execute the downloaded setup file and follow the on-screen instructions.
    • During installation, provide the following details:
      • Display Name: Enter a unique name to identify the host in the BDRSuite Backup Server.
      • Backup Server DNS Name/IP Address: Enter the DNS name or IP address of the BDRSuite Backup Server for registration.
    • Complete the installation by entering all required information.
  • Connection Verification:

    • After installation, the BDS agent will automatically establish a connection with the BDRSuite Backup Server.
    • To confirm, go to Data Sources in the BDRSuite console. The host details, including the display name, hostname/IP address, and connection status, should be visible.

2. Verifying Connection Status

  • Connected Status: If the BDS on the backup host successfully connects to the BDRSuite Server, the status will show as "Idle".
  • Disconnected Status: If not connected, the status will appear as "BDS Not Connected". In this case:
    1. Confirm that the BDRSuite Delegation Service is installed on the host.
    2. Ensure the BDRSuite Delegation Service is running.
    3. Verify that port 32004 is open for communication between the KVM host and the BDRSuite Backup Server:
      • Open Command Prompt and execute:
        telnet [BDRSuite Server IP Address/DNS Name] [port]
Notes
Note: If the port is inaccessible, check firewall settings to ensure port 32004 is allowed.

3. Configure Backups

  1. Navigate to the Backup Tab
  1.  Go to the "Backup" tab in the BDR server console.
  1. Configure Backup:
  1. Select "Configure Backup," then choose "Virtual Machines," followed by "KVM".
  1. Enter Backup Details:
  1. Enter the required backup details and click "Next."
  2. Select the VMs you wish to back up from the list of added KVM hosts and complete the backup configuration process.

Troubleshooting Connection Issues

If the KVM host does not connect to the BDRSuite Backup Server, check the logs for error messages.

Log Locations

  • Backup Host:
    • /home/vembuintegrationservice/Vembu/VembuIntegrationService/log/server.log
  • BDRSuite Backup Server:
    • Windows: C:\Program Files\Vembu\VembuBDR\log\server.log
    • Linux: /home/vembubdr/Vembu/VembuBDR/log/server.log

Common Errors and Resolutions

  • Error 117073: "Unable to find the host - {Hostname/IP}"

    • Solution: Ensure the host is added under the Data Sources menu in the BDRSuite console.
  • Error 117074: "Unable to connect to the BDRSuite Server"

    • Solution: Confirm the BDRSuite Server is operational and the correct IP/DNS is specified.
  • Error 117076: "BDRSuite Server isn't compatible with the BDS version"

    • Solution: Make sure the BDS version on the host matches or is lower than the BDRSuite Server version.
  • Error 117072: "Unable to register the target host as another host with the same BIOS UUID is already added"

    • Solution: Only unique BIOS UUIDs can be added to the BDRSuite Server.
  • Error 117011: "Unsupported Operating System for backup"

    • Solution: Verify OS compatibility here.

If issues persist, contact support at bdr-support@vembu.com

Following these instructions will ensure successful registration and connectivity of KVM hosts with the BDRSuite Backup Server, facilitating reliable backup management across virtual environments.