Installing the Dell PowerFlex SDC on ESXi: Step-by-Step

Installing the SDC on ESXi shows how to install the PowerFlex SDC manually on an ESXi host.

About our Environment

PowerFlex Cluster version 4.5.2.
VMware ESXi 8.0.3 build-24022510.
Both PowerFlex and ESXi run in a nested (virtual) environment.

PowerFlex Release Notes Compatibility Check

First and foremost, we always recommend consulting the PowerFlex release notes to confirm what ESXi versions are compatible with the current PowerFlex version:

https://dl.dell.com/content/manual68830250-dell-powerflex-4-5-x-release-notes.pdf

In this case, for instance, the PowerFlex 4.5.2 supports ESXi 8.0 Update 2b (Build 23305546) or earlier:

Installing the SDC “vib” on ESXi Host

After downloading the SDC package for vSphere ESXi 8.0 from support.dell.com, access the desired ESXi host by SSH and check if the SDC vib is already installed:

esxcli software vib list | grep -i emc

Copying the SDC vib from the local desktop to the ESXi host and installing it. After installing the vib, reboot the system:

# We are copying the ".zip" from a Windows client using PowerShell:
scp C:\Temp\sdc-4.5.0.263-esx8.x.zip root@192.168.255.15:/tmp
esxcli software vib install -d /tmp/sdc-4.5.0.263-esx8.x.zip
reboot

Note: If the ESXi host is a production host, before rebooting, put it first in maintenance mode and then reboot it:

Checking vib details after installation:

esxcli software vib list | grep -i emc

Connecting SDC to the MDM Cluster

After installing the SDC vib, we must configure it to connect to the MDM cluster.

Generating a UUID for the ESXi host. We can use the Powershell to do it:

[guid]::NewGuid()

Example:

PS C:\Users\tux000> [guid]::NewGuid()

Guid
----
f6afa69c-a9a9-48af-bbc6-356d57da909b

Note: https://guidgenerator.com/ (another option to generate the GUID).
The GUID must be unique for each device!

Configuring the scini module (the module name used by the SDC) points to the MDM servers and passes the ESXi’s GUID. After doing it, reboot the system again:

esxcli system module parameters set -m scini -p "IoctlIniGuidStr=f6afa69c-a9a9-48af-bbc6-356d57da909b IoctlMdmIPStr=192.168.155.254+192.168.156.254"

Where:
IoctlIniGuidStr=f6afa69c-a9a9-48af-bbc6-356d57da909b –> GUID generated using the PowerShell;
IoctlMdmIPStr=192.168.155.254+192.168.156.254 –> Since we have both virtual IPs, we need to specify them using the “+”.

Checking the SDC module configuration and confirming if the scini module was loaded:

esxcli system module parameters list -m scini | grep Ioctl
vmkload_mod --list | grep -i scini

As we can see in the above picture, the scini module has been loaded successfully!

If the scini module was loaded successfully, we could see a software adapter using the scini driver:

esxcli storage core adapter list

On the MDM primary, check the new SDC details (in this case, we are filtering by GUID the command output):

scli --login --management_system_ip 192.168.255.61 --username admin
scli --query_all_sdc | grep -i -A4 f6afa69c-a9a9-48af-bbc6-356d57da909b

Creating and Mapping Volumes to the new SDC

Creating two new volumes, “vSphere-Vol-03” and “vSphere-Vol-04”, both thin-provisioned and with 64GB each:

scli --add_volume --size_gb 64 --volume_name vSphere-Vol-03 --protection_domain_name PD01 --storage_pool_name SP01 --thin_provisioned

scli --add_volume --size_gb 64 --volume_name vSphere-Vol-04 --protection_domain_name PD01 --storage_pool_name SP01 --thin_provisioned

Mapping both volumes to the new SDC. In this case, for instance, we are mapping each volume to the SDC using the SDC GUID:

scli --map_volume_to_sdc --volume_name vSphere-Vol-03 --sdc_guid F6AFA69C-A9A9-48AF-BBC6-356D57DA909B --allow_multi_map

scli --map_volume_to_sdc --volume_name vSphere-Vol-04 --sdc_guid F6AFA69C-A9A9-48AF-BBC6-356D57DA909B --allow_multi_map

Checking what SDCs are mapped to each volume:

scli --query_volume --volume_name vSphere-Vol-03

