Sentinel HASP HL USB Licensing Dongle Fails After Upgrading from ESXi 6.0 to ESXi 6.5

Symptom

Post upgrade from ESXi 6.0 U3 to ESXI 6.5 U2, Sentinel HL USB licensing dongles were no longer visable to the guest VM nor within vSphere Web Client.

Background

In ESXi 6.5, the legacy USB drivers, including xhci, ehci-hcd, usb-uhci, usb, usb-storage, and so on, are replaced with a single USB driver named vmkusb. The vmkusb driver is loaded by default and it is applied to all the USB Host Controllers (XHCI/EHCI/UHCI/OHCI), USB Keyboard, Mass Storage, and supported USB NIC devices connected to the host. This driver does have some compatibility and stability issues when compared to the legacy drivers.

Resolution

Perform the following steps on each host in the cluster:

  1. Place the host in Maintenance Mode
  2. Enable SSH
  3. Connect via SSH and login as root.
  4. Enter the following command: esxcli system module set -m=vmkusb -e=FALSE
  5. Reboot the host
  6. Exit from Maintenance Mode

Rinse and repeat on each host. Technically you only need to perform these steps on hosts with USB devices connected but as a best practice, I always recommend having identical configurations on all hosts within a cluster.

 

 

 

2 thoughts on “Sentinel HASP HL USB Licensing Dongle Fails After Upgrading from ESXi 6.0 to ESXi 6.5”

  1. Hi Jacob,
    we would like to copy or have a reference to your post in our knowledge base as it could be useful for our software using USB license dongles. I just wanted to know if you would agree with this before posting it.
    Thanks and best regards
    Bruno

Leave a Reply

Your email address will not be published. Required fields are marked *