Registering workloads by using a registration token

A registration token is a series of 12 characters, separated by hyphens in three segments. The registration token passes the identity of a user to the agent setup program, without storing the user credentials for the Cyber Protect console. This enables users to register workloads under their account or apply protection plans to workloads without logging in to the console.

For more information, see Generating a registration token.

Protection plans are not applied automatically during workload registration. Applying a protection plan is a separate task.

For more information, see this knowledge base article.

When you use a registration token, you must specify the exact data center address. This is the URL that you see after you log in to the Cyber Protection service.

For example, https://eu2-cloud.company.com.

To register a workload by using a registration token

In Windows

  • In Command Prompt, run the following command:

    "%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud -a <service address> --token <registration token>

For example:

"C:\Program Files\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud -a https://au1-cloud.company.com --token 3B4C-E967-4FBD

In Linux

  • In the command-line interface, run the following command:

    sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a <service address> --token <registration token>

For example:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://eu2-cloud.company.com --token 34F6-8C39-4A5C

In macOS

If you use macOS 10.14 or later, grant full disk access to the protection agent. To do so, go to Applications >Utilities, and then run Cyber Protect Agent Assistant. Then, follow the instructions in the application window.

  • In the command-line interface, run the following command:

    sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a <service address> --token <registration token>

For example: 

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://us5-cloud.company.com --token 9DBF-3DA9-4DAB

Virtual appliance

  1. In the console of the virtual appliance, press CTRL+SHIFT+F2 to open the command-line interface.

  2. In the command-line interface, run the following command:

    register_agent -o register -t cloud -a <service address> --token <registration token>

    For example:

    register_agent -o register -t cloud -a https://eu2-cloud.company.com --token 34F6-8C39-4A5C

  3. To return to the graphical interface of the appliance, press ALT+F1.