Sun Microsystems, Inc.  Sun System Handbook - ISO 3.4 June 2011 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-1003601.1
Update Date:2011-03-16
Keywords:

Solution Type  Technical Instruction Sure

Solution  1003601.1 :   Sun Ray[TM] ultra-thin clients and Sun Ray Server Software 3.0: Connecting USB devices  


Related Items
  • Sun Ray Hardware
  •  
  • Sun Ray Hardware
  •  
  • Sun Ray Hardware
  •  
  • Sun Ray Hardware
  •  
Related Categories
  • GCS>Sun Microsystems>Desktops>Desktop Virtualization>Sun Ray Hardware
  •  

PreviouslyPublishedAs
205088


Description
The purpose of this document, is to describe how to properly connect and disconnect USB devices, on Sun Ray[TM] ultra-thin clients. Users can now use USB "Thumb drives", external USB hard drives, zip disks, scanners and digital cameras, with Sun Ray ultra-thin clients, provided that the server is running Sun Ray Server Software 3 or later.


Steps to Follow
The Sun Ray ultra-thin clients have four USB ports on the back of the device (locations vary depending on the model - just follow the keyboard or mouse connections). Two of these ports are used for the keyboard and mouse connection, but the other two are available for external peripherals.
Below, are some details(on mounting and unmounting) for plugging in a USB storage device.

Mounting/connecting USB devices:

First, this is different to the way a USB device would work on a desktop or
laptop computer(that is: the "Disks" menu is not used, to mount the sda#
device). Also, there is no Desktop icon, for the device(s) attached.

To get started, plug a USB device into one of the two empty USB slots on the
back of the Sun Ray ultra-thin client.

The examples below, show two different USB drives, and a MS(Memory Stick)
reader.

The path to the drive will be as follows:

 /tmp/SUNWut/mnt/<loginid>/disk# -> <usbdevice>
--------------------------^^^^^-----^^^^^^^^^

The "<usbdevice>" mount point name will depend on the internal/formatted name of
the device used. The disk# will depend on how many devices are plugged in. The
device can then be accessed, either, by opening a filemanager window, or from a
command-line, by changing directory to this path:

 /tmp/SUNWut/mnt/<your_loginid>

Once there, look for a disk# link that points to the device. Following, is an
example:

% cd /tmp/SUNWut/mnt/dougc
% ls -l
lrwxrwxrwx   1 root   staff      30 Jan 10 10:27 disk1 -> /tmp/SUNWut/mnt/dougc/dsc4mb/
lrwxrwxrwx   1 root   root       31 Jan 10 10:28 disk2 -> /tmp/SUNWut/mnt/dougc/usbdisk/
drwxrwxrwx   1 dougc  staff   16384 Dec 31  1969 dsc4mb/
drwxrwxrwx   1 dougc  staff   16384 Dec 31  1969 usbdisk/

To list the mounted device(s), use the /usr/bin/df command, or to see just the
USB mounted devices in your session, run the following command:

 % /opt/SUNWut/bin/utdiskadm -l
 Device        Partition       Mount Path
------        ---------       ----------
disk1         disk1s0         /tmp/SUNWut/mnt/dougc/dsc4mb
disk1         disk1s2
disk2         disk2s0         /tmp/SUNWut/mnt/dougc/usbdisk
disk2         disk2s2

In this example, there are two devices plugged in: the MS reader(with a 4MB
memory stick), and a 256MB "Thumb drive". Once the device is mounted, you can
copy files to or from the device.

Unmounting/disconnecting USB devices:

To remove the device, first run the following command to prepare the
device for removal:

% /opt/SUNWut/bin/utdiskadm -r disk1
disk1 is ready for unplugging

This unmounts the device so that it can be safely unplugged, then just remove
the device from the port.

Troubleshooting

If you can't see the device(after using the commands listed above), then check
the following files :

 /var/opt/SUNWut/log  (directory)
           utmountd.log
utstoraged.log
messages

If you have already plugged in a device, look at the last few entries in these
logs/files. In particular, grep/search for your UID(user ID), as it is part of
the entry in the utmountd.log and utstoraged.log. Also, run the following
command on the files, while a device is plugged in, to see what messages are
generated:

    "tail -f <filename>" 

The following examples, are from both of the ut*.log files, while
attaching/detaching the same USB device(an Apple iPod Shuffle in this case).

Example from utmountd.log:

 2005.03.09 13:09:49.571070 CST [device uid=##### xid=5 ctlmin=1 \
devroot=/tmp/SUNWut/units/IEEE802.080020b5cd90 media=disk]
2005.03.09 13:09:50.250205 CST [detach uid=##### xid=5 ctlmin=1 \
devroot=/tmp/SUNWut/units/IEEE802.080020b5cd90 media=disk]

Example from utstoraged.log

 2005.03.09 13:09:49.555375 CST capacity: ctl=1, nblocks=0f4400, bsize=0200
2005.03.09 13:09:49.557490 CST servicing  /tmp/SUNWut/units/IEEE802.080020b5cd90/devices/usb@1/hub@1/AppleiPod____________,
lun=0, ctlmin=1, uid=#####, xid=5
2005.03.09 13:09:50.249654 CST service END lun=0, ctlmin=1, uid=#####, xid=5

NOTE: The '#####' (changed in the example) would be the actual UID of the
user who plugged in the device.



Product
Sun Ray 150 Ultra-Thin Client
Sun Ray 1g Ultra-Thin Client
Sun Ray 1 Ultra-Thin Client
Sun Ray 100 Ultra-Thin Client

Sun Ray, sunray, usb, flash, thumb, SUNWut
Previously Published As
80336

Change History
Date: 2006-01-23
User Name: 71396
Action: Update Canceled
Comment: *** Restored Published Content *** from ssh audit update
Version: 0
Date: 2006-01-23
User Name: 71396
Action: Update Started
Comment: Updating per SSH Audit
Version: 0

Attachments
This solution has no attachment
  Copyright © 2011 Sun Microsystems, Inc.  All rights reserved.
 Feedback