# 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](https://www.manageengine.com/products/desktop-central/help/migrate-to-endpoint-central.html).

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 **Cloud web console**.
   - Navigate to **Agent > Computers**.
   - Select the required remote office.
   - Click the **Download Agent** button.
   - Place the downloaded agent installer `.exe` in a folder.

2. **Download the Agent Migration Tool**
   - Copy the `.exe` from this [link](https://workdrive.zohopublic.in/external/3ab253e31db11237c0e4dea1c22d2a02a6540e1ef38a2ab8a628378f4065a8b9/download?directDownload=true) to the previously created folder.

3. **Launch AgentMigrationTool.exe and generate the Agent.exe**
   - Right-click on `AgentMigrationTool.exe` and select **Run as administrator**.
   - Click **Choose Agent Installer** and select your target agent installer (`.exe` file).

![agentmigrationcmd](https://www.manageengine.com/products/desktop-central/help/images/agent-exe-third-sec.png)

   1. Confirm the displayed **Version** and **Server** information match your destination server.
   2. Click **Create Agent.exe** and wait for completion.

![agentmigrationcmd](https://www.manageengine.com/products/desktop-central/help/images/agent-exe-third-fifth-above.png)

   3. The `Agent.exe` file will be created in the same directory as the tool.

![agentmigrationcmd](https://www.manageengine.com/products/desktop-central/help/images/agent-exe-thord-fourth.png)

4. Copy the file `Agent.exe` to the client machine and run it in **CMD as administrator** with `/silent` argument.  
   Example:
   ```
   Agent.exe /silent
   ```

![agentmigrationcmd](https://www.manageengine.com/products/desktop-central/help/images/agentmigrationcmd.png)

5. Ensure if the migration is working seamlessly.

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

![agentmigration3](https://www.manageengine.com/products/desktop-central/help/images/agentmigration3.png)

7. Enter the name of the configuration and click **Create/Modify script** and add the script to repository. Click here to [download the script](https://www.manageengine.com/products/desktop-central/scripts/migrateagent.bat).

![agentmigration4](https://www.manageengine.com/products/desktop-central/help/images/agentmigration4.png)

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

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

![agentmigration5](https://www.manageengine.com/products/desktop-central/help/images/agentmigration5.png)

10. Once the changes are applied, the agent will be moved to the new server console.

## Mac Agent Migration

1. In the Endpoint Central on-premise web console, navigate to **Agent tab -> Agent Settings -> Agent Protection Settings** and disable **Restrict users from uninstalling the Agent and Distribution server**, if enabled.

2. **Download Agent Package**
   - Open the **Cloud web console**.
   - Navigate to **Agent > Computers**.
   - Select the required remote office.
   - Click the **Download Agent** button.
   - Rename the file to `UEMS_MacAgent.pkg` and place it in a folder.

3. Download [Migration.sh](https://www.manageengine.com/products/desktop-central/Migration.sh) to the same directory.

![op-cloud-migration-mac-1](https://www.manageengine.com/products/desktop-central/help/images/mm1.png)

4. Zip the package with **serverinfo.plist** and **Migration.sh**.

![op-cloud-migration-mac-2](https://www.manageengine.com/products/desktop-central/help/images/mm2.png)

5. Navigate to **Endpoint Central console -> Software deployment -> Add Package -> Mac**.

6. Create a Mac package by uploading the **Archive.zip** generated. In advanced options, type:
   ```
   sh ./Migration.sh
   ```

![op-cloud-migration-mac-3](https://www.manageengine.com/products/desktop-central/help/images/mm3.png)

7. 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

1. In 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.

2. **Download the Linux agent**
   - Open the **Cloud web console**.
   - Navigate to **Agent > Computers**.
   - Select the required remote office.
   - Click the **Download Agent** button.
   - Rename the file to `UEMS_LinuxAgent.bin` and place it in a folder.

3. Create a Linux **custom script** configuration.

![op-cloud-migration-linux](https://www.manageengine.com/products/desktop-central/help/images/op-cloud-migration-linux.png)

4. Add the script [copyAgentFiles.bash](https://www.manageengine.com/products/desktop-central/scripts/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](https://workdrive.zohoexternal.in/external/a3cfba3077880808f72cc13b79276ed4b567426eaea38ed690fb20f48f7b0ed3)

**Note:** After configuration is successfully applied, 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.

5. 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.