Dell EMC Unity: How to view/change HLU IDs for ESXi hosts on Unity
Summary: Dell EMC Unity: How to view/change HLU IDs for ESXi hosts on Unity
This article applies to
This article does not apply to
This article is not tied to any specific product.
Not all product versions are identified in this article.
Instructions
Reference to KB 490149 (How to view and change LUN ID (HLU)), which illustrates how to view/change HLU ID for hosts that have access to a LUN or Datastore on Dell EMC Unity arrays.
This above KB applies to all hosts except for ESXi hosts that are added to Unity array through a vCenter.
If you are trying to change the HLU ID for an ESXi host added via the vCenter option in Unisphere, the HLU ID can't be modified from Unisphere, therefore the CLI has to be used
ATTENTION: changing the Host LUN ID value should be done in a maintenance window.
This above KB applies to all hosts except for ESXi hosts that are added to Unity array through a vCenter.
If you are trying to change the HLU ID for an ESXi host added via the vCenter option in Unisphere, the HLU ID can't be modified from Unisphere, therefore the CLI has to be used
ATTENTION: changing the Host LUN ID value should be done in a maintenance window.
uemcli -u admin -p PASSWORD /remote/host/hlu -host Host_1 -lun sv_2 -type production set -lunid 1
Just replace the Bold sections above with the password, host, LUN, and the new HLU ID respectively.
To gather the host name, LUN name, and the HLU ID of that host to that LUN you will need to run the three commands.
uemcli u admin securePassword /remote/host show <<<<<<<< This will let you review your host ID. Example: Host_1 for host peeps-pod4-esxi6.peeps.lab
uemcli -u admin -securePassword /stor/prov/vmware/vmfs show <<<<<<<< This will let you review the Datastores LUN ID. Example: sv_2 for Datastore Test1 ***Please note if this is an VMware NFS datastore you would replace the vmfs with nfs.***
uemcli -u admin -securePassword /stor/prov/luns/lun show <<<<<<<< This will let you review a regular LUNs, LUN ID. Example: sv_2 for LUN Test1
uemcli -u admin -securePassword /remote/host/hlu -host <<host id>> -lun <<Lun ID >> show <<<<< This command will show you the hosts HLU id for the LUN/Datastore.
Below is the output ran in a LAB that shows each command being ran and what you are looking for:
14:53:59 service@VIRT18248F2BKX-spa spa:~> uemcli -u admin -securePassword /remote/host show
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = Host_1 <<<<<<< Host ID
Name = peeps-pod4-esxi6.peeps.lab
Description =
Tenant =
Type = host
Address = 5.6.7.40
Netmask =
OS type = VMware ESXi 6.5.0
Ignored address =
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
6: ID = Host_6 <<<<<<< Host ID
Name = peeps-pod2-esxi6.peeps.lab
Description =
Tenant =
Type = host
Address = 5.6.7.20
Netmask =
OS type = VMware ESXi 6.5.0
Ignored address =
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
14:51:38 service@VIRT18248F2BKX-spa spa:~> uemcli -u admin -securePassword /stor/prov/vmware/vmfs show -detail
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = res_3
LUN = sv_1 <<<<<< LUN ID
Name = Test <<<<< Lun/VMFS datastore name
Description =
Type = Primary
Base storage resource = res_3
Source =
Original parent =
Health state = OK (5)
2: ID = res_4
LUN = sv_2 <<<<<<< LUN ID
Name = Test1 <<<<< Lun/VMFS datastore name
Description =
Type = Primary
Base storage resource = res_4
Source =
Original parent =
Health state = OK (5)
15:01:52 service@VIRT18248F2BKX-spa spa:~> uemcli -u admin -securePassword /remote/host/hlu -host Host_6 -lun sv_2 show
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = Host_6_sv_2_prod
Host = Host_6
LUN = sv_2
Snapshot =
LUN ID = 1 <<<<< Host_6 HLU ID for LUN/VMFS sv_2/Test1
LUN type = Production
15:02:00 service@VIRT18248F2BKX-spa spa:~> uemcli -u admin -securePassword /remote/host/hlu -host Host_1 -lun sv_2 show
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = Host_1_sv_2_prod
Host = Host_1
LUN = sv_2
Snapshot =
LUN ID = 0 <<<<< Host_1 HLU ID for LUN/VMFS sv_2/Test1
LUN type = Production
15:05:03 service@VIRT18248F2BKX-spa spa:~> uemcli -u admin -securePassword /remote/host/hlu -host Host_1 -lun sv_2 -type production set -lunid 1 <<<<< Command in KB that changes HLU ID. Changing Host_1 HLU id to 1 for LUN/VMFS sv_2/Test1
Password:
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
Operation completed successfully.
15:05:41 service@VIRT18248F2BKX-spa spa:~> uemcli -u admin -securePassword /remote/host/hlu -host Host_1 -lun sv_2 show <<<<<< Command to check HLU id for LUN showing that it did indeed change the HLU Id to 1.
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = Host_1_sv_2_prod
Host = Host_1
LUN = sv_2
Snapshot =
LUN ID = 1
LUN type = Production
Additional Information
This KB only applies to Unity
Although this change can also be done over CLI for more recent versions of the Unity OE, the option is available in Unisphere
Although this change can also be done over CLI for more recent versions of the Unity OE, the option is available in Unisphere
Affected Products
Dell EMC Unity FamilyProducts
Dell Unity 300, Dell EMC Unity 300F, Dell EMC Unity 400, Dell EMC Unity 400F, Dell EMC Unity 500, Dell EMC Unity 500F, Dell EMC Unity 600, Dell EMC Unity 600F, Dell EMC Unity Family |Dell EMC Unity All Flash, Dell EMC Unity FamilyArticle Properties
Article Number: 000022492
Article Type: How To
Last Modified: 22 Oct 2025
Version: 6
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.