Migrate an Endpoint Central server

Migrating to a New Machine While Retaining Your Existing Network Configuration

This guide details the steps required to migrate your Central Server to a new machine while keeping the same network configuration, including FQDN, machine name, and IP address. By following these steps, you will ensure that your agents continue to communicate with the new server without disruption.

Table of Contents

• Pre-requisites Before Server Migration
• Steps to Perform on the Current Central Server Setup
• Steps to Perform on the New Central Server Setup
• Post-Migration Steps
• Frequently Asked Questions
• Support and Assistance

Pre-requisites Before Server Migration

• Ensure that all necessary ports for agent communication with the new server are open. Refer to the port requirements.
• If your data size is large, follow the cleanup document to remove unwanted files from the Central Server directory.
• Verify that there is enough space available in the new directory for the Central Server installation.

Steps to Perform on the Current Central Server Setup

1. In the web console, go to the Admin tab. Under Server Settings, select Central Server Migration.
2. 
3. Select the migration method: Use existing FQDN / IP Address on the new computer.
4. 
5. Download the Server Migration Guide and follow the 'Steps to Ensure' section to prevent startup issues with the new server.

6. Run the following command in Command Prompt (as administrator) on your old installation:

   server-migration.bat retain

   Example: C:\ManageEngine\UEMS_CentralServer\bin\server-migration.bat retain

7. 
8. Zip the entire Central Server installation directory (e.g., UEMS_CentralServer) and transfer UEMS_CentralServer.zip to the new computer.
9. 
10. Once migration is completed on the old server, the service will be stopped. If restarted, it will automatically stop as migration is complete.

Steps to Perform on the New Central Server Setup

1. Extract UEMS_CentralServer.zip on the new server to the desired location.
2. Navigate to <extracted_location>\conf and delete the ws.modtime file.
3. 

4. Run the following command in Command Prompt (as administrator) from the extracted location:

   Migrate-DCServer.bat

   Example: C:\ManageEngine\UEMS_CentralServer\bin\Migrate-DCServer.bat

5. 
6. After migration, start the Central Server service. Agents will contact the new server during their next refresh cycle.

Post-Migration Steps

1. Verify Successful Migration: Ensure that the new server starts without any issues. A successful startup confirms that migration was performed correctly.
2. Verify Agent Communication:
   • Navigate to Admin > SOM Settings > Scope of Management > Computers.
   • Filter by "Last Contact Time" to confirm agent communication after the new server startup.

Frequently Asked Questions

• When should I remove the old server setup? Do not remove the old setup until all agents have reported to the new server.
• Do I need to reapply the server license? No, the license remains valid after migration.