Managing iSER devices created on deprecated driver for RDMA HW
search cancel

Managing iSER devices created on deprecated driver for RDMA HW

book

Article ID: 311927

calendar_today

Updated On:

Products

VMware vSphere ESXi

Issue/Introduction

Helps users clean-up iSER object(s) that were created on deprecated devices prior to ESXi upgrade to 8.x.


Symptoms:

Users will see placeholder iSER vmhba(s) created on RDMA devices with deprecated device drivers like below when storage adapters are listed

  # esxcli storage core adapter list

HBA NameDriverLink StateUIDCapabilitiesDescription
vmhba64iserlink-n/aunknown.vmhba64Second Level Lun ID() Unknown



Environment

VMware vSphere ESXi 8.0.0

Cause

nmlx4 RDMA device driver deprecation combined with lack of iSER specific config manager support.

Resolution

Once ESXi is upgraded to 8.x, subsequent upgrades will not need this procedure.


Workaround:

Before ESXi upgrade is initiated, users must make note of all virtual RDMA (vmrdmaXX) devices whose corresponding RDMA NIC's driver is being deprecated in the upgraded version.

# esxcli rdma device list
   
NameDriverStateMTUSpeedPaired LinkDescription
vmrdma0nmlx4_rdmaActive102440 Gbpsvmnic6MT27520 Family [ConnectX-3 Pro]
vmrdma1nmlx4_rdmaActive102440 Gbpsvmnic1000602MT27520 Family [ConnectX-3 Pro]
vmrdma4nmlx5_rdmaActive1024100 Gbpsvmnic4MT27800 Family [ConnectX-5 PCIe 3.0]
vmrdma5nmlx5_rdmaActive1024100 Gbpsvmnic5MT27800 Family [ConnectX-5 PCIe 3.0]

Once ESXi is upgraded to 8.x. users can clean up placeholder iSER vmhba(s) using procedure below.

List storage adapters on the host

# esxcli storage core adapter list
HBA NameDriverLink StateUIDCapabilitiesDescription
vmhba66iserlink-n/aunknown.vmhba66Second Level Lun ID() Unknown
vmhba67iserlink-n/aunknown.vmhba67Second Level Lun ID() Unknown
vmhba68iseronlineiqn.2018-10.com.vmware:iser-dell-02:iser1Second Level Lun IDVMware iSCSI over RDMA (iSER) Adapter
vmhba69iseronlineiqn.2018-10.com.vmware:iser-dell-02:iser2Second Level Lun IDVMware iSCSI over RDMA (iSER) Adapter

Delete each iSER device with unknown UID and Description
    esxcli rdma iser delete -d vmrdma0
    esxcli rdma iser delete -d vmrdma1


Then, confirm that clean up is complete
  # esxcli storage core adapter list
    
HBA NameDriverLink StateUIDCapabilitiesDescription
vmhba68iseronlineiqn.2018-10.com.vmware:iser-dell-02:iser1Second Level Lun IDVMware iSCSI over RDMA(iSER) Adapter
vmhba69iseronlineiqn.2018-10.com.vmware:iser-dell-02:iser2Second Level Lun IDVMware iSCSI over RDMA (iSER) Adapter