Install Citrix ADM agent on premises

July 18, 2019

Contributed by: C

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:

Download the agent image as instructed in Getting Started.
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.

Note

Make sure that you configure your DNS to allow Internet access to your Citrix ADM agent.
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.
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
```
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.
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.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Install Citrix ADM agent on premises

July 18, 2019

Contributed by: C

Install Citrix ADM agent on premises

Install Citrix ADM agent on premises

In this article