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-75-1010832.1
Update Date:2011-03-17
Keywords:

Solution Type  Troubleshooting Sure

Solution  1010832.1 :   Troubleshooting Mouse problems on a Sun Ray[TM] Appliance  


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

PreviouslyPublishedAs
214962


Description
The mouse on a Sun Ray[TM] appliance doesn't work correctly.


Steps to Follow
Hardware Checks

1. Hardware Checks

1.1 Check the mouse hardware

1.1.1 If you have a ball mouse, check if the ball is still inside.

1.1.2 If your mouse is wireless, check the batteries. Perhaps the batteries are not inserted or the batteries are flat.

1.1.3 If your mouse is connected by a cable, check that the mouse is plugged into the Sun Ray desktop unit (DTU).

1.1.4 Connect the mouse in question to a workstation or at a PC. Does it work there?

1.1.5. Sun Ray is supposed to be able to handle any mouse-like device that complies with the USB 1.1 HID "Boot Mode" Pointer specification. If your third party mouse does not support this protocol properly, it might not work correctly on Sun Ray.

1.2 Check other related hardware

1.2.1 Are there some other devices close by that might be jamming the mouse's traffic? Unplug all other USB devices from the DTU and only plug in the mouse.

1.2.2 Try a different mouse on the DTU. Does that mouse work correctly? If no, maybe the DTU has a problem and not the mouse.

2. Software Checks

2.1 Check the Sun Ray Server update patch

A mouse is handled almost entirely by the firmware in the Sun Ray unit. Therefore it's generally a good idea to use the latest Sun Ray Server update patch which contains also the latest firmware for the DTUs. Read the patch description for any mouse related problems:

  120879-XX   Sun Ray Core Services version 3.1 Patch Update (Solaris on Sparc)
120880-XX   Sun Ray Core Services version 3.1 Patch Update (Solaris on x86)
120881-XX   Sun Ray Core Services version 3.1 Patch Update (Linux/x86)
119836-XX   Sun Ray Server 3.0 Update Patch (Linux/x86)
118979-XX   Sun Ray Server 3.0 Update Patch (Solaris on sparc)
114880-XX   Sun Ray Server 2.0 Update Patch
111891-XX   Sun Ray Server 1.3 Update Patch
110666-XX   Sun Ray Server 1.2 Update Patch
109127-XX   Sun Ray Server 1.1 Update Patch
108303-XX   Sun Ray Server 1.0 Update Patch

2.2 Check the firmware on the DTU

Make sure that the DTU is running the firmware which comes with the latest Sun Ray Server Update Patch, use the utdesktop command for that task. See also

  • the utdesktop(1M) manual page
  • #26428 Sun Ray[TM]: How to find the MAC address of the Sun Ray[TM] appliance currently logged into
  • #79838 Sun Ray[TM]: Troubleshooting firmware download

3. Check the application

3.1 Has the problem something to do with your application rather than with the mouse itself? Try several different applications and check if the same problem
appears with all of them.

3.2 If you have problems with a Motif Application read

  • #71048 Right mouse button fails with Motif applications.

3.3 If you test with Java applications, make sure that you are using at least a J2SE 1.4 compatible JRE which is the first release that has mouse wheel support.

Abbreviations:
HID - Human Interface Device
USB - Universal Serial Bus



Product
Sun Ray 150 Ultra-Thin Client
Sun Ray 1g Ultra-Thin Client
Sun Ray 100 Ultra-Thin Client
Sun Ray Server Software 1.1
Sun Ray Server Software 1.2
Sun Ray Server Software 1.3
Sun Ray Server Software 2.0
Sun Ray Server Software 3.0
Sun Ray Server Software 3.1
Sun Ray 1 Ultra-Thin Client
Sun Ray 170 Ultra-Thin Client

Internal Comments
For Internal Use Only

If you have a third party mouse which does still not work properly (even after you have checked each step in the troubleshooting guide), perform the following check (internal only):


4. Check the USB 1.1 HID protocol compatibility

The Sun Ray firmware (SRSS <= 3.0) keeps a whitelist of non-standard conforming mouse devices (see also 1.1.5). In this case run utusbdevs while the mouse is attached, and note the MAC address of the Sun Ray appliance where the mouse was connected. The utusbdevs script is not shipped with the SRSS, you can get it from http://rsd-software.sfbay/twiki/pub/Products/SunRayServerSoftwareReferences/utusbdevs


SRSS 3.1+ has implemented a better mechanism to determine if USB mouse supports scroll wheel. See also CR 6195751.


Fixed bugs related to mouse problems:

6218260 Scroll wheel on Genius NetScroll and PowerScroll mice is not recognised

6213562 Scroll wheel on Logitech M-BJ58 mouse is not recognised
6226501 Scroll wheel on Logitech M-BT85 Click! optical wheel mice is not recognised
6228580 Scroll wheel on Fujitsu PID==0x1001 mouse is not recognised
6212211 SunRay The position of the mouse pointer is random on xinerama displays
6190711 Mouse cursor is lost in Xinerma when video is played in enlarged realplayer
5092486 Mouse pointer tracking is not stable under stress in multihead
5100314 elecom mouse prod=1390.24 scroll wheel fails
5096807 elecom mouse scroll wheel issue
5096276 contour mouse scroll wheel fails on SRSS 3.0 beta
6183230 m800 mouse does not work on SRSS 3.0
5053302 Mouse freezes in multihead operation
5069497 logitech MouseMan Plus does not work
5079645 more scroll wheel mouse regressions
5049272 logitech first mouse scroll wheel doesn't work
5057692 microsoft intellimouse 2.0 wireless tilt scroll wheel combo mouse does not work
5010353 Crossing screens in degenerate mode can cause the mouse to hang
5013617 mouse freezes when dragging windows across multiheads
4817187 Minor mathematical manipulation mitigates multihead mouse mispositioning
4874498 Sun/Fujitsu mouse rev(05c/06c) may fail to work in SunRay due to bad packets

mouse, mice, input, device, freezing, scroll, wheel, cursor, pointer, Xinerama, multihead
Previously Published As
81062
Change History
Date: 2006-01-20
User Name: 7058
Action: Update Canceled
Comment: *** Restored Published Content *** SSH AUDIT
Product_uuid
2a1f4cc0-0a18-11d6-99d7-dc92ef4207a7|Sun Ray 150 Ultra-Thin Client
17b4fb54-0ee3-11d7-91b0-934b10cdd83f|Sun Ray 1g Ultra-Thin Client

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