test veritas logo



mkdstfs - SmartTier file system creation utility




mkdstfs [-f] [-h] [-M mkfsopts] [-m mountopts] [-v] mount_point disk_group volume_set volume [:placement_class] [:m|d] ...


The mkdstfs utility creates file systems for SmartTier data placement. You must pass the mount_point, disk_group, volume_set, and volume arguments in that order. You can pass multiple volumes, and must pass at least one volume.

If the specified volume set does not exist, the mkdstfs utility creates the volume set. The mkdstfs utility creates a file system on the volume set, and then sets up a placement policy for the file system.

The placement classes of the volumes are identical to the media type of the volumes. In the Veritas Volume Manager (VxVM) 5.1 release and later, the mkdstfs utility attempts to detect the type of media used by the LUNs. Currently, you can specify the "ssd" and "mixed" media types. The mkdstfs utility uses the media type of LUNs as the placement class for the volume.

If the mkdstfs utility cannot detect the media type or if you are using a Veritas Volume Manager release prior to the 5.1 release, you can specify or override the placement class by passing the placement class for each volume and separating the class with a colon (:). For example, "dbvol1:ssd dbvol2:bronze".

If solid state disk (SSD) volumes are available, the mkdstfs utility uses the first available SSD volume for first volume in the volume set. If SSD volumes are not available, the mkdstfs utility uses the first available mixed volume for first volume in the volume set. If both SSD and mixed volumes are not available, the operation fails. However, you can force the mkdstfs uility to proceed using the specified volumes by specifying the -f option.

First volume usually stores the file system metadata, although the volume can also store data. However, the metadata volume is used as a last resort to store data only when all other data volumes are full. To enable this behavior, the mkdstfs utility adds the "metadata" suffix to the placement class of the metadata volumes.

Any volumes that you pass after the first volume only store data and not metadata.

Cluster File System Issues

No cluster issues; utility operates the same on cluster file systems.


-f Creates the SmartTier file system even if you do not specify any no solid state drives or mixed volumes.
-h Prints the usage information.
-M mkfsopts Specifies options from the mkfs command to use when creating the file system.
-m mountopts Specifies options from the mount command to use when mounting the resulting file system.
-v Verbose. In verbose mode, the mkdstfs utility prints all of the commands that it executes.


  Specifies the mount point of the new file system.
disk_group Specifies the disk group that contains the volume set of the new file system. The disk group must already be imported.
volume_set Specifies the volume set on which to create the new file system. If the volume set does not already exist, the mkdstfs utility creates the volume set in the disk group.
volume Specifies the volumes to add to the volume set. You can also specify the placement class of each volume and the data type that each volume can contain, using a colon (:) as a separator. For the data type, m specifies metadata, and d specifies data only. If you do not specify the data type, then the first volume passed becomes the metadata volume and all other volumes become data-only volumes.


mkdstfs returns 0 on success, 1 on failure.


The following command creates a volume set called ssdvset1 with the two volumes ssdvol1 and hddvol1. The mkdstfs utility attempts to detect media type (in VxVM 5.1 or later) since no placement class information is specified:

# mkdstfs -v /dst1 dstdg ssdvset ssdvol1 hddvol1

The following command adds two new volumes, hddvol2 and hdddvol3, to an existing volume set with name existing_vset and also sets the placement classes as specified:

# mkdstfs -f /dst2 dstdg existing_vset hddvol2:bronze dvol3:gold

The following command makes volb as the metadata volume and the remaining volumes as data volumes:

# mkdstfs -f -v /dst3 lfsdg myvset volc:bronze volb:gold:m \vola:silver


fsppadm(1M), mkfs_vxfs(1M), mount_vxfs(1M),

Storage Foundation Administrator’s Guide

VxFS 8.0 mkdstfs(1M)