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 Agent Migration
1. Download the new agent package
- Open the Endpoint Central Cloud 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](https://www.manageengine.com/au/products/desktop-central/help/images/agentmigration1.png)
4. Open command prompt with Admin rights and run ExeCreation.bat and generate Agent.exe
![agentmigration2](https://www.manageengine.com/au/products/desktop-central/help/images/agentmigration2.png)
5. Copy the file Agent.exe to the client machine and run it in CMD as administrator with /silent argument Eg: > Agent.exe /silent.
![agentmigrationcmd](https://www.manageengine.com/au/products/desktop-central/help/images/agentmigrationcmd.png)
6. Ensure if the migration is working seamlessly.
7. In the Endpoint Central server web console, navigate to Configuration-> Windows-> Custom Script-> Computer
![agentmigration3](https://www.manageengine.com/au/products/desktop-central/help/images/agentmigration3.png)
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](https://www.manageengine.com/au/products/desktop-central/help/images/agentmigration4.png)
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](https://www.manageengine.com/au/products/desktop-central/help/images/agentmigration5.png)
11. Once the changes applied the agent will be moved to the new server console.
Mac Agent Migration
- On the Endpoint Central Cloud 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](https://www.manageengine.com/au/products/desktop-central/help/images/mm1.png)
- Zip the package with serverinfo.plist and Migration.sh
![op-cloud-migration-mac-2](https://www.manageengine.com/au/products/desktop-central/help/images/mm2.png)
- Navigate to Endpoint Central 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](https://www.manageengine.com/au/products/desktop-central/help/images/mm3.png)
- 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 Cloud 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](https://www.manageengine.com/au/products/desktop-central/help/images/op-cloud-migration-linux.png)
- 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.