Free Trial

How to Relocate or Rename a Distribution Server?

This document provides steps required to rename a distribution server and move a distribution server from one computer to another without deleting the remote office. You may want to move a distribution server from one location to another in the following scenarios:

  • Moving the server from a test environment to a production environment
  • Installing the server in a computer with a higher configuration
  • Moving the distribution server to another location because of low disk space in the current drive

Steps

To move a distribution server from one location to another, follow the steps given below:

Move Distribution Server from One Drive to Another in the Same Computer

  1. Navigate to Agent tab > Remote Officesadd computers
  2. Select the remote office, then in the Download Agent column, click on Distribution Server Icon to download the distribution server.add computers
  3. After ensuring that the download is completed, uninstall the existing distribution server from Control Panel > Add/Remove Programs.
  4. Now, install the distribution server on the same computer. When prompted for the location, specify the new location where you want to move the Distribution server.
  5. Stop the 'ManageEngine DesktopCentral-Distribution Server (Endpoint Central below 11.2.2309.01) or ManageEngine UEMS-Distribution Server (Endpoint Central 11.2.2309.01 and above)' service from services.msc.
  6. Copy only the "replication" folder from the previous location and paste it in the new drive location.
    add computers Example: If the old Distribution server is located in the C: drive, you can find the replication folder at <Program Files>\DesktopCentral_DistributionServer\replication (for Endpoint Central versions below 11.2.2309.01) or <Program Files>\UEMS_DistributionServer\replication (for Endpoint Central 11.2.2309.01 and above). You need to copy this folder and paste it into the same location on the new drive.
    Note: If you skip this step, the Distribution Server will have to download all the existing data again from the Endpoint Central Server.
  7. Start the 'ManageEngine DesktopCentral-Distribution Server (Endpoint Central below 11.2.2309.01) or ManageEngine UEMS-Distribution Server (Endpoint Central 11.2.2309.01 and above)' service.

You have successfully moved the Distribution server from one drive to another in the same computer.

Move Distribution Server from One Computer to Another

  1. Login to the Web console
  2. Navigate to Agent tab  > Remote Offices tab
  3. Click the Modify option under the Action column for the respective remote officeadd computers
  4. Update the computer details where the new Distribution Server is installedDetails of Distribution Server
  5. If your build number is below 11.4.2512.01, Uninstall the distribution server from the old computer by navigating to Control Panel > Add/Remove Programs. If your build number is above 11.4.2512.01, The Distribution Server will get uninstalled automatically once it is changed in the server.

  6. Now click on the Modified Remote Office's Distribution Server Icon to download the distribution server.add computers
  7. Install the Distribution Server on the new computer
  8. Stop the 'ManageEngine DesktopCentral-Distribution Server (Endpoint Central below 11.2.2309.01) or ManageEngine UEMS-Distribution Server (Endpoint Central 11.2.2309.01 and above)' service from services.msc
  9. Copy only the "replication" folder from the old computer and paste it into the same location on the new computer.
    add computers Example: If the old Distribution server is located in the C: drive, you can find the replication folder at <Program Files>\DesktopCentral_DistributionServer\replication (for Endpoint Central versions below 11.2.2309.01) or <Program Files>\UEMS_DistributionServer\replication (for Endpoint Central 11.2.2309.01 and above). You need to copy this folder and paste it into the same location on the new computer.
  10. If OS Deployment components are installed in the remote office, check for the OSDBootableMediaFiles folder located at C:\Program Files (x86)\ZOHOCORP\OSDBootableMediaFiles. If it exists, copy this folder and paste it into the same location on the new computer. If the folder does not exist, you can skip this step.add computers
  11. Start the 'ManageEngine DesktopCentral-Distribution Server (Endpoint Central below 11.2.2309.01) or ManageEngine UEMS-Distribution Server (Endpoint Central 11.2.2309.01 and above)' service in the new computer.

You have successfully moved the distribution server from one computer to another. When agents attempt to contact the old distribution server and find it unreachable, they will automatically reach out to the Endpoint Central Server, which will provide the new distribution server details.

Note: If the old distribution server machine is damaged or unrecoverable, you can follow the steps listed under Move Distribution Server from One Computer to Another.

Rename the Distribution Server Machine

Renaming the distribution server is applicable for build version above 11.4.2512.01

  1. Update the new name in the Distribution Server machine.
  2. Restart the Distribution Server machine.
  3. The new name will automatically update in the server.

Note: If the new name is changed in the server first instead of in the Distribution Server machine, then it will automatically uninstall the Distribution Server in the next replication cycle.

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.
Back to Top