Product Documentation

FAQs

How many agents do I need to install?

The number of agents depends on the number of managed instances in a data center and the total throughput. Citrix recommends that you install at least one agent for every data center.

How can I install multiple agents?

You can install only one agent when you log on to the service for the first time. To add multiple agents, first complete the initial setup, and then navigate to Settings > Setup Agents.

How do I get a new activation code if I lose it?

If you are onboarding for the first time, access the service GUI, navigate to the Set Up Agent screen, and click Generate Activation Code.

While trying to install a second agent, to generate a new activation code, navigate to Networks > Agents > Generate Activation Code.

How do I log on to the agent VM? What are the default credentials?

If your agent is installed on a hypervisor or Microsoft Azure cloud, the default credentials to log on to the Citrix ADM service agent is nsrecover/nsroot. This logs you on to the shell prompt of the agent.

If your agent is installed on AWS, the default credentials to log on to the Citrix ADM service agent is nsrecover/<instance \id>.

What are the resource requirements to install an agent on a hyprvisor on premises?

Minimum requirements: 8 GB RAM, 4 Virtual CPU, 120 GB Storage, 1 Virtual Network Interfaces, 1 Gbps Throughput

Recommended requirements: 32 GB RAM, 8 Virtual CPU, 500 GB Storage, 1 Virtual Network Interfaces, 1 Gbps Throughput

Can I install two agents in an HA setup?

No, you cannot.  

Should I assign an additional disk to agent while provisioning?

No, you do not have to add an additional disk. The agent is used only as an intermediary between the Citrix ADM and the instances in your enterprise data center or on the cloud. It does not store inventory or analytics data that would require an additional disk.

Can I reuse my activation code with multiple agents?

No, you cannot.

How do I re-run network settings if I have entered an incorrect value?

Access the agent console on your hypervisor, log on to the shell prompt by using the credentials nsrecover/nsroot, and then run the command “networkconfig”.

What do I do if my agent registration fails?

  • Make sure your agent has access to the Internet (configure DNS).
  • Make sure you have copied the activation code correctly.
  • Make sure you have entered the service URL correctly.
  • Make sure you have the required ports open.

Registration is successful, but how do I know if the agent is running fine?

After the agent is successfully registered, access Citrix ADM and navigate to the Set Up Agent screen. You can see the discovered agent on the screen. If the agent is running fine, the status is indicated by a green icon. If it is not running, the state is indicated by a red icon.

How can I connect agents to Citrix ADM using a proxy server?

You can now connect agents to Citrix ADM service using a proxy server. Using this enhancement, agents forward all their data to the proxy server, which then sends the data to the Citrix ADM through the internet.

To forward data using the proxy server, type the proxy server details on the agent using the following script: proxy_input.py, and follow the instructions provided by the script to enter more information. The agent fetches this information while it connects to Citrix ADM using the proxy server.

You can authenticate your proxy server by providing your user name and password information. When the agent sends the data, the proxy server authenticates the user credentials before forwarding it to Citrix ADM.

Note:

Proxy server supports only basic authentication.

I do not see my Analytics Reports

You have to enable Insight on your virtual servers to be able to see the Analytics Reports. For details, see Enabling Analytics.

Which versions of Citrix ADC instances are supported in Citrix ADM?

For management and monitoring features, Citrix ADC instances running 10.5 and later are supported. Some features are only supported on certain Citrix ADC versions. For details, see System Requirements.