FAQs 编辑

This section provides the FAQ on the following Citrix Application Delivery Management (Citrix ADM) features. Click a feature name in the following table to view the list of FAQs for that feature.

Analytics

Is it required to enable EUEM virtual channel on Citrix Gateway instances deployed in single-hop mode?

EUEM virtual channel data is part of HDX Insight data that the Citrix ADM receives from Gateway instances. EUEM virtual channel provides the data about ICA RTT. If the EUEM virtual channel is not enabled, the remaining HDX Insight data are still displayed on Citrix ADM.

The EUEM virtual channel is a default service running on Citrix Virtual Desktop applications (VDA). If it is not running, start the “Citrix End User Experience Monitoring” process in VDA services.

How do I enable Citrix ADM to monitor web-application and virtual-desktop traffic?

1. Navigate to Infrastructure > Instances > Citrix ADC, and select the Citrix ADC instance on which you want to enable analytics.

2. From the Select Action list, select Configure Analytics.

3. In the Configure Analytics page, select all the virtual servers on which you want to enable analytics, and click Enable AppFlow. For more details, see How to Enable Analytics on Instances.

Note

For Citrix ADC instances of 11.0 release, 65.30 build and later, there is no option on Citrix ADM to enable Security Insight explicitly. Ensure that you configure the AppFlow parameters on the Citrix ADC instances, so that Citrix ADM starts receiving the Security Insight traffic along with the Web Insight traffic. For more information on how to set the AppFlow parameters on Citrix ADC instances, see To set the AppFlow parameters by using the configuration utility.

After I add the Citrix ADC instances, does Citrix ADM automatically start collecting analytical information?

No. Enable analytics on the virtual servers hosted in Citrix ADC instances that are managed by Citrix ADM. For more details, see How to Enable Analytics on Instances.

Is it required to access the individual Citrix ADC appliance for enabling analytics?

No. All configurations are done from the Citrix ADM user interface, which lists the virtual servers hosted on the specific Citrix ADC instance. For more details, see How to Enable Analytics on Instances.

What are the types of virtual servers that can be listed on a Citrix ADC instance to enable analytics?

Currently, the Citrix ADM user interface lists the following virtual servers for enabling analytics:

• Load balancing virtual server
• Content switching virtual server
• VPN virtual server
• Cache redirection virtual server

How do I attach an extra disk to the Citrix ADM?

To attach an extra disk to Citrix ADM:

1. Shut down the Citrix ADM virtual machine.

2. In the hypervisor, attach an extra disk of the required disk size to the Citrix ADM virtual machine.

   For example, Let us consider that you want to increase the disk space to 200 GB, in a Citrix ADM virtual machine of 120 GB. In this scenario, you must attach a disk space of 200 GB instead of 80 GB. Newly attached 200 GB of disk space will be used to store Database data, Citrix ADM log files. The existing 120 GB disk space is used to store core files, Operating System Log files, and so on.

3. Start the Citrix ADM virtual machine.

What do you mean by collectors are not configured on Citrix ADC instances?

A collector receives AppFlow records generated by the Citrix ADC appliance.

Citrix ADM receives Security Insight and Web Insight traffic from the Citrix ADC instances when the AppFlow feature is enabled. When you enable the AppFlow feature on a Citrix ADC instance, you must specify at least one collector to which the AppFlow records are sent. If the collectors are not configured on the Citrix ADC instances, Citrix ADM does not receive the traffic from the instances.

For example, five Citrix ADC instances are added to Citrix ADM. If collectors are not specified for two instances, no traffic flows to Citrix ADM. Self-service diagnostics detects the issue and displays the issue as “Collectors are not configured on 2 instances.”

For more information about how to configure the AppFlow Feature, see Configuring the AppFlow Feature.

What does enabling client-side measurements do?

With client side measurements enabled, ADM captures load time and render time metrics for HTML pages, through HTML injection. Using these metrics, admins can identify L7 latency issues.

Authentication

What is load balancing of authentication requests?

The authentication-server load balancing feature enables Citrix ADM to load balance the authentication requests that are directed to the external authentication servers. Load balancing the authentication servers ensures that the authentication load is split across multiple authentication servers and thus avoid an authentication server from being overloaded. You can create an authentication service to connect with and get user information from your existing external authentication server using the authentication protocols like LDAP, RADIUS, or TACACS.

Why do we need to cascade external authentication servers?

