5.7. Network Troubleshooting

5.7.1. Network Load
5.7.2. The utcapture Utility
5.7.3. utcapture Examples
5.7.4. The utquery Command

This section describes some potential reasons for slow network performance and the tools to help troubleshoot network problems.

To help you tune the network performance in a Sun Ray environment, see Chapter 21, Performance Tuning.

5.7.1. Network Load

In situations where network load or packet loss is too high, network cables or switch equipment might be defective in very rare cases.

  1. Verify that network connections are 100F.

  2. Use utcapture to assess network latency and packet loss.

As latency and packet loss increase, performance suffers.

5.7.2. The utcapture Utility

The utcapture utility connects to the Sun Ray Authentication Manager and reports packet loss statistics and round-trip latency timings for each client connected to this server. See the utcapture man page to learn more about this command.

Table 5.4, “utcapture Output” describes the information that utcapture outputs.

Table 5.4. utcapture Output

Data Element

Description

TERMINALID

The MAC address of the client.

TIMESTAMP

The time the loss occurred in year-month-day-hour-minute-second format, for example, 20041229112512.

TOTAL PACKET

Total number of packets sent from the server to the client.

TOTAL LOSS

Total number of packets reported as lost by the client.

BYTES SENT

Total number of bytes sent from the server to the client.

PERCENT LOSS

Percentage of packets lost between the current and previous polling interval.

LATENCY

Time in milliseconds for a round trip from the client to the server.


5.7.3. utcapture Examples

The following command captures data every 15 seconds from the Authentication Manager running on the local host and then writes it to stdout if any change occurs in packet loss for a client.

% utcapture -h |

The following command captures data every 15 seconds from the Authentication Manager running on the local host and then writes it to stdout.

% utcapture -r > raw.out

The following command captures data every 15 seconds from the Authentication Manager running on server5118.eng and then writes the output to stdout if any change occurs in packet loss for the client with ID 080020a893cb or 080020b34231.

% utcapture -s sunray_server5118.eng 080020a893cb 080020b34231

The following command processes the raw data from the input file raw-out.txt and then writes to stdout the data only for those clients that had packet loss.

% utcapture -i raw-out.txt

5.7.4. The utquery Command

The utquery command interrogates a client and displays the client's initialization parameters with the IP addresses of the DHCP services that supplied those parameters. This command can be helpful in determining whether a client was able to obtain the parameters that were expected in a particular deployment and in determining specific DHCP servers that contributed to the clients initialization. See the utquery man page to learn more about this command.