18.10. Network Troubleshooting

18.10.1. Performance Issues

Causes of slow performance:

  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.

18.10.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 18.7, “utcapture Output” describes the information that utcapture outputs.

Table 18.7. 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.

18.10.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

18.10.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.