In some cases you may need to change MMSCurrentMachineID and InstanceID on agent machine, e.g. when there are issues with agent registration.

This article explains how to do this.

Solution

Remove the Agent from Management Server and run a special script that will clear the local databases to avoid duplicates. After you re-add the machine to Management Server, Agent will obtain the new configuration data from it automatically.

Perform the following steps on the Agent where you want to change MMSCurrentMachineID and InstanceID:

1. Delete the agent from Management Server: go to Settings > Agents, select the agent and click Delete on the menu on the right
2. Generate a new GUIDs for MMSCurrentMachineID and a new GUID for InstanceID and note them, as they will be required for running the script:
   • On Windows: use New-Guid cmdlet (launch Command Prompt -> type powershell to open powershell interface -> type new-guid to generate a GUID)
   • On Linux: open Terminal and run the following command: uuidgen

   GUID can be generated on any machine, not necessarily on the machine where you plan to change IDs.

3. Acronis Cyber Backup Cloud: starting with version 7.8 update 2, the script is placed into Program Files\BackupClient\PyShell\site-tools\change_machine_id.py
   Acronis Cyber Backup 12.5: starting with Update 4 (Build 12730) the script is installed with the product and can be found at Program Files\Acronis\PyShell\site-tools\change_machine_id.py
   Acronis Cyber Protect 15: the script is installed with the product and can be found at Program Files\Acronis\PyShell\site-tools\change_machine_id.py
   If you are using an older build (Acronis Cyber Backup 12.5 before build 12730 or Acronis Cyber Protect Cloud before 7.8), click here to download the script.
4. Update local configuration using the script: 

If Agent is installed on Windows: click to expand

1. If you downloaded the script from this article, decompress the archive with the script, e.g. to C:/
2. Launch elevated Command Prompt:
   • Click the Start button. In the search box, type cmd.
   • Right-click on cmd.exe and choose Run as Administrator. User Account Control window will appear. Click Yes to run the Windows Command Prompt as Administrator.
3. Execute the following command:
   7.8 update 2 or Update 4: acropsh change_machine_id.py -m <MMSCurrentMachineID> -i <InstanceID>

   older builds: acropsh <path to the script> -m <MMSCurrentMachineID> -i <InstanceID>

   Instead of MMSCurrentMachineID and InstanceID insert new GUIDs generated at step 2 with New-Guid

4. For example, if the script was placed on C:/ and with 2 generated GUIDs:

   acropsh C:\change_machine_id.py -m 5FA56246-5A99-4163-8481-0206BC2D40D5 -i B3D1D0EB-D1DF-4B47-AD6E-77A15A405DC5

5. Restart Acronis Managed Machine service: press Win+R and type in services.msc in the Run window. Select Acronis Managed Machine service and click Restart

If Agent is installed on Linux: click to expand

1. Decompress the downloaded archive with the script.
2. If you are using Acronis Cyber Backup 12.5 Update 4 or later, or Acronis Cyber Protect Cloud 7.8 or later, the script is located at /usr/lib/Acronis/PyShell/site-tools/change_machine_id.py
3. Open terminal (if you're using GUI) and elevate rights: su -
4. Execute the following command:
   7.8 update 2 or Update 4: acropsh change_machine_id -m <MMSCurrentMachineID> -i <InstanceID>

   older builds: acropsh <path to the script> -m <MMSCurrentMachineID> -i <InstanceID>

   Instead of MMSCurrentMachineID and InstanceID insert new GUIDs generated at step 2.

5. Restart Acronis Managed Machine service:

   service acronis_mms restart

If Agent is installed on macOS: click to expand

1. Decompress the downloaded archive with the script if you downloaded the script from this article
2. Launch Terminal and execute the following command:
   sudo "/Library/Application Support/BackupClient/Acronis/sbin/acropsh"  "/Library/Application Support/BackupClient/Acronis/PyShell/site-tools/change_machine_id.py" -m <MMSCurrentMachineID> -i <InstanceID>

   Instead of MMSCurrentMachineID and InstanceID insert new GUIDs generated at step 2.

3. Restart Acronis Managed Machine service

        sudo launchctl start acronis_mms

4. Register the agent on the Management Server again:

• Acronis Cyber Protect Cloud: see Registering backup client manually
• Acronis Cyber Protect 15, Acronis Cyber Backup 12.5: see How to manually add a machine to management server.