Agent Installation - Knowledge base

Change Name/IP/Port Number of Desktop Central Server


You want to update a new DNS name/ip and port number of the Desktop Central Server in the agents (Client Computers) that are already installed


You have moved your Desktop Central Server to another machine which has a different name/ip and port number.


You can change the following in the Desktop Central Agents that have been already installed:

  • The Name or the IP Address of the Desktop Central Server
  • The HTTP and HTTPS ports that are used by the Desktop Central Agents to communicate with the Server
  • The mode of the communication as HTTP or HTTPS

To change the values,

  1. For Windows - Download the configureDCAgentServerCommunication.txt and rename it to configureDCAgentServerCommunication.vbs.
    For Mac - Download the configureDCAgentServerCommunication_mac.txt and rename it to
    For Linux - Download the configureDCAgentServerCommunication_linux.txt and rename it to
  2. Copy the script to the client computers where the agent is installed.
  3. Open a command prompt/terminal.
  4. To execute the script for Mac & Linux agents, add executable permission by running the command 'chmod +x'
  5. Execute the command given below:

    For Windows - cscript configureDCAgentServerCommunication.vbs <DCServerName> <DCServer IP Address> <DCServer HTTP Port> <DCServer HTTPS Port> <DCServerAgent Comm Protocol>

    Example: cscript configureDCAgentServerCommunication.vbs 8020 8383 http

    For Mac - sudo ./ <DCServerName> <DCServer IP Address> <DCServer HTTP Port> <DCServer HTTPS Port> <DCServerAgent Comm Protocol>

    Example: sudo ./ 8020 8383 http

    For Linux - sudo ./ <server_name> <server_ip> <http_port> <'http'/'https'> 

    Example - sudo ./ 8020 http

Applies to: Server Migration, Agent-Server Communication

Keywords: Update Server Details, Agent-Server Communication

Unable to resolve this issue?
If you feel this KB article is incomplete or does not contain the information required to help you resolve your issue, upload the required logs, fill up and submit the form given below. Include details of the issue along with your correct e-mail ID and phone number. Our support team will contact you shortly and give you priority assistance and a resolution for the issue you are facing.

 * Mandatory Fields

Other KB articles 24/5 Support

Support will be available 24hrs a day and five days a week (Monday through Friday), excluding USA & India public holidays.

Tel : +1-888-720-9500
Email :

Speak to us

  • Join the Desktop Central Community, to get instant answers for your queries, register with our Forum.
  • Look out for the latest happenings in Desktop Management, follow our Tweets on Twitter.
  • Get to know the latest updates and Best Practices in Desktop Management through our Blog.