How can I check whether the AMD receives data from properly configured TCAM?
Use the AMD's
show mapstats global and
rcon, establish a connection to the AMD and type:
show mapstats global
Analyze the results of the command:
backendMappingCountcounters will show the number of username mappings received by the AMD.
frontendMappingCountwill show a number of login mappings (ICA analyzer mappings) and the
backendMappingCountwill show a number of session username mappings.
maxMappingDelayshow the delay with which TCAM sends the mappings.
A value other than zero (
0) presented in the
emptyMappingscounter, suggests that TCAM is sending mappings without the username.
show mapstats byagentcommand to obtain more specific view.
show mapstats byagentcommand will display the
backendMappingCounton a per TCAM basis. Each TCAM will be identified by the IP address of the Citrix server that it is installed on.
Additional commands are available for further diagnostics. For more information, see Table 1. Commands available for session mapping diagnostics.
For a lower level debugging you can use a standard tool called
Log on to the AMD as root and, in the console command line, type:
where IP_ADDRESS means the IP address of the Citrix server with TCAM installed and running, PORT_NUMBER is the number of UDP port on which the AMD receives the data, IFC is the name of the communication network interface. For example,
host 10.1.2.3 and port 514 and udp -I eth0 -n -nn
will dump all the TCP traffic received on the NIC eth0 on port 514 from the IP address 10.1.2.3.
If you are not sure what Ethernet interface is used for communication purposes, type:
to see the communication NIC system name.
Analyze the captured traffic.
The format of the received data should look like:
TIME SRC_IP.SRC_PORT > DST_IP.DST_PORT: ...
where SRC_IP should be the IP address of the Citrix server on which TCAM is running while DST_IP and DST_PORT should be the IP address of the AMD and the UDP port number on which the AMD receives the Citrix performance data.
Note that TCAM sends the performance data every 60 seconds while the session mapping data whenever a new mapping occurs. It means that new entry should appear on the console screen at least every minute.
Table 1. Commands available for session mapping diagnostics.
The following table presents statistics available for session mapping diagnostics:
Number of front-end mappings received by the AMD.
Number of back-end mappings received by the AMD.
Total number of sessions, which have not received a mapping.
Total number of mappings with an empty username the AMD has received.
Number of mappings which have arrived, but have not been used (for whatever reason).
Averaged difference between the time of mapping arrival and session beginning.
for mappings which arrive before a session starts the delay (less than zero) is not taken into account
Largest observed mapping arrival delay.
Averaged delay for discarded mappings (mappings which arrived after the acceptable wait time).
Largest observed discarded mapping arrival delay.
Per-agent (TCAM) statistics
Number of sessions associated with a particular agent, which have not received a mapping.
Number of mappings with an empty username the AMD has received from a particular agent.
How can I check whether the AMD has been configured to detect and monitor Citrix-based applications?
Properly installed and configured TCAM is not sufficient to monitor the Citrix-based applications. You also have to define a software service based on the ICA (Citrix) analyzer using the RUM Console. For more information, see Citrix XenApp or XenDesktop Monitoring.
How can I check whether AMD sees the session mapping data?
Log on to AMD as root.
Launch the AMD console program by typing in
rconat the command prompt.
rconcommand prompt to display Citrix users,
Display the user session mapping information by typing in
rconcommand prompt. The command displays session mappings only and does not refer to performance data.
should be used prior to
command. The latter may mislead the user by yielding empty output, because session mappings are removed from the AMD memory just after they are processed by the AMD.
The mappings are also removed from the AMD memory after exceeding a specified timeout, called the lease time. The lease time parameter is configured in the RUM Console, in the AMD Configuration window, at Advanced ► User-IP mapping ► General: Session Client Name Mapping Lease Time and its default value is 60 seconds.
The empty list may also indicate that there is a problem with receiving session mappings data from TCAM. It may also mean that no new sessions have been established recently.
The report server does not seem to receive Citrix performance data from the AMD. How can I check the data is generated on the AMD?
Log on to AMD as root and type at the command prompt the following command:
head -n 20
This command lists 20 of the most recent files containing the Citrix performance data, generated by the AMD. Note the file creation date and time of each file and compare it with the system time by means of the
date command. If the listed files are not recently generated, the AMD may be improperly configured or TCAM is not configured to send the performance data to this AMD. For more information, see TCAM Administration via Command Line Interface.
- No labels