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.

How do I export dasboard reports in Citrix ADM?

To export the report of any dashboard in Citrix ADM, click the Export icon on the top right side of this page. On the Export page, you can do one of the following:

  1. Select Export Now tab. To view and save the report in PDF, JPEG, PNG, or CSV format. The report downloads to your system.

  2. Select Schedule Report tab to schedule generating and exporting of the report at regular intervals. Specify the report generation recurrence settings and create an email profile to which the report is exported.

    1. Recurrence - Select Daily, Weekly, or Monthly from the drop-down list box.

      Note

      • If you select Weekly recurrence, ensure that you select the weekdays on which you want the report to be scheduled.
      • If you select Monthly recurrence, ensure that you enter all the days that you want the report to be scheduled separated by commas.
    2. Recurrence time - Enter the time as Hour: Minute in 24-hour format.

    3. Email - Select the check box and then select the profile from the drop-down list box, or click Add to create an email profile.

    4. Slack - Select the check box and then select the profile from the drop-down list box, or click Add to create an email profile.

    Click Enable Schedule to schedule your report and then, click OK. By clicking the Enable Schedule checkbox, you can generate the selected reports.