Citrix Application Delivery Management service

Install an agent on-premises

September 7, 2022

Contributed by:

R R S

The agent works as an intermediary between the Citrix ADM and the discovered instances in the data center.

Before you begin installing the agent, ensure that you have the required virtual computing resources that the hypervisor must provide for each agent. For more information, see Agent installation requirements and Lightweight agent for pooled licensing.

Note

For all information related to ports and other requirements, see Supported Ports.

To install the Citrix ADM agent:

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

Note

Ensure that you configure your DNS to allow Internet access to your Citrix ADM agent.
After completing the initial network configuration, save the configuration settings. When prompted, log on using the default (nsrecover/nsroot) credentials.

If you want to change the configured network settings on the agent, type the networkconfig command and follow the prompts in the CLI.
If there is no prompt to enter the Service URL, navigate to /mps in the Citrix ADM agent and then run any one of the following scripts:
```
deployment_type.py

```
```
register_agent_cloud.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 navigate to Infrastructure > Instances > Agents to verify the status of the agent. After the agent is configured, you must change the password.

Navigate to Infrastructure > Instances > Agents
Select the agent and from the Select Action list, click Change Password.
Enter the current password (nsroot), then specify a new password, and click OK to change the password.

The password must:
- Be at least six characters in length
- Have at least one special character
- Have at least one upper case character
- Have at least one lower case character
- Have at least one numeric character

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.

Was this helpful

Install an agent on-premises

September 7, 2022

Contributed by:

R R S

September 7, 2022

Contributed by:

R R S

Install an agent on-premises

In this article