Before you can use vSAN storage in your environment, you must set it up.

About this task

This process is divided into two main tasks:

  • Bootstrap the first ESXi host from the command line and create the vSAN datastore.

  • After vCenter Server installation, perform vSAN configuration for all other hosts from the vSphere Web Client. 


  1. Open an SSH client to connect to the ESXi Shell on mgmt01esx01.sfo01.rainpole.local.
    1. Open a console window to the host.
    2. Log in using the following credentials.



      login as:




  2. Run the following command to determine the current vSAN storage policy.
    esxcli vsan policy getdefault

  3. Modify the default vSAN storage policy to force provisioning of the vSAN datastore without generating errors.
    esxcli vsan policy setdefault -c vdisk -p "((\"hostFailuresToTolerate\" i1) (\"forceProvisioning\" i1))" 
    esxcli vsan policy setdefault -c vmnamespace -p "((\"hostFailuresToTolerate\" i1) (\"forceProvisioning\" i1))" 
    esxcli vsan policy getdefault 

  4. Generate the vSAN cluster UUID and create the vSAN cluster.
    python -c 'import uuid; print (uuid.uuid4());'


    You need the $UUID_GENERATED from the generated output for the next command.

    esxcli vsan cluster join -u <UUID_GENERATED>
    esxcli vsan cluster get

  5. List the devices and determine the device name for the SSD and HDD.

    These disks will be used to provision the vSAN datastore.

    vdq -q

    Identify all devices that can be used by vSAN.


    SDD Value

    HDD Value


    Eligible for use by VSAN

    Eligible for use by VSAN




  6. Create vSAN datastore using available SSD and HDD disks determined from previous step.
    esxcli vsan storage add -s SSD_Device_name -d HDD_Device Name

  7. Confirm that the vSAN datastore has been created.
    esxcli storage filesystem list

    A vSAN datastore is now created and ready for the Management vCenter Server installation.