>> Volume ID: 2902b2d500000010 Name: vSphere-Vol-03
   Provisioning: Thin
   Size: 64.0 GB (65536 MB)
   Total base user data: 0 Bytes
   Storage Pool 2714b2fe00000000 Name: SP01
   Protection Domain b187c36500000000 Name: PD01
   Creation time: 2024-12-19 08:59:32
   Class: default
   Reads:  0 IOPS 0 Bytes per second
   Writes: 0 IOPS 0 Bytes per second
   Data layout: Medium granularity
   Mapping:
      Host ID: 997fade30000000f Name: N/A Host Type: SDC IP: 192.168.156.211 Access Mode: READ_WRITE , Device is mapped to SDC
   No SCSI reservations
   No Nvme reservations
   Migration status: Not in migration
   Doesn't use RAM Read Cache
   Replication info:
      Replication state: Not being Replicated
   Volume NVMe Namespace ID: 17

==========

scli --query_volume --volume_name vSphere-Vol-04

>> Volume ID: 2902b2d600000011 Name: vSphere-Vol-04
   Provisioning: Thin
   Size: 64.0 GB (65536 MB)
   Total base user data: 0 Bytes
   Storage Pool 2714b2fe00000000 Name: SP01
   Protection Domain b187c36500000000 Name: PD01
   Creation time: 2024-12-19 08:59:38
   Class: default
   Reads:  0 IOPS 0 Bytes per second
   Writes: 0 IOPS 0 Bytes per second
   Data layout: Medium granularity
   Mapping:
      Host ID: 997fade30000000f Name: N/A Host Type: SDC IP: 192.168.156.211 Access Mode: READ_WRITE , Device is mapped to SDC
   No SCSI reservations
   No Nvme reservations
   Migration status: Not in migration
   Doesn't use RAM Read Cache
   Replication info:
      Replication state: Not being Replicated
   Volume NVMe Namespace ID: 18

As we can see in the output above, the new SDC (ESXi) has mapped both volumes correctly. The next step is to rename the SDC hostname:

-- BEFORE:
scli --query_all_sdc | grep -i -A4 F6AFA69C-A9A9-48AF-BBC6-356D57DA909B
SDC ID: 997fade30000000f Name: N/A IPs: 192.168.156.211,192.168.155.212 State: Connected GUID: F6AFA69C-A9A9-48AF-BBC6-356D57DA909B  OS Type: ESX Loaded Version: 4.5.0 Installed Version: 4.5.0
    Agent status: disabled MDM IP addresses: stale Reboot safe: no
    Reads:  0 IOPS 0 Bytes per second
    Writes: 0 IOPS 0 Bytes per second

-- RENAMING:
scli --rename_sdc --sdc_guid F6AFA69C-A9A9-48AF-BBC6-356D57DA909B --new_name ESXI05
Successfully renamed host SDC with GUID F6AFA69C-A9A9-48AF-BBC6-356D57DA909B to ESXI05

-- AFTER:
scli --query_all_sdc | grep -i -A4 F6AFA69C-A9A9-48AF-BBC6-356D57DA909B
SDC ID: 997fade30000000f Name: ESXI05 IPs: 192.168.156.211,192.168.155.212 State: Connected GUID: F6AFA69C-A9A9-48AF-BBC6-356D57DA909B  OS Type: ESX Loaded Version: 4.5.0 Installed Version: 4.5.0
    Agent status: disabled MDM IP addresses: stale Reboot safe: no
    Reads:  0 IOPS 0 Bytes per second
    Writes: 0 IOPS 0 Bytes per second

Listing and Using the PowerFlex Volumes on the ESXi

On the ESXi command line, we can list all devices provided by the PowerFlex:

esxcli storage core device list | grep -i -B7 "Vendor: EMC"

Example:

eui.8c40194f563e090f2902b2d600000011
   Display Name: EMC Fibre Channel Disk (eui.8c40194f563e090f2902b2d600000011)
   Has Settable Display Name: true
   Size: 65536
   Device Type: Direct-Access
   Multipath Plugin: NMP
   Devfs Path: /vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011
   Vendor: EMC
--
eui.8c40194f563e090f2902b2d500000010
   Display Name: EMC Fibre Channel Disk (eui.8c40194f563e090f2902b2d500000010)
   Has Settable Display Name: true
   Size: 65536
   Device Type: Direct-Access
   Multipath Plugin: NMP
   Devfs Path: /vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010
   Vendor: EMC
--
eui.8c40194f563e090f997fade30000000f
   Display Name: EMC Fibre Channel Disk (eui.8c40194f563e090f997fade30000000f)
   Has Settable Display Name: true
   Size: 0
   Device Type: Direct-Access
   Multipath Plugin: NMP
   Devfs Path: /vmfs/devices/disks/eui.8c40194f563e090f997fade30000000f
   Vendor: EMC