Cascaded external authentication servers provide uninterrupted authentication processing, allowing access to legitimate users if an authentication server fails. There is no limitation on which types of authentication servers you can cascade. You can have all RADIUS servers, or all LDAP servers, or a combination of RADIUS and LDAP servers.

How many external authentication servers can I cascade?

You can cascade up to 32 external authentication servers in Citrix ADM.

Do I have an alternative when external authentication fails?

There can be a situation when external authentication completely fails, even when you have cascaded several servers. For example, the external servers can become unreachable, or a new user’s credentials might not have been entered in any of the external authentication servers. To prevent locking users out in such a situation, you can enable fallback local authentication. For more details, see Fallback Local Authentication.

What is fallback local authentication?

Fallback local authentication is an option to authenticate your users locally when external authentication fails. If external authentication fails, Citrix ADM accesses the local user database to authenticate your users.

In Citrix ADM, navigate to Settings > Authentication > Authentication Configuration. On this page, you can add multiple external authentication servers in a cascade, and you can select the Enable fallback local authentication option.

What is an extraction of external user groups?

If you have added external servers for authenticating the users, you can import (extract) existing user groups into Citrix ADM. You have to import user groups once and provide a group permission to a user group rather than importing individual users and giving them individual permissions. You do not have to recreate the users on Citrix ADM.

Why do we need to assign group permissions?

When you are using the load balancing feature of Citrix ADC, you can integrate Citrix ADM with external authentication servers, and import user group information from the authentication servers. Log in to Citrix ADM and manually create the same group information in Citrix ADM and assign permission to those groups. The user and user group permission is managed in Citrix ADM and not in the external server. The users have different role-based access permissions on the external servers. Configure the same permissions for the users in Citrix ADM also. Instead of configuring permissions individually for each user, you can configure a group-level permission so that the user-group members can access specific services on the load balanced virtual servers. The typical permissions that you can assign are permissions to manage Citrix ADC instances, Citrix SDX instances, virtual servers, and so on, so that the users of that group can manage only those instances or virtual servers. You can later edit the permissions given to the users at the group level. You can even remove one or more user groups; other group users still function on Citrix ADM.

Configuration Management

Can I perform configuration across multiple Citrix ADC instances simultaneously using Citrix ADM?

Yes, you can use configuration jobs to perform configuration across multiple Citrix ADC instances.

What are configuration jobs on Citrix ADM?

A job is a set of configuration commands that you can create and run on one or more managed instances. You can create jobs to make configuration changes across instances, replicate configurations on multiple instances on your network, and record-and-play configuration tasks using the Citrix ADM GUI. You can also convert the recorded tasks into CLI commands.

You can use the Configuration Jobs feature of Citrix ADM to create a configuration job, send email notifications, and check execution logs of the jobs created.

Can I schedule jobs using built-in templates in Citrix ADM?

Yes! You can schedule a job by using the built-in template option. A job is a set of configuration commands that you can run on one or more managed instances. For example, you can use the built-in template option to schedule a job to configure syslog servers. You can choose to run the job immediately, or schedule the job to be run later.

You can save the configuration of a job that was previously created, and run the job again after modifying the commands, the parameters, the configuration source, and targeted instances. This is useful when the same set of commands has to be run on a different instance, or when the job encounters an error and stops further execution.

Certificate Management

Does the deletion of SSL certificates from Citrix ADM lead to the deletion of certificates from Citrix ADC instances?

No

Deployment

What is the default user name and password?

• After you complete the initial network configuration, you can log on to Citrix ADM from the hypervisor or SSH console, using the default user name and password (nsrecover/nsroot).

• The default user name and password to log on from the GUI is nsroot/nsroot.

How to change the default password?

To change the password:

1. In Citrix ADM, navigate to Settings > User Administration > Users.

   The Users page is displayed.

2. Select the user name nsroot and click Edit.

   

   The Configure System User page is displayed.

3. Select Change Password and create a password of your choice.

   

4. Click OK.

   You can now use the new password to log on from the GUI, hypervisor, or SSH console.

   Note

   You cannot modify the user name.

How to reset the password?

You can see this documentation to reset the password.

In a HA pair, if the password is changed in the primary node and if the Break HA pair option is selected later, what is the behavior?

You can log on to both standalone nodes using your new password.

If two standalone servers have different passwords, what is the impact in deploying these two servers in HA pair?

It is recommended to have default password for both servers when you deploy two standalone servers to HA pair.

The HA configuration is complete, but the primary node GUI is not accessible. What can be the reason?

