Overview

The Agent Replacement feature allows users to replace a lost or unintentionally uninstalled agent, ensuring continuity with the current backup configurations. The new installation can be associated with the existing agent, but note that the first backup schedule after replacement defaults to a full backup.

Agent replacement can be performed using one of the following three methods:

1. Agent Replacement by Manual Installation

If you are manually replacing an existing agent, follow these steps:

Generate the Agent Replacement Token:

1. Navigate to the Data Sources section in the BDRSuite UI.
2. Go to Servers and Endpoints.
3. Select the Agent Replacement option for the existing agent.
4. Click Agent Token to generate the replacement token.

Install the New Agent:

1. During the installation process, select the Replace an Existing Agent option.
2. Enter the token generated in the previous step when prompted.

This process replaces the old agent using the token for authentication.

Important Note:
If the token is entered incorrectly, the system will display:
“Token verification failed during agent installation, so the agent was added as a new instance. You can manually merge the agents later through the UI.”

In this case, manually merge the agents via the UI as described in method 3.

2. Agent Replacement via Silent Installation

If you prefer silent installation, use the commands below for your respective operating system:

For Windows

Disk Image Backup:

msiexec /i BDRSuite_Delegation_Service_7_1_5.msi /qn BACKUPSERVERINFO="Backup Server IP Address/DNS Name" IMAGEBACKUPENABLED="1" INSTALLDRIVER="Yes" AGENTTOKEN='Agent Replacement Token'  

To reboot the host immediately after installation (required for Disk Image Backup):

REBOOT="Force"  

Files & Folders Backup:

msiexec /i BDRSuite_Delegation_Service_7_1_5.msi /qn BACKUPSERVERINFO="Backup Server IP Address/DNS Name" AGENTTOKEN='Agent Replacement Token'  

For Linux

Debian Linux:

bash BDRSuite_Delegation_Service_7_1_5_DBN.bin --BACKUPSERVERINFO "Backup Server IP Address/DNS Name" --AGENTTOKEN='Agent Replacement Token'  

Red Hat Linux:

bash BDRSuite_Delegation_Service_7_1_5_RH.bin --BACKUPSERVERINFO "Backup Server IP Address/DNS Name" --AGENTTOKEN='Agent Replacement Token'  

For macOS

Intel Mac:

sudo sh BDRSuite_Delegation_Service_7_1_5_IMac.bin "Backup Server IP Address/DNS Name" "Agent Replacement Token"  

ARM Mac:

sudo sh BDRSuite_Delegation_Service_7_1_5_IMac_arm64.bin "Backup Server IP Address/DNS Name" "Agent Replacement Token"  

3. Merging Duplicate Agents via the UI (Post-Installation)

If you accidentally select the Fresh Installation option without providing the required token, you can resolve this by merging duplicate agents through the UI.

1. Navigate to the Agent Replacement Option:
   

   • Go to Data Sources → Servers and Endpoints.
   • Select the Agent Replacement option for the new agent.
     

2. Merge Duplicate Agents:
   

   • Click Merge Duplicate Agents.
     

Note:

• When merging, the host to merge will be replaced with the selected host.
• The selected host must not have any existing backups, as this action may impact backup data integrity.
  

For additional assistance, contact the support team or refer to the detailed installation guides.