Home » Agent Migration from On-premise to Cloud
Applicable For Endpoint Central MSP 
 
 

Agent Migration from On-premise to Cloud

Points to be noted before initiating the migration process

  • The associated data with the computers will not be migrated to Cloud.
  • The queued configurations associated with each computer will be suspended automatically after migrating the agent.
  • The below-mentioned steps should be followed after signing up for Endpoint Central Cloud, and before you add the computer details in the Cloud console.
  • This collection should be deployed from Endpoint Central OP console.
  • Before deploying the script to the target machines, it is highly recommended to test it on a couple of machines, and then proceed with batch-wise deployment.

To know more about data migration, click here.

The below-given steps will help you migrate the agents to Endpoint Central Cloud.

  • Windows
  • Mac
  • Linux

Windows Agent Migration

1. Download the new agent package

  • Open the Endpoint Central server web console.
  • Navigate to the Agent -> Computers
  • Select the required remote office
  • Click the Download Agent button
  • Rename the file to LocalOffice_Agent.exe and place it In a folder.

2. Download the zip

  • Extract and copy the contents from this link to the previously created folder.

3. Generate AgentCleanupToolclient

    • Follow the steps in this doc to create the agent cleanup tool and place the generated AgentCleanupToolClient.exe to the same folder.
    • The folder should contain the below files.

agentmigration1

4. Open command prompt with Admin rights and run ExeCreation.bat and generate Agent.exe

agentmigration2

5. Copy the file Agent.exe to the client machine and run it in CMD as administrator.

6. Ensure if the migration is working seamlessly.

7. In the Endpoint Central server web console, navigate to Configuration-> Windows-> Custom Script-> Computer

agentmigration3

8. Enter the name of the configuration and click the Create\Modify script and add the script to repository. Click here to download the script.

agentmigration4

9. Once done, select the script in the custom script configuration.

10. In dependency files upload the previously generated Agent.exe file. Select the target and deploy the configuration

agentmigration5

11. Once the changes applied the agent will be moved to the new server console.

Mac Agent Migration

  • On the Endpoint Central console, navigate to Agent tab -> Agent Settings -> Agent Protection Settings and disable Restrict users from uninstalling the Agent and Distribution server , if enabled.
  • Download the Mac agent from Endpoint Central cloud console. To download the Mac agent, open the server web console --> Agent tab --> Computers --> Select the required remote office --> Click the Download Agent button --> Rename the file to LocalOffice_Agent.exe and place it in a folder.
  • Download Migration.sh to the same directory.

op-cloud-migration-mac-1

  • Zip the package with serverinfo.plist and Migration.sh

op-cloud-migration-mac-2

  • Navigate to Endpoint Central server web console -> Software deployment -> Add Package -> Mac
  • Create a Mac package by uploading the Archive.zip generated. In advanced options, type sh ./Migration.sh as shown

op-cloud-migration-mac-3

  • Create a Mac Software Deployment configuration and deploy the created package to required machines on-premise. It is recommended to apply the configuration to a few test machines first.

Linux Agent Migration

  • On the Endpoint Central console, navigate to Agent tab -> Agent Settings -> Agent Protection Settings and disable Restrict users from uninstalling the Agent and Distribution server , if enabled.
  • Download the Linux agent from Endpoint Central cloud console. To download the Mac agent, open the server web console --> Agent tab --> Computers --> Select the required remote office --> Click the Download Agent button --> Rename the file to LocalOffice_Agent.exe and place it in a folder.
  • Create a Linux custom script configuration.

op-cloud-migration-linux

  • Add the script copyAgentFiles.bash to script repository and add below dependency files.
    • DesktopCentral_LinuxAgent.bin/UEMS_LinuxAgent.bin (In the zip file downloaded from DC cloud console)
    • serverinfo.json (In the zip file downloaded from DC cloud console)
    • LinuxAgentInstaller.bash

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

  • Define the targets and apply the configuration.

This way, all the Endpoint Central agents will be migrated from OP to Cloud, thereby ensuring a seamless agent installation process.

Note: This feature is applicable for the Cloud edition of Endpoint Central.