Move agent from one customer to another

How to move Endpoint Central MSP agent from Customer A to Customer B?

Note: The below steps shall apply only for builds 10.1.2215.1 and above.

Before initiating the agent transfer, navigate to Agent tab > Choose All Customers > Settings (Left tree) > Agent Settings. Disable 'Restrict users from uninstalling the Agent and Distribution server' option in Agent Protection Settings.

Agent Transfer
  1. Login to Endpoint Central MSP web console.
  2. Navigate to Admin tab > Scope Of Management > Computers. Click on the Download Agent button and download agent installer zip for the respective remote office of the Customer B to which the agent has to be transferred.
    For builds above 10.1.2127.1, download Agent installer zip from Agent Tab > Agent Installation > Other Methods > Command Line
    Agent Transfer
  3. Extract the downloaded zip.
  4. Download AgentReinstall.bat and place it inside directsetup
    Agent Transfer
  5. Compress and zip the contents. (UEMSMacAgent.zip should be excluded)
    Agent Transfer
  6. Choose the Customer A from which the agent has to be transferred. Go to Software Deployment Tab, select Packages from left pane. Navigate to Add Package > Windows > For Customer A. Provide a package name, choose EXE/APPX/MSIEXEC/MSU as Package type and Commercial from License Type and upload the AgentInstaller.zip file.
    Agent Transfer
  7. Provide AgentReinstall.bat /S in the Installation Command with Switches/Arguments and Add Package.
  8. To deploy the Installer file, click on Install/Uninstall Software and choose Windows > Computer Configuration
    Agent Transfer
  9. Define the target computers, and deploy the configuration. It is recommended to apply the configuration to a few test machines first.
  10. Once agent is successfully moved to Customer B, remove the SOM entries of the uninstalled agents from Customer A by navigating to Agents > Computers > Remove Computer(s).

Note: After the configuration is applied successfully, it will take about 10 minutes for the new agent to be installed.

Linux Agent Migration

  1. Download the Linux agent from the respective remote office of the Customer B to which the agent has to be transferred.
  2. Choose the Customer A from which the agent has to be transferred. Go to left pane, Add Script > For Customer A and click on Configurations Tab > select Script Repository. Add the script copyAgentFiles.bash to the script repository.
  3. Choose the Customer A from which the agent has to be transferred. Create a Linux custom script configuration and select the script copyAgentFiles.bash from the script repository and add below-given dependency files.
    • DesktopCentral_LinuxAgent.bin (This is available in the zip file downloaded from the respective remote office of the Customer B)
    • serverinfo.json (This is available in the zip file downloaded from the respective remote office of the Customer B)
    • LinuxAgentInstaller.sh

    Agent Transfer
  4. Define the targets and apply the configuration.
  5. Once agent is successfully moved to Customer B, remove the SOM entries of the uninstalled agents from Customer A by navigating to Agents > Computers > Remove Computer(s).

Note: After configuration is applied successfully, it will take a maximum of 10 minutes to install the new agent. It is recommended to apply the configuration to a few test machines first.

Mac Agent Migration

Note: The below configuration has to be completely executed from a mac machine in order to retain the executable permission of the script given in Step 3.

  1. Download the Mac agent from Endpoint Central MSP console
  2. Download script.sh to the same directory.
    Agent Transfer
  3. Set executable permission to the script
    MacAgent chmod +x script.sh
  4. Compress the package with serverinfo.plist and script.sh
    Agent Transfer
    Agent Transfer
  5. Choose the Customer A from which the agent has to be transferred.Click on Software Deployment Tab > select Packages. Go to Add Package > Mac > For Customer A.
  6. Provide a package name, choose Commercial from License Type and upload the Archive.zip file. In Advanced Options, type ./script.sh as shown
    Agent Transfer
  7. Deploy the Installer file as Mac > Computer Configuration from Install/Uninstall Software.
  8. Define the target computers, and deploy the configuration. It is recommended to apply the configuration to a few test machines first.
  9. Once agent is successfully moved to Customer B, remove the SOM entries of the uninstalled agents from Customer A by navigating to Agents > Computers > Remove Computer(s).

Note: After configuration is applied successfully, it will take a maximum of 10 minutes to installing the new agent.

Remote Desktop & Mobile Device Management Software for MSPs trusted by