# Migrating Endpoint Central server

## Migrating to a New Server Machine with Updated Network Configurations

This guide outlines the steps required to migrate your Central Server to a new machine with a different FQDN, IP address, or machine name. By following these instructions, you will ensure that your agents continue to communicate with the new server seamlessly.

## Table of Contents

- [Pre-requisites Before Server Migration](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#pre-requisites)
- [Steps to Perform on the Current Central Server Setup](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#old-server-setup)
- [Steps to Perform on the New Central Server Setup](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#new-server-setup)
- [Post-Migration Steps](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#post-migration)
- [Steps to Reconfigure the Secure Gateway Server](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#secure-gateway-setup)
- [Frequently Asked Questions](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#faq)
- [Support and Assistance](https://www.manageengine.com/products/desktop-central/server-migration-change-ip.html#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](https://www.manageengine.com/products/desktop-central/desktop-central-lan-architecture.html#dcports).
- If your data size is large, follow the [cleanup document](https://www.manageengine.com/products/desktop-central/removing-unwanted-files-from-dc-how-to.html) to remove unnecessary files from the Central Server directory.
- Verify that there is enough space available in the new directory for the Central Server installation.
- After migrating to a new FQDN/IP address, verify the NAT settings. If they have changed, re-enrollment of mobile devices may be required.
- Update the FQDN/IP details on the SAN/CN list of the SSL certificate or use a new SSL certificate with updated details.
- For OS deployment post-migration, create new bootable media or modify existing media and update the DHCP Server configuration.

## Steps to Perform on the Current Central Server Setup

1. In the web console, navigate to **Admin** > **Server Settings** > **Central Server Migration.**
2. ![Central Server Migration option in Admin settings](https://www.manageengine.com/products/desktop-central/help/images/retain-ip-img-1.png)
3. Select the migration method: **Change in FQDN and IP Address**. Enter the network details of the new server.
4. ![Selecting FQDN/IP method for Central Server migration](https://www.manageengine.com/products/desktop-central/images/srvr-mgr-2.png)
5. Download the **Server Migration Guide** and follow the **'Steps to Ensure'** before initiating migration.
6. Run the following command in Command Prompt (as administrator) on your old installation:

```
server-migration.bat enable
```

Example:

```
C:\Program Files\UEMS_Central Server\bin\server-migration.bat enable
```

7. ![Executing Central Server migration script](https://www.manageengine.com/products/desktop-central/images/migrate-dc-server-enable.png)
8. Zip the entire Central Server installation directory (e.g., `UEMS_Central Server`) and transfer `UEMS_CentralServer.zip` to the new computer.
9. ![Zipping and transferring the Central Server installation directory](https://www.manageengine.com/products/desktop-central/images/dc-migration-zip.png)

## 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](https://www.manageengine.com/products/desktop-central/images/retain-ip-img-del.png)
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](https://www.manageengine.com/products/desktop-central/images/migrate-dc-server-bat.png)
6. After migration, start the Central Server service. Agents will contact the new server during their next refresh cycle.

## Post-Migration Steps

**Verify Successful Migration:**

- Confirm that only the nginX component is running on the old server. If you try accessing the old server console (e.g., `https://oldservername:8383`), it should redirect to the new server.
- Ensure the new server has started successfully.

**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](https://www.manageengine.com/products/desktop-central/help/images/server-migration-change.png)

## Steps to Reconfigure the Secure Gateway Server

If you have a secure gateway server, update the new server machine name and IP address in the secure gateway server settings. [Learn more](https://www.manageengine.com/products/desktop-central/reconfigure-secure-gateway-server.html).

## Frequently Asked Questions

- **When should I remove the old setup?** Keep the old setup until all agents have migrated to the new server. Once all agents are communicating with the new server, you can uninstall the old server.
- **Do I need to reapply the server license?** No, the license remains valid after migration.

## Support and Assistance

|  |  |
|---|---|
| ![Migration Assistance Service](https://www.manageengine.com/products/desktop-central/images/migration-icon.png) | ## Need Assistance? Try Our Professional Service<br><br>We offer a professional service to migrate your Server and Data for **$295**. [Register here](https://www.manageengine.com/products/desktop-central/migration-assistance.html) if you’re interested. |