Overview  

This knowledge base article explains how to troubleshoot and resolve Error 117102 – Invalid registration token encountered while installing or registering a BDRShield component with the BDRShield Backup Server.

Problem Description  

During the installation or registration of a BDRShield component, the following error may occur:

• Error Code: 117102

• Error Message: Invalid registration token

When this error occurs, the component cannot complete the registration process with the BDRShield Backup Server.

Cause  

This error occurs when the registration token provided during installation or registration cannot be validated by the BDRShield Backup Server.

The possible causes include:

1. Incorrect registration token: The token entered is incorrect, incomplete, or contains unintended leading or trailing spaces.

2. Incorrect command-line parameter: During silent or bulk installation, the REGISTERTOKENKEY parameter is missing, contains an invalid value, or is not passed in the expected format.

Solution   

Follow the steps below to resolve the registration error.

Step 1: Obtain the Correct Registration Token  

1. Log in to the BDRShield Backup Server web console.

2. Navigate to Data Sources → Servers & Endpoints / BDR Proxy, depending on the component being installed.

3. Click Add Host and select the appropriate operating system or component type, where applicable.

4. Locate the Registration Token field in the installation or registration window.

5. If a tenant selection option is available, select the account or tenant under which the component must be registered.

6. Click Copy next to the registration token field to copy the token.

Important: Ensure that you select the correct account or tenant before copying the registration token.

• Master Admin registration: Use the registration token associated with the Master Admin account when the component must be registered under the Master Admin inventory.

• Tenant registration: Select the intended tenant and use its registration token when the component must be registered under that tenant.

The available options and registration behavior may vary depending on the component type and product version.

Step 2: Retry the Installation or Registration  

After obtaining the correct registration token, retry the component installation or registration.

• For manual installation: Use the newly copied registration token and ensure that it is entered correctly.

• For silent or bulk installation: Verify that the REGISTERTOKENKEY parameter contains the correct registration token and is passed in the format specified by the installation procedure.

For detailed installation and configuration instructions, refer to the BDRShield User Guide – Adding Backup Sources. 

Step 3: Verify Registration  

After retrying the installation or registration, verify the following:

1. The installation or configuration process completes successfully.

2. The component appears in the appropriate inventory or data source list in the BDRShield Backup Server console.

3. The component establishes communication with the BDRShield Backup Server.

4. The component's active status is displayed as Active.