Registering machines manually

In addition to registering a machine in the Cyber Protect service during the agent installation, you can also register it by using the command line interface. You might need to do so if you have installed the agent but the automatic registration failed, for example, or if you want to register an existing machine under a new account.

To register a machine

At the command prompt of the machine where the agent is installed, run one of the following commands:

  • To register a machine under the current account:

    <path to the registration tool> -o register -s mms -t cloud --update

    • Here, the <path to the registration tool> is:

      • in Windows: %ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe
      • in Linux: /usr/lib/Acronis/RegisterAgentTool/RegisterAgent
      • in macOS: /Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent

  • To register a machine under another account:

    <path to the registration tool> -o register -t cloud –a <service address> -u <user name> -p <password>

    • Here, the <user name> and <password> are the credentials for the specific account under which the agent will be registered. This cannot be a partner administrator account.

      The <service address> is the URL that you use to log in to the Cyber Protect service. For example, https://cloud.company.com.

  • To register a machine with a registration token:

    <path to the registration tool> -o register -t cloud -a <service address> --token <token>

    • The registration token is a series of 12 characters, separated by hyphens in three segments. For more information on how to generate one, refer to "Deploying agents through Group Policy".

      When you use a registration token, you must specify the exact datacenter address as <service address>. This is the URL that you see once you are logged in to the Cyber Protect service. For example, https://eu2-cloud.company.com.

      Do not use https://cloud.company.com here.

To unregister a machine

At the command prompt of the machine where the agent is installed, run the command:

<path to the registration tool> -o unregister

Examples

Windows

"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -s mms -t cloud --update
"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud –a https://cloud.company.com -u johndoe -p johnspassword
"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud -a https://au1-cloud.company.com --token 3B4C-E967-4FBD 
"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o unregister

Linux

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -s mms -t cloud --update
sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register –t cloud –a https://cloud.company.com -u johndoe -p johnspassword
sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://eu2-cloud.company.com --token 34F6-8C39-4A5C
sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o unregister

macOS

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -s mms -t cloud --update
sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud –a https://cloud.company.com -u johndoe -p johnspassword
sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://us5-cloud.company.com --token 9DBF-3DA9-4DAB 
sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o unregister

Passwords with special characters or blank spaces

If your password contains special characters or blank spaces, enclose it in quotation marks when you type it on the command line:

<path to the registration tool> -o register -t cloud -a <service address> -u <user name> -p <"password">

Example (for Windows): 

"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud –a https://cloud.company.com -u johndoe -p "johns password"

If you still receive an error:

  • Encode your password into base64 format at https://www.base64encode.org/.
  • On the command line, specify the encoded password by using the -b or --base64 parameter.
<path to the registration tool> -o register -t cloud -a <service address> -u <user name> -b -p <encoded password>

Example (for Windows): 

"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud –a https://cloud.company.com -u johndoe -b -p am9obnNwYXNzd29yZA==