Acronis Cyber Protect Cloud: Registering backup agent manually

Acronis Cyber Protect Cloud: Registering backup agent manually

Symptoms

You have successfully installed an Acronis Backup Agent, but registration failed and machine does not appear in Cyber Protection console.

Or you need to re-register a client machine to another Backup Account.

Solution

Use this method to manually register a Backup Agent.

Note that account name and password used in the commands are for backup user account, not for Partner-level admin

Use quotation marks, if your password contains special characters or spaces.

Instructions below are applicable to Acronis Cyber Protect Cloud 7.8 and newer. If you use an older version of the product, click here

Windows OS

  1. Open Command prompt and navigate to C:\Program Files\BackupClient\RegisterAgentTool:
    cd "%ProgramFiles%\BackupClient\RegisterAgentTool"
  2. Issue this command to register the client machine using account and password:

    register_agent.exe -o register -t cloud -a https://cloud.acronis.com -u <account> -p <password>

    where  -u <account> -p <password> are login and password for backup user account, follow these instructions if the password contains special characters

    or issue this command to register the client machine using registration token:
    "C:\Program Files\BackupClient\RegisterAgentTool\register_agent.exe" -a <your-datacenter> --token <token> -o register -t cloud

    <your-datacenter> is the datacenter address displayed in browser when you log in to Cyber Protection console, e.g. https://au1-cloud.acronis.com

Linux OS

  1. Open terminal as root user.
  2. Type in the following command to register the agent using account and password:
    /usr/lib/Acronis/RegisterAgentTool/RegisterAgent -o register -t cloud -a https://cloud.acronis.com -u <account> -p <password>

    where  -u <account> -p <password> are login and password for backup user account, follow these instructions if the password contains special characters

    or execute the following command to register the client machine using registration token:
     /usr/lib/Acronis/RegisterAgentTool/RegisterAgent -o register -t cloud -a <your-datacenter> --token <token>

    <your-datacenter> is the datacenter address displayed in browser when you log in to Cyber Protection console, e.g. https://au1-cloud.acronis.com

OS X

  1. Open terminal.
  2. Execute the following command to register the client machine using account and password:
    sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://cloud.acronis.com -u <account> -p <password>

    where  -u <account> -p <password> are login and password for backup user account, follow these instructions if the password contains special characters

    or execute the following command to register the client machine using registration token:
    sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a <your-datacenter> --token <token>

    <your-datacenter> is the datacenter address displayed in browser when you log in to Cyber Protection console, e.g. https://au1-cloud.acronis.com

HideInstructions for Acronis Cyber Protect Cloud 7.5 or older: click to expand

Windows OS

  1. Open Command prompt and navigate to C:\Program Files\BackupClient\BackupAndRecovery:
    cd "%ProgramFiles%\BackupClient\BackupAndRecovery"
  2. Issue this command to register the client machine:
    register_msp_mms.exe register https://cloud.acronis.com <account> <password>

    where  -u <account> -p <password> are login and password for backup user account, follow these instructions if the password contains special characters

Linux OS

  1. Open terminal as root user.
  2. Type in the following command to register the agent:
    /usr/lib/Acronis/BackupAndRecovery/AmsRegisterHelper register https://cloud.acronis.com <account> <password>

    where  -u <account> -p <password> are login and password for backup user account, follow these instructions if the password contains special characters

OS X

  1. Open terminal.
  2. Execute:
    sudo "/Library/Application Support/BackupClient/Acronis/BackupAndRecovery/AmsRegisterHelper" register https://cloud.acronis.com <account> <password>

    where  -u <account> -p <password> are login and password for backup user account, follow these instructions if the password contains special characters

 

Troubleshooting

Your password contains special characters, and you receive this error while providing correct credentials:

  1. Encode the password into base64 format: https://www.base64encode.org/
  2. Specify the encoded password using the -b or --base64 parameter. For a Windows agent, it would be:
    register_agent.exe -o register -t cloud -a https://cloud.acronis.com -u <account> -b -p <encoded password>

If you want-to re-register Agent from one Backup Account to another, and the operation fails, try unregistering the Agent first:

  1. Open Command prompt and navigate to C:\Program Files\BackupClient\RegisterAgentTool:
    cd "%ProgramFiles%\BackupClient\RegisterAgentTool"
  2. Issue this command to unregister the client machine:

    register_agent.exe -o unregister 

    • Related Articles

    • Acronis Cyber Protect Self Installation

          Received activation email but not sure what to do next? We are here to help. Please follow these steps.   Step 1 – Activating and Accessing your Acronis Console   Your activation email should look like this.   Click on “Activate account”. Now you ...
    • Acronis Cyber Protect Cloud - Implementation Guide

      1. Which agent do I need? Selecting an agent depends on what you are going to back up. The table below summarizes the information, to help you decide. In Windows, Agent for Exchange, Agent for SQL, Agent for Active Directory, and Agent for Oracle ...
    • Acronis Cyber Protect Cloud: Resumable Backup technology

      Acronis Cyber Protect Cloud uses Resumable Backup technology which reduces network load and therefore enhances backup performance. Resumable Backup means that in case of a backup failure data upload will be resumed, i.e.: data, which was transferred ...
    • Acronis Cyber Protect Cloud: how to check which account the Agent is registered to

      Purpose This article describes how to programmatically check which Cloud Backup Account the device is registered to and if it's registered at all. This is useful if you have Acronis Cyber Protect Cloud software installed on the device but is not ...
    • Acronis Cyber Protect Cloud: Windows Services and Processes

      Acronis Managed Machine Service is the main service. It can run under a dedicated account or under an account, you specify during installation. Either account is given privileges that are needed for the service to work. The privileges include a set ...