Registering and unregistering workloads manually

Workloads are automatically registered in the Cyber Protection service when you install the protection agent on them. When you uninstall the protection agent, the workloads are automatically unregistered and disappear from the Cyber Protect console.

You can also register a workload 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 move a workload to a new tenant or under a new user account.

To register a workload by using a user name and password

In Windows

At the command line, run the following command:

"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud -a <service address> -u <user name> -p <password>

For example:

"C:\ProgramFiles\BackupClient\RegisterAgentTool\register_agent.exe" -o register -t cloud -a https://cloud.company.com -u johndoe -p johnspassword

In Linux

At the command line, run the following command:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a <service address> -u <user name> -p <password>

For example:

sudo "/usr/lib/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://cloud.company.com -u johndoe -p johnspassword

In macOS

At the command line, run the following command:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a <service address> -u <user name> -p <password>

For example:

sudo "/Library/Application Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent" -o register -t cloud -a https://cloud.company.com -u johndoe -p johnspassword

Use the user name and password for the account under which you want to register the workload. This cannot be a partner administrator account.

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

If your password contains special characters or blank spaces, refer to Passwords with special characters or blank spaces.

To register a workload by using a registration token

In Windows

At the command line, run the following command:

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

For example:

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

In Linux

At the command line, 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

At the command line, 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

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

At the command prompt, 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

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

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.

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

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 Generating a registration token.

To unregister a workload

In Windows

At the command line, run the following command:

"%ProgramFiles%\BackupClient\RegisterAgentTool\register_agent.exe" -o unregister

For example:

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

In Linux

At the command line, run the following command:

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

In macOS

At the command line, run the following command:

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

Virtual appliance

In the console of the virtual appliance, press CTRL+SHIFT+F2 to open the command-line interface.
At the command prompt, run the following command:
```
register_agent -o unregister
```
To return to the graphical interface of the appliance, press ALT+F1.

Moving a workload to another tenant

Moving a workload to another tenant is not natively supported. As a workaround, you can unregister the workload, and then register it in another tenant. All applied protection plans will be revoked from that workload, and it will lose access to its backups in the cloud storage of the original tenant.

For more information about how to register a workload in a new tenant or under a new user account, see Changing the registration of a workload.