Creating datastores on the ESXi command line:

1- Checking the current filesystem before the datastore creation:

esxcli storage filesystem list

Example:

Mount Point                                           Volume Name                                 UUID                                    Mounted  Type            Size          Free
----------------------------------------------------  ------------------------------------------  --------------------------------------  -------  ------  ------------  ------------
/vmfs/volumes/670bfcd4-bd923ea8-aedf-000c29af4643     OSDATA-670bfcd4-bd923ea8-aedf-000c29af4643  670bfcd4-bd923ea8-aedf-000c29af4643        true  VMFSOS   19058917376   15767437312
/vmfs/volumes/d8d8e65f-944e99e0-f1be-cc6ddb33da14     BOOTBANK1                                   d8d8e65f-944e99e0-f1be-cc6ddb33da14        true  vfat      1073577984     790855680
/vmfs/volumes/7fcc6c4b-934b5543-d4ae-816dcfa848e9     BOOTBANK2                                   7fcc6c4b-934b5543-d4ae-816dcfa848e9        true  vfat      1073577984     791838720
/vmfs/volumes/vsan:52a469c557ab8a3f-6d6eb81eaa2b3c1d  vsanDatastore-ESA                           vsan:52a469c557ab8a3f-6d6eb81eaa2b3c1d     true  vsan    273720279040  124403733641

2- Grabbing both disk identifiers (esxcli storage core device list | grep -i -B7 “Vendor: EMC”):
eui.8c40194f563e090f2902b2d600000011
eui.8c40194f563e090f2902b2d500000010

3- Getting the disk path for both disks:

ls /vmfs/devices/disks/eui.*

/vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011
/vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010

4- Creating the disk partition:

partedUtil showGuids --> grabbing the GUID for the vmfs filesystem

Example:

partedUtil showGuids
 Partition Type       GUID
 vmfs                 AA31E02A400F11DB9590000C2911D1B8
 vmkDiagnostic        9D27538040AD11DBBF97000C2911D1B8
 vsan                 381CFCCC728811E092EE000C2911D0B2
 virsto               77719A0CA4A011E3A47E000C29745A24
 VMware Reserved      9198EFFC31C011DB8F78000C2911D1B8
 Basic Data           EBD0A0A2B9E5443387C068B6B72699C7
 Linux Swap           0657FD6DA4AB43C484E50933C84B4F4F
 Linux Lvm            E6D6D379F50744C2A23C238F2A3DF928
 Linux Raid           A19D880F05FC4D3BA006743F0F84911E
 Efi System           C12A7328F81F11D2BA4B00A0C93EC93B
 Microsoft Reserved   E3C9E3160B5C4DB8817DF92DF00215AE
 Unused Entry         00000000000000000000000000000000

# Creating an empty gpt partition on both disk devices:
partedUtil setptbl /vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010 gpt
partedUtil setptbl /vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011 gpt

# Getting the usable sectors from each gpt partition:
partedUtil getUsableSectors /vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010
partedUtil getUsableSectors /vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011

Example:

[root@esxi05:/dev/disks] partedUtil getUsableSectors /vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010
34 134217694

[root@esxi05:/dev/disks] partedUtil getUsableSectors /vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011
34 134217694

# Creating one partition with all usable sectors:
partedUtil setptbl /vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010 gpt "1 34 134217694 AA31E02A400F11DB9590000C2911D1B8 0"

partedUtil setptbl /vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011 gpt "1 34 134217694 AA31E02A400F11DB9590000C2911D1B8 0"

Where, in this case:
“1 34 134217694 AA31E02A400F11DB9590000C2911D1B8 0”

1 = The first partition
34 = The first usable disk sector
134217694 = The last usable disk sector
AA31E02A400F11DB9590000C2911D1B8 = GUID for the vmfs filesystem type
0 = flags (no special flag)

After creating the disk partition, we will create the VMFS datastores:

# Creating the VMFS datastore "PowerFlex-Vol-03" using the disk partition eui.8c40194f563e090f2902b2d500000010:1:
vmkfstools -C vmfs6 -S PowerFlex-Vol-03 /vmfs/devices/disks/eui.8c40194f563e090f2902b2d500000010:1

# Creating the VMFS datastore "PowerFlex-Vol-04" using the disk partition eui.8c40194f563e090f2902b2d600000011:1:
vmkfstools -C vmfs6 -S PowerFlex-Vol-04 /vmfs/devices/disks/eui.8c40194f563e090f2902b2d600000011:1