Identifying the Physical PCIe Slot Location for FC HBA (vmhba) Devices in ESXi

Products

• VMware vSphere ESXi

Issue/Introduction

This article provides instructions on how to map a Fibre Channel (FC) host bus adapter (e.g., vmhba3) to its physical PCIe slot location on a host server.
This is essential for hardware troubleshooting, replacing failed adapters, or verifying cabling.

Environment

VMware ESXi 8

Resolution

Method 1: Using the ESXi Command Line (Recommended)

This method is the most reliable as it correlates the logical device name, the PCI address, and the hardware slot description.

1. Find the PCI Address of the vmhba:

Run the following command to list all storage adapters and their associated PCI addresses:

Bash

esxcli storage core adapter list

Output Example:

vmhba3 qla2xxx link-n/a fc.20000024ff5b1234:21000024ff5b1234 (0000:04:00.0) QLogic Corp ...

Note the address in parentheses: 0000:04:00.0. This is the Segment:Bus:Device.Function.

1. Identify the Physical Slot:

Use the PCI address found in the previous step to query the hardware details:

Bash

esxcli hardware pci list | grep -A 20 "0000:04:00.0"

Look for the following fields in the output:

• Slot Description: This often explicitly states the location, such as "Slot 3" or "Riser 1, Slot 1".
• Device Name: Confirms the hardware model (e.g., QLogic ISP2532).

Method 2: Using the vSphere Client (GUI)

If you prefer not to use the command line, you can find this information via the web interface.

1. Log in to the vSphere Client.
2. Navigate to the Host in the inventory.
3. Go to the Configure tab.
4. Under Hardware, select PCI Devices.
5. Locate your FC HBA in the list.

Check the Slot ID or Address column. Many modern servers (Dell, HPE, Lenovo) pass the physical slot information directly to ESXi, which will be displayed here.