utcapture is the tool to display the packet loss statistics from Sun Ray [TM] Server 1.3 and later. It is located at: /opt/SUNWut/sbin/utcapture

utcapture - Capture packet information from Authentication Manager.

Usage:

utcapture [-h] [-r] [-s server] [desktopID ...] [-i filename]

-h	    Help for using the command. 
-r   	    Dump captured data to stdout in raw format. By default, data 
	    is dumped only when there is a packet loss. With this option 
	    the captured data will always be dumped to stdout. 
-s   	    Server Name of server on which the Auth Mgr is running. Default 
	    is localhost. 
DesktopID   Collects data for the specified desktop unit only. DTU's are 
	    specified by their MAC addresses separated by a space. By default, 
	    data for all currently active desktops are collected. 
-i filename File contains previously collected raw data and prints to stdout 
	    those DTUs which had packet loss.
      

utcapture connects to the Auth Mgr and gets data about the packets sent and packets dropped between the Sun Ray Server and the DTU. It writes it to stdout in the following format:

# TERMINALID, TIMESTAMP, TOTAL PACKET, TOTAL LOSS, BYTES SENT, PERCENT LOSS

utcapture data fields:

TERMINALID The MAC address of the appliance
TIMESTAMP Time of the packet loss (in year-month-day-hour-minute-second)
TOTAL PACKET The total number of packets sent from the server to the appliance (every polling interval)
TOTAL LOSS Total number of packets reported lost by the appliance (every polling interval)
BYTES SENT Total number of bytes sent from the server to the appliance
PERCENT LOSS Percentage of packets lost (every polling interval)      

Note - The polling interval is hard coded at 15 seconds.

Examples:

% utcapture

#TERMINALID TIMESTAMP TOTAL PACKET TOTAL LOSS BYTES SENT PERCENT LOSS
080020b054c1 200102222 34151 51421823 386337 475900846 0.135
080020b097c2 200102222 34151 11040485 63039 925309384 0.065
080020b53cab 200102222 34151 1012682 4233 962514192 5.775      

% utcapture -s test1 080020b054c1 080020b097c2

#TERMINALID TIMESTAMP TOTAL PACKET TOTAL LOSS BYTES SENT PERCENT LOSS
080020b054c1 200102222 34151 51421823 386337 475900846 0.135
080020b097c2 200102222 34151 11040485 63039 925309384 0.065      

Criteria: Packet loss rate must be less than 0.1%.

OPERANDS: The following operands are supported:

desktopID (DTU id) Collect the data for the specified desktops only. Desktops are specified by their MAC Addresses separated by a space. By default, data for all currently active desktops is collected.

example% utcapture -r This will capture data from the Auth Mgr running on localhost every 15 seconds and then write it to stdout in raw mode.

example% utcapture This will capture data from the Auth Mgr running on localhost every 15 seconds and then write it to stdout if there is any change in packet loss for a DTU.

example% utcapture -s netraj118.eng 080020a893cb 080020b34231 This will capture data from the Auth Mgr running on netraj118.eng after every 15 seconds and then write to stdout if there is any change in packet loss for DTU with ID 080020a893cb or 080020b34231.

SUBMITTER: Chandu Krishnagiri

Email: Krishnagiri.Chandrasekhar@sun.com

PRODUCT AREA: Bundled Network

PRODUCT: Sun Ray

SUNOS RELEASE: Solaris 2.X