Migrate an Endpoint Central server
Home » Features »

Migrate an Endpoint Central server
Free Trial

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.

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. Central Server Migration option in Admin settings
  3. Select the migration method: Use existing FQDN / IP Address on the new computer.
  4. Selecting FQDN/IP method for Central Server migration
  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. Command to execute the Central Server migration script
  8. Zip the entire Central Server installation directory (e.g., UEMS_CentralServer) and transfer UEMS_CentralServer.zip to the new computer.
  9. Zipping and transferring the Central Server installation directory
  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. Deleting ws.modtime file after extracting Central Server directory
  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. Executing Migrate-DCServer script for finalizing migration
  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.
Verifying agent communication after Central Server migration

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.
Migration Assistance Service

Need Assistance? Try Our Professional Service

We offer a professional service to migrate your Server and Data for $295. Register here if you’re interested.
Was this article helpful?

Thank you for your feedback!

Sorry about that!

By clicking "Submit", you agree to processing of personal data according to thePrivacy Policy.

Trusted by

Back to Top