6.7

Table Of Contents
Example: Obtaining Parameters for VMFS6 Space Reclamation
You can also use the esxcli storage vmfs reclaim config get -l=VMFS_label|-u=VMFS_uuid
command to obtain information for the space reclamation configuration.
# esxcli storage vmfs reclaim config get -l my_datastore
Reclaim Granularity: 1048576 Bytes
Reclaim Priority: low
Manually Reclaim Accumulated Storage Space
On VMFS datastores that do not support automatic space reclamation, you can use the esxcli
command to reclaim unused storage space manually.
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 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.
vSphere Storage
VMware, Inc. 340