Agent Installation - Knowledge base

Changing Desktop Central Server's Name/IP/Port Details in Agent

Problem

Agents not communicating with the server after migration.

Cause

The new server details like FQDN, IP, Port numbers are not available with the agent.

Resolution

Changing the following details in the Desktop Central Agents:

  • 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, either a GPO or a cscript can be used. This page explains about creating a GPO to change the server contact details in agents.

GPO can only be used in a Windows environment. To change details in Mac and Linux machines or to execute a cscript (for Windows), follow the steps in this page.

Steps:

  1. To get the updated server details, go to the Desktop Central console, navigate to Reports-->Query Reports-->New Query Report and execute the following query:
    SELECT
    SERVER_MAC_NAME,SERVER_MAC_IPADDR,SERVER_FQDN,SERVER_PORT,HTTPS_PORT FROM DCServerInfo
  2. Desktop Central: Query Report to obtain server details
  3. The report will have the following details:
    <DCServerName> <DCServer IP Address> <DCServer HTTP port> <DCServer HTTPS Port>
    Copy the details and have it saved.
  4. Desktop Central: Query Report of obtained server details
  5. Also make a note of the mode of communication (HTTP or HTTPS) from: Admin-->Security Settings
  6. Copy the configureDCAgentServerCommunication.txt file, save it as configureDCAgentServerCommunication.vbs.
  7. Download GPO_AgentServerComm.txt, rename it as GPO_AgentServerComm.ps1 and save it in the same location where configDCAgentServerCommunication.vbs is saved.
  8. Run Windows PowerShell in administrative mode and navigate to the location where the script is present and execute the script GPO_AgentServerComm.ps1 with arguments as mentioned below:
    GPO_AgentServerComm.ps1 configDCAgentServerCommunication.vbs
    <DCServerName> <DCServer IP Address> <DCServer HTTP port> <DCServer HTTPS Port> <DCServerAgent Comm Protocol>
    Example:
    GPO_AgentServerComm.ps1 configDCAgentServerCommunication.vbs
    DC-COMP.DC.COM 192.192.192.192 8020 8383 https
  9. In the Power shell window, Enter the name of the GPO to be created and press Enter.
  10. Now, enter the Distinguished Name of the OU or Domain to which the policy is being linked.
  11. Follow the steps mentioned below to get the Distinguished name:
    • Open Active directory users and computers in Administrative tools.
    • Right click on the OU / Domain that needs tobe linked.
    • Select Properties-->Attribute Editor-->distinguishedName-->View.
    • Copy and paste the value of distinguishedName in the PowerShell window and hit Enter
    • Desktop Central: Finding domain and distinguished OU name AD
  12. If you want to 'Add' another Domain, press y and add the required domain. Press n once all the required domains have been added. This will automatically initiate the application of the GPO.

Applies to: Server Migration, Agent-Server Communication

Keywords: Update Server Details, Agent-Server Communication