Registering and unregistering machines manually

Machines are automatically registered on the management server when you install the protection agent on them. When you uninstall the protection agent, the machines are automatically unregistered and disappear from the Cyber Protect web console.

You can also register a machine manually, by using the command line interface. You might need to use the manual registration, for example, if the automatic registration fails or if you want to register an existing machine under a new user account.

You can find the registration tool in the following locations:

Windows: Program Files\Acronis\RegisterAgentTool\register_agent.exe
Linux: /usr/lib/Acronis/RegisterAgentTool/RegisterAgent
macOS: /Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent

To register a machine by using a user name and password

In Windows

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> -u <user name> -p <password>

For example:

"C:\Program Files\BackupClient\RegisterAgentTool\register_agent.exe" -o register –a https://10.250.144.179:9877 -u johndoe -p johnspassword

In Linux

At the command line, run the following command:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -a <management server address:port> -u <user name> -p <password>

For example:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register –a https://10.250.144.179:9877 -u johndoe -p johnspassword

In macOS

At the command line, run the following command:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -a <management server address:port> -u <user name> -p <password>

For example:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -a https://10.250.144.179:9877 -u johndoe -p johnspassword

The <management server address:port> is the host name or the IP address of the machine on which the management server is installed. If you use the default port 9877, you can omit specifying it in this command.

The <user name> and <password> are the credentials of the account under which the agent will be registered. If your password contains special characters or blank spaces, see Passwords with special characters or blank spaces.

To register a machine in a specific unit by using a user name and password

In Windows

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> -u <user name> -p <password> --tenant <unit ID>

For example:

"C:\Program Files\BackupClient\RegisterAgentTool\register_agent.exe" -o register –a https://10.250.144.179:9877 -u johndoe -p johnspassword --tenant 590b1dd7-8adb-11ea-bf44-0050569deecf

In Linux

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> -u <user name> -p <password> --tenant <unit ID>

For example:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register –a https://10.250.144.179:9877 -u johndoe -p johnspassword --tenant 590b1dd7-8adb-11ea-bf44-0050569deecf

In macOS

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> -u <user name> -p <password> --tenant <unit ID>

For example:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register –a https://10.250.144.179:9877 -u johndoe -p johnspassword --tenant 590b1dd7-8adb-11ea-bf44-0050569deecf

The <user name> and <password> are the credentials of account under which the agent will be registered. If your password contains special characters or blank spaces, see Passwords with special characters or blank spaces.

To check the unit ID, in the Cyber Protect web console, go to Settings > Accounts. Select the unit that you need, and then click Details.

You can register agents only at your level of the organization hierarchy. Unit administrators can register agents in their own units and their subunits. Organization administrators can register agents in all units. For more information about the different administrator accounts, see Administering user accounts and organization units.

To register a machine by using a registration token

In Windows

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> --token <token>

For example:

"C:\Program Files\BackupClient\RegisterAgentTool\register_agent.exe" -o register -a https://10.250.144.179:9877 --token 3B4C-E967-4FBD

In Linux

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> --token <token>

For example:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -a https://10.250.144.179:9877 --token 34F6-8C39-4A5C

In macOS

At the command line, run the following command:

<path to the registration tool> -o register -a <management server address:port> --token <token>

For example:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -a https://10.250.144.179:9877 --token 9DBF-3DA9-4DAB

To unregister a machine

In Windows

At the command line, run the following command:

<path to the registration tool> -o unregister

For example:

"C:\Program Files\BackupClient\RegisterAgentTool\register_agent.exe" -o unregister

In Linux

At the command line, run the following command:

<path to the registration tool> -o unregister

For example:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o unregister

In macOS

At the command line, run the following command:

<path to the registration tool> -o unregister

For example:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o unregister