6.5.1

Table Of Contents
Prerequisites
Install vCLI or deploy the vSphere Management Assistant (vMA) virtual machine. See Getting Started with
vSphere Command-Line Interfaces. For troubleshooting, run esxcli commands in the ESXi Shell.
Procedure
u
To reclaim unused storage blocks on the thin-provisioned device, run the following command:
esxcli --server=server_name storage vmfs unmap
The command takes these options:
Option Description
-l|--volume-label=volume_label
The label of the VMFS volume to unmap. A mandatory argument. If you specify
this argument, do not use -u|--volume-uuid=volume_uuid.
-u|--volume-uuid=volume_uuid
The UUID of the VMFS volume to unmap. A mandatory argument. If you specify
this argument, do not use -l|--volume-label=volume_label.
-n|--reclaim-unit=number
Number of VMFS blocks to unmap per iteration. An optional argument. If it is not
specified, the command uses the default value of 200.
What to do next
Important For additional details, see the VMware knowledge base article at
http://kb.vmware.com/kb/2014849.
Space Reclamation Requests from Guest Operating Systems
ESXi supports the unmap commands issued directly from a guest operating system to reclaim storage
space. The level of support and requirements depend on the type of datastore where your virtual machine
resides.
Inside a virtual machine, storage space is freed when, for example, you delete files on the thin virtual
disk. The guest operating system notifies VMFS about freed space by sending the unmap command. The
unmap command sent from the guest operating system releases space within the VMFS datastore. The
command then proceeds to the array, so that the array can reclaim the freed blocks of space.
Space Reclamation for VMFS6 Virtual Machines
VMFS6 generally supports automatic space reclamation requests that generate from the guest operating
systems, and passes these requests to the array. Many guest operating systems can send the unmap
command and do not require any additional configuration. The guest operating systems that do not
support automatic unmaps might require user intervention. For information about guest operating systems
that support automatic space reclamation on VMFS6, contact your vendor.
Generally, the guest operating systems send the unmap commands based on the unmap granularity they
advertise. For details, see documentation provided with your guest operating system.
vSphere Storage
VMware, Inc. 333