Troubleshooting TCAM settings on NAM Probe

How can I check whether the NAM Probe receives data from properly configured TCAM?

  1. Set the map.trace=true property in /usr/adlex/config/rtm.config and restart the rtmgate service. The rtmgate.log will now show the mappings sent by TCAM. Set the map.trace property back to false to prevent log flooding.
  2. Check the gatestatsdata files in /var/spool/adlex/rtm. If you can find a Citrix server IP addresses in them, TCAM is sending the data.

For a lower level debugging you can use a standard tool called tcpdump .

  1. Log on to the NAM Probe as root and, in the console command line, type:

    tcpdump host IP_ADDRESS and port PORT_NUMBER and udp -I IFC -n -nn

    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 NAM Probe receives the data, IFC is the name of the communication network interface. For example, tcpdumphost 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

    If you are not sure what Ethernet interface is used for communication purposes, type:

    grep -^net.comm- /usr/adlex/config/rtm.config

    to see the communication NIC system name.

  2. 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 NAM Probe and the UDP port number on which the NAM Probe 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.

How can I check whether the NAM Probe 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 NAM Console. For more information, see Citrix XenApp or XenDesktop Monitoring.

How can I check whether the NAM Probe sees the session mapping data?

Log on to the NAM Probe as root.

Launch the NAM Probe console program by typing in rcon at the command prompt.

Type show clientmap at the rcon command prompt to display Citrix users,


Display the user session mapping information by typing in show sessionclientmap at the rcon command prompt. The command displays session mappings only and does not refer to performance data.

The command show clientmap should be used prior to show sessionclientmap command. The latter may mislead the user by yielding empty output, because session mappings are removed from the NAM Probe memory just after they are processed by the NAM Probe.


The mappings are also removed from the NAM Probe memory after exceeding a specified timeout, called the lease time. The lease time parameter is configured in the NAM Console, in the NAM Probe 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 NAM Probe. how can I check the data is generated on the NAM Probe?

Log on to the NAM Probe as root and type at the command prompt the following command:

ls -lt /var/spool/adlex/rtm/ctxdata* | head -n 20

This command lists 20 of the most recent files containing the Citrix performance data, generated by the NAM Probe. Note the file creation date and time of each file and compare it with the system time by means of thedate command. If the listed files are not recently generated, the NAM Probe may be improperly configured or TCAM is not configured to send the performance data to this NAM Probe. For more information, see TCAM Administration via Command Line Interface.