It takes a few minutes for the configuration to take effect. You can try accessing again after a few minutes.

The HA configuration is complete, but the floating IP address GUI is not accessible. What can be the reason?

After the HA configuration, you need to first access the primary node GUI and complete the deployment. For more information, see Deploy the primary and secondary node as a high availability pair. After the deployment is complete, the server reboots and gets ready for high availability deployment. You can then access the floating IP address GUI.

What DB is supported in Citrix ADM standalone and Citrix ADM HA?

Both Citrix ADM standalone and Citrix ADM HA support PostgreSQL.

What is the potential data loss to the secondary node?

The secondary node listens to the heartbeat messages that the primary node sends through the Citrix ADM database. If the secondary node does not receive the heartbeats for more than 180 seconds, then the secondary node performs an SSH-based check on the primary node. If the heartbeat and SSH-based check fail, the primary node is considered to be down.

In this scenario, the secondary node takes over as the primary node and the 180 seconds timeframe can be considered as the possible data loss to the secondary node.

What happens if the primary node is down?

The secondary node takes over and becomes the primary node.

How to reinstall the failed node?

It is recommended to install a fresh VM build. To reinstall:

1. Break the HA pair. Navigate to Settings > Deployment

   The deployment page is displayed. Click Break HA

2. Delete the failed node from the hypervisor.

3. Import the .XVA image file to the hypervisor.

4. From the Console tab, configure Citrix ADM with the initial network configurations. For more information, see Register and deploy the first server (primary node) and Register and deploy the second server (secondary node).

5. Redeploy the HA pair.

Does Citrix ADM support SAN Storage?

Citrix recommends you to host the Citrix ADM VHD on a local storage. When hosted on storage devices in a SAN, Citrix ADM might not work as expected. So, ADM deployment on SAN is not supported.

Does Citrix ADM support an extra disk?

Yes. A new installation of Citrix ADM HA pair allocates 120 GB of storage by default. For more than 120 GB storage, you can add one extra disk for a maximum of 3 TB storage. Adding more than one extra disk is not supported.

After disabling the HA pair, what happens to the floating IP address configured?

The floating IP address is no longer accessible and you need to redeploy the high availability pair.

Can I give a different floating IP address while redeploy?

Yes. You can configure a new floating IP address.

Why is secondary node GUI not accessible?

Secondary node is only a read-replica server and acts as a primary node only if the primary node is down for any reason. Citrix recommends accessing either the primary node GUI or the floating IP address GUI.

If the primary node is down for a long duration, can the configurations still be done using the floating IP address GUI?

Yes. You can still continue to do configurations and the configurations get saved in the secondary node. After the primary node is back, all the configurations are synchronized.

If there is a necessity to change the primary node IP address or secondary node IP address or floating IP address in the future (for example, changing it to IPv6), what are the recommended solutions to follow?

Changing the IP addresses in HA pair is not supported without breaking the HA pair.

To update the primary node or the secondary node IP address:

1. Break the HA pair. Navigate to Settings > Deployment.

   The Deployment page is displayed. Click Break HA

   1. Log on to the primary node using an SSH client or from the hypervisor.

   2. Use nsrecover as the user name and enter the password that you have set.

   3. Enter networkconfig. Perform the procedure from step 3 available at Register and deploy the first server (primary node).

      During the initial network configuration, you can provide a different IP address.

   4. Perform the same procedure for secondary node and continue with the procedure from step 3 available at Register and deploy the second server (secondary node).

To update the floating IP address:

1. Navigate to Settings > Deployment.

   The Deployment page is displayed.

   1. Click HA Settings.

   2. Click Configure Floating IP Address for High Availability Mode.

   3. Enter the floating IP address and click OK.

Does ADM support AMD processors?

AMD processor is supported in:

• Citrix ADM 13.1 build 4.43 or later.

• Citrix ADM agent 13.1 build 17.42 or later.

Deployment (Disaster Recovery)

How frequent does the replication happens between the primary site and disaster recovery site?

The replication between the primary site and the disaster recovery site is real time.

After initiating the backup script at the DR site, does the DR site becomes the temporary primary site, until the primary site is recovered and fully operational?

No. The DR site will now become the primary site. To revert the HA pair as the primary site, see Revert configurations to the original primary site

If the Break HA pair option is selected, both nodes operate as a standalone server. Since DR support is not applicable for standalone server, what happens to the DR site if Break HA pair is selected?

