Installing Citrix ADM agent on premises

The agent works as an intermediary between the Citrix Application Delivery Management (Citrix ADM) and the discovered instances in the data center. This document describes how to install the Citrix ADM agent on your hypervisor in your on-premises network environment.

Before you begin installing the agent, make sure that you have the required virtual computing resources that the hypervisor must provide for each agent.

Component Requirement
RAM 8 GB. Note: Citrix recommends that you use 32 GB for better performance.
Virtual CPU 4. Note: Citrix recommends that you use 8 CPUs for better performance.
Storage space 120 GB
Virtual Network Interfaces 1
Throughput 1 Gbps

Note

For all information related to ports and other requirements, see System Requirements.

To install the Citrix ADM agent:

  1. Download the agent image as instructed in Getting Started.
  2. Import the agent image file to your hypervisor, and from the Console tab configure the initial network configuration options as shown in the following example.

    localized image

    Note

    Make sure that you configure your DNS to allow Internet access to your Citrix ADM agent.

  3. Enter the following command to change the password of the Citrix ADM agent after provisioning and follow the directions:

    change_agent_system_password.py
    

    Note

    Ensure that the password is not empty. You cannot use the “nsroot” user name to log on to the virtual machine before or after changing the password. But, you can still use the “nsrecover” user name with the new password.

  4. If there is no prompt to enter the Service URL, navigate to /mps in the Citrix ADM agent and then run the following script:

    ./deployment_type.py
    
  5. Enter the Service URL and the Activation Code that you saved when you had downloaded the agent image. The agent uses the Service URL to locate the service and the activation code to register with the service.

    localized image

  6. After agent registration is successful, the agent restarts to complete the installation process.

After the agent has restarted, access the Citrix ADM GUI and on the Set Up Agent page, under Discovered Agents, verify the status of the agent.

Installing Citrix ADM agent on premises