Copyright 2006 Hewlett-Packard Development Company, L.P. Hewlett-Packard and the Hewlett-Packard logo are trademarks of Hewlett-Packard Development Company, L.P/ in the U.S. and/or other countries. SOFTPAQ NUMBER: PART NUMBER: FILE NAME: hpmouse-README.txt TITLE: iLO High-Performance Mouse feature for Linux VERSION: 1.0 LANGUAGE: English CATEGORY: Systems Management DIVISIONS: Systems PRODUCTS AFFECTED: All Proliant system with hp's embedded ILO2 management processor. OPERATING SYSTEM: Red Hat Enterprise Linux 4 (x86 & AMD64/EM64T), SUSE LINUX Enterprise Server 9 (x86 & AMD64/EM64T) SUSE LINUX Enterprise Server 10 (x86 & AMD64/EM64T) 2.6.X Linux kernels. SYSTEM CONFIGURATION: Xfree86 or xorg-x11 installed and configured PREREQUISITE: N/A EFFECTIVE DATE: Nov 1, 2006 ELECTRONIC DISTRIBUTION ALLOWED: Yes DESCRIPTION: This README discusses the high-performance mouse feature of Integrated Lights-Out (iLO2) for Linux installations. DOCUMENTATION: Summary: The iLO High-Performance mouse feature was first introduced in iLO1 (Version 1.75) and continues in all subsequent releases. Additionally, iLO2 has always supported the High-Performance mouse feature. High-Performance Mouse provides accurate mouse control when managing various systems remotely. Background: In iLO1, the Remote Console KVM solution fully emulated PS/2 style keyboard and mouse in order to provide the remote KVM solution. A difficulty in emulating a mouse in this manner is that individual Operating systems (OS) can adjust the mouse parameters; acceleration and accuracy. The PS/2 style mouse represents movement in relative coordinates. That is, the mouse indicates a change in positive or negative (+/-) units in the X axis, and (+/-) units in the Y axis. Confusion can arrive when the configuration of the client machine differs substantially from the remote machine. The client configuration parameters actually configure the mouse hardware. When the remote console session then takes place to different host machines, expecting the mouse to be configured differently, mouse synchronization issues occur. Additionally, when the screen size and mouse pixel size from a client to a host system differ substantially more synchronization issues can occur. LINUX TIP Without the hpmouse activated: For the X interface of Linux, it is recommended to ensure Xwindows mouse acceleration is turned to a minimum. The 'xset m 1' command will perform this for you. This will greatly improve the mouse tracking in iLO or iLO2 when connecting via Remote Console to a Linux server. Once the Xwindows mouse acceleration is turned off the Remote mouse and the local mouse can be synced up by pressing the key and moving the mouse so that both mice line up. They mice will stay in sync as long as you do not leave the Remote Console screen. This operation can be preformed again if the mice become out of sync. Recommendations: In order to minimize the inaccuracies of the iLO Remote Console mouse, there are various 'Best Practices' or tips; - minimize acceleration parameters on both client and host machines - enable high-performance mouse if supported High-Performance Mouse: The high-performance mouse feature alters the emulation mode of the Remote Console KVM solution. Instead of emulating a PS/2 mouse, iLO emulates a USB mouse. The benefit of emulating a USB mouse, is that the USB HID specification allows for the specification of ABSOLUTE coordinates. Instead of the relative +/-x and +/- y coordinates indicating a change the ABSOLUTE coordinates allows the mouse to 'snap-to' the exact location pointed to by the mouse. Using these absolute coordinates removes the error in synchronization that can take place due to the different acceleration and granularity configuration. The downside of using the USB mouse in ABSOLUTE coordinates mode is that the OS needs to support this type of standard USB HID device. - For Windows, the necessary support is available in Microsoft Windows 2003 or Windows 2000 Service Pack 3 or later. - For Linux (XWindows), the support for this type of device is not pre-installed. HP has identified an open-source solution that provides the necessary support for USB HID devices (mice) that are operating in absolute coordinate mode. The code is based upon that available at http://opensource.idealcorp.com/evdev/ HP has made some additions to the code in order to support more than the single left-mouse click button the original code supported. Additionally, some scripts have been modified to correctly identify the HP iLO USB mouse device and create the necessary input-device link. This package contains the source, scripts, 32-bit and 64-bit versions, and necessary instructions. Installation: If you are NOT installing hprsm, BE SURE to enable the high-performance mouse option in the iLO web or XML interface. If the hprsm package is loaded this will be done automatically. - Manual Mode: 1) rpm -ihv hpmouse-xxx-yy.rpm 2) cd /opt/hp/hpmouse 3) sh hpmouse activate - Automatic Mode: 1) run export HPMOUSESILENT=YES or set HPMOUSESILENT in /etc/hpmouserc 2) rpm -ihv hpmouse-xxx-yy.rpm The steps in the Manual mode will be competed in the rpm %post scriptlet. Using either mode requires a restart of X. This can easily be done by 'killall X' or from Xwindows. In "init 5" X will be respawned automatically and will load the installed X drivers. What configuration is done during installation: 1) support tools are copies to /usr/bin. 2) The hpmouse X driver is copied to the correct directory so that X can load it. 3) The X configuration file is edited to add the inputdevice hpmouse. Each entry made is surrounded by #HP BEGIN/END so that the add entry can be identified easily. TROUBLESHOOTING: NOTICE: It is a good to make sure you can telnet or ssh into the system incase something goes wrong. What to look for: The Xwindows hpmouse driver has a helper function that keeps the device node/dev/hpmouse available in the event that the ILO Remote mouse goes away and comes back on a different /dev/input/event[X] device node. You can make sure it isi by running ->ps -ef|grep hpmouse You should see an entry like this: root 20622 1 0 Nov08 tty7 00:00:00 ( -p /dev/hpmouse This is only if you have hprsm installed and configured and you have the ILO High Performance Mouse set to Automatic. Make sure that the cmasm2d agent as notified ILO that this system supports the High Performance Mouse. You can do this by running ->ps -ef|grep cmasm2d You should see an entry like this: root 5283 1 0 Nov08 ? 00:00:01 cmastdeqd -p 30 -m ENABLE The "-m ENABLE" means that cmasm2d will notify ILO that hpmouse is supported. Also make sure the xorg.conf or xf86Config files are configured. You should see entries like this: Section "ServerLayout" Identifier "Layout[all]" InputDevice "Keyboard[0]" "CoreKeyboard" InputDevice "Mouse[1]" "CorePointer" Option "Clone" "off" Option "Xinerama" "off" Screen "Screen[0]" #BEGIN HP ILO X MOUSE DRIVER InputDevice "hpmouse" "SendCoreEvents" #END HP ILO X MOUSE DRIVER EndSection #BEGIN HP ILO X MOUSE DRIVER Section "InputDevice" Identifier "hpmouse" Driver "hpmouse" Option "Device" "/dev/hpmouse" Option "Helper" "/opt/hp/hpmouse/hpmouse-helper" Option "SendCoreEvents" "true" Option "MinX" "0" Option "MaxX" "3000" Option "MinY" "0" Option "MaxY" "3000" EndSection #END HP ILO X MOUSE DRIVER FYI: The orignial X configuration file is kept in /opt/hp/hpmouse directory incase things go really wrong. In most cases if you copy the original back to /etc/X11/ and restart X, it will at least get you back where you started. SLES 9 sometimes recognizes the ilo high performance mouse as a joy stick. In this case the ILO remote mouse will be unresponsive. To fix this problem you will need to disable the Joy Stick(js) driver from loading and/or remove the mouse input device entry in /etc/X11/XF86Config that uses the /dev/input/js[0-9] device. Don't forget to restart X after making the changes. Copyright 2006 Hewlett-Packard Development Company, L.P. Hewlett-Packard and the Hewlett-Packard logo are trademarks of Hewlett-Packard Development Company, L.P/ in the U.S. and/or other countries.