book
Article ID: 309748
calendar_today
Updated On:
Issue/Introduction
This article assists you in troubleshooting a situation where your mouse or keyboard stop functioning during or after an ESX/ESXi host installation or upgrade.
Symptoms:
-
The mouse or keyboard stops functioning when attempting to install or upgrade ESX/ESXi Server system.
-
Unable to complete ESX/ESXi host installation because the mouse no longer moves.
-
The keyboard and mouse were functioning but when the media test completes, they no longer work.
-
The upgrade completed but after rebooting the mouse and keyboard no longer work.
Environment
VMware vSphere ESXi 5.1
VMware ESX Server 3.5.x
VMware vSphere ESXi 5.5
VMware ESX 4.1.x
VMware ESXi 3.5.x Embedded
VMware ESXi 4.0.x Installable
VMware ESXi 4.1.x Installable
VMware ESXi 3.5.x Installable
VMware ESX 4.0.x
VMware ESXi 4.0.x Embedded
VMware ESXi 4.1.x Embedded
VMware vSphere ESXi 5.0
VMware ESX Server 2.5.x
VMware ESX Server 3.0.x
Resolution
To troubleshoot a mouse or keyboard that is no longer working after an ESX/ESXi host installation or upgrade:
-
Verify that you are using a USB keyboard or mouse. If you are not using a USB keyboard or mouse, check your keyboard and mouse on a different server to confirm the issue is not hardware related. If you are using a USB keyboard or mouse, ensure that Legacy support is enabled if your BIOS supports it.
-
-
Check if the USB drivers are in your modules.conf
file if you have completed the installation or upgrade but your USB devices are not working:
- SSH into the service console as root. For more information, see Opening a command or shell prompt (1003892). For ESXi, see Using Tech Support Mode in ESXi 4.1 and ESXi 5.0 (1017910).
-
Edit /etc/modules.conf
and add the following two lines to the end of the file:
alias usb-controller usb-uhci
alias usb-controller1 ehci-hcd
Note: Alternatively, you may need to load alias usb-controller usb-ohci
depending on your hardware.
-
Reboot the server.
-
Occasionally, all USB devices, including the keyboard and mouse, stop functioning during ESX/ESXi Server installation. This may occur after the initial selection in the graphical or text mode installation, that is, after pressing Enter or typing esx text
on the initial installation menu.
To workaround the issue, specify noapic
at the initial installation menu:
-
For the graphical installation, rather than just pressing Enter, type esx noapic
and press Enter.
-
For the text installation, type esx noapic text
and press Enter.
-
Verify that your mouse pointer does not fail to move when installing ESX Server 3.0.1 on a PowerEdge 6950 Server. When installing ESX Server 3.0.1 on a PowerEdge 6950 with either a directly-connected mouse or console re-direction through the Dell Remote Access Card (DRAC) 5, the mouse pointer fails to move. This issue occurs because of a USB scheduler limitation in the 2.4 Linux kernel used by the VMware ESX Server installer. To workaround the issue, perform a text-based install, or use the Tab key to move between fields in the graphical install.
Note: To perform a text-based install type esx text
and press Enter at the install mode selection screen.
-
Verify that your keyboard and mouse are functioning during or after installing ESX Server. Look at the BIOS setting on your server to make sure USB support is
On with BIOS support or
Legacy mode is enabled. Note: Normally, pressing a button during system startup enters the BIOS. Follow the on-screen instructions as the key to press depends on the hardware manufacturer and model.
- Dell, Intel, HP, Compaq, VMware, Phoenix BIOS, SONY - Press the F2 key.
-
AMIBIOS, Award BIOS, most generic systems - Press the Delete key.
-
Compaq (prior to HP acquisition in 2002) - Press the F10 key.
-
Toshiba: Press CTRL+ESC, ESC, or F1 on newer models.
-
IBM, AMD BIOS - Press the F1 key.
-
For other models, see the startup screen for the BIOS setup key.
The following issues have been observed during the installation process when the USB controller BIOS option is set to On without BIOS Support, specifically on PowerEdge 6950s:
These issues appear because the GRUB loader does not support USB. To use the keyboard to select the boot image, set the USB option in the BIOS to On with BIOS support.
Note: In some cases, a wireless keyboard still does not function even after this BIOS option is changed. In this case, try changing to a wired USB keyboard.
-
Determine if you are using a non-US keyboard, while trying to install or upgrade. Choose the Custom installation method. This option allows you to choose your keyboard type during the installation. Choosing the Default installation option is not supported.
-
Determine if you are completing the installation or upgrade using an Avocent Keyboard Video and Mouse Switch (KVM). The problem may be due to the USB speeds supported by your KVM. This problem is resolved by upgrading the firmware on the Avocent switch. For more information, see
http://www.avocent.com/web/en.nsf/Content/ProductUpgradesLanding.
Note:
This link was valid as of June 20, 2012. If you find the link to be broken, provide feedback on the article and a VMware employee will update the article as necessary. When you have upgraded the firmware, change the USB speed of the IQ module from 2.0 to 1.1:
-
Go to Unit View>Appliance>Appliance Settings>Port>IQ Modules.
-
Select the check box of the IQ module you want to change.
-
Click Set USB 1.1 Speed.
Alternatively, after upgrading the switch firmware:
-
Upgrade to DSView 3.4
-
Click DSR in the Units view.
-
Change the USB speed.
-
If you are using Avocent KVMs and the installation completed but the mouse and keyboard are no longer working after a reboot, check if you have multiple KVM switches cascaded. Cascaded Avocent KVM switches prevent USB keyboard and mouse drivers from loading. Un-cascade all Avocent KVM switches.