If you select Break HA pair option, the replication between the primary site and the DR site is terminated. You need to reconfigure the DR site as part of redeploying HA pair.

Event Management

How can I keep track of all the events that have been generated on my managed Citrix ADC instances using Citrix ADM?

As a network administrator, you can view details such as configuration changes, log on conditions, hardware failures, threshold violations, and entity state changes on your Citrix ADC instances, along with events and their severity on specific instances. You can use the Citrix ADM events dashboard to view reports generated for critical event severity details on all your Citrix ADC instances.

What are event rules?

Using Citrix ADM, you can configure rules to monitor specific events. Event Rules make it easier to monitor many events generated across your Citrix ADM infrastructure.

You can filter a set of events by configuring rules with specific conditions and assigning actions to the rules. When the events generated meet the filter criteria in the rule, the action associated with the rule is run.

The conditions for which you can create filters are severity, Citrix ADC instances, category, and failure objects. The actions you can assign to the events are sending an email notification, forwarding SNMP traps from managed Citrix ADC instances to the Citrix ADM, and sending an SMS notification.

Instance Management

What happens if an ADC instance cannot connect to ADM after bandwidth allocation when you use Citrix ADC pooled capacity licensing?

If the heartbeat between the ADC instance and ADM fails, the instance enters a grace period of 30 days. And after communication is re-established, pooled capacity licensing starts working. When in grace period, ADC functions are not affected. After 30 days of grace period, the ADC instance initiates warm restart and is unlicensed.

What are data centers in Citrix ADM?

A Citrix ADM data center is a logical grouping of the Citrix ADC instances in a specific geographical location. Each server can monitor and manage several Citrix ADC instances within a data center. You can use the Citrix ADM server to manage data such as syslog, application traffic flow, and SNMP traps from the managed instances. For more details on configuring data centers, see How to Configure Data Centers for Geomaps in Citrix ADM.

What are the different Citrix Appliances that are supported by Citrix ADM?

Instances are the Citrix appliances or virtual appliances that you want to discover, manage, and monitor from Citrix ADM. You must add these instances to the Citrix ADM server. You can add the following Citrix appliances and virtual appliances to Citrix ADM:

• Citrix MPX
• Citrix VPX
• Citrix SDX
• Citrix CPX
• Citrix Gateway
• Citrix SD-WAN WO
• Citrix SD-WAN PE

You can add instances either while setting up the Citrix ADM server for the first time or later.

What is an instance profile?

An instance profile is used by Citrix ADM to access an instance.

An instance profile contains the user name and password for access to one or more instances. A default profile is available for each instance type. For example, the ns-root-profile is the default profile for Citrix ADC instances. It contains the default Citrix ADC administrator credentials. When you change the credentials required for access to instances, you can define custom instance profiles for those instances.

Can we add unlimited SD-WAN instances in Citrix ADM? Can Citrix ADM handle all scalar and vector counters for SD-WAN?

Currently, there is no license limit on SD-WAN instances that can be added to Citrix ADM. Citrix ADM has a set of built-in reports that internally polls both scalar and vector counters.

Can I rediscover multiple Citrix VPX instances in Citrix ADM?

Yes, you can rediscover multiple Citrix VPX instances in Citrix ADM to learn the latest states and configurations of the instances.

Navigate to Infrastructure > Instances > Citrix ADC > VPX, select the instances that you want to rediscover, and in the Action list click Rediscover. For more information, see How to Rediscover Multiple VPX Instances.

Can Citrix ADM be installed on Citrix SDX?

No

Can I add a Citrix ADC instance on the ADM software by using a public IP address?

Yes, you can by using network address translation (NAT).

• For adding a single instance: use NAT IP of the public IP address of the ADC instance.

• For adding an ADC HA pair: add the NAT IP addresses of the HA pair in this format:

  <NAT public IP of the primary instance>#<NAT public IP of the secondary instance>

• For adding an ADC cluster: add all the NAT public IP addresses of all the instances in the cluster, each separated by a comma, and add the NAT IP of the CLUSTER IP inside parentheses or round brackets. An example format: NAT1, NAT2, NAT3,(NATIP of CLUSTERIP).

For more information, see the following topics:

• Add instances to Citrix ADM

• Configuring Network Address Translation

How to register a disaster recovery node if the DR node credentials are changed?

Reset the disaster recovery (DR) node credentials to nsrecover/nsroot using the following command:

./mps/change_freebsd_password.sh <username> <password>
<!--NeedCopy-->