Shell Commands › Volume Management › format (Volume Management)--Format an Application User Volume

format (Volume Management)--Format an Application User Volume

Format an existing volume.

Syntax

vol format <name> [ <prop>=<val> ]* [ --force ]  

Options

<name>

Name of the volume to format. The format of <name> is the following: <application>:<volume>, _GLOBAL:<volume>

or

_GLOBAL_RO:<volume>

<prop>=<val>

Volume parameters. The following parameters may be set:

mkfs | fs

file system type (for example, ext3)

fs_options

additional file system options used to format the volume (See notes below for specifics)

parN.*

Partitioning parameters. (See notes below for specifics)

--force

Do not ask for verification of format operation

Notes:

• Only grid maintainers may format global read-only volumes or symbolic links to global read-only volumes (that is, GLOBAL_RO:<volume>). The following file systems are currently supported: ext2, ext3, fat16, fat32, ntfs, ntfs03, ntfs08, reiserfs, swap, ext3-snapshot, ufssol, zfs, and raw. Although ntfs and ntfs03 are supported filesystem names on the command line, the resulting volume is formatted as ntfs08.

  The following describes the format of the partitioning parameters:

  parN.size

  Specifies the size for partition N. Default: (disk_size - total_size_of_partitions_with_size_specified) / number_of_partitions_with_no_size_specified.

  parN.fs

  Specifies the filesystem type for partition N. Supports the same values as the fs property and also adds lvm and Extended. If the value is Extended, the partition will be of type extended and can hold logical volumes, no fs, fs_options, vg or lv properties can be user for this partition. To define logical partitions for an extended partition, use the parN second level property. fs=ext3-snapshot is now deprecated, the preferred way is to use fs=lvm. Default: raw

  parN.fs_options

  Options to pass to mkfs when creating the filesystem on the partition. Default: none

  parN.parN

  If a partition is specified as fs=Extended, this second level property can be used to create logical partitions on that extended partition.Any 2nd level property can be used as a 3rd level property for a logical partition. Example par3.fs=Extended par3.par1.fs=ext3.

  parN.vg

  The partition is created with fs=lvm, this can be used to specify the volume group for that lvm partition. If no vg is specified, a random string will be used.

  parN.<lv_name>.size

  Size in [G,M,T] Bytes, default is (partition_size - total_size_of_logical_volumes_with_size_specified) / number_of_logical_volumes_with_no_size_specified

  parN.<lv_name>.fs

  Specifies the filesystem type for this logical volume. Allowed values are any fs handled by the Linux Filer.

  parN.<lv_name>.fs_options

  Options to pass to mkfs when creating the filesystem on the logical volume. The value specified for the fs_options parameter is a space separated list, is file system specific, and is valid only with the mkfs parameter. The following are the options available for each supported filesystem:

  ext2 | ext3 | swap | reiserfs

  <any option> - any option understood by mkfs.<filesystem>. The options will be passed directly to the mkfs tool for the chosen filesystem.

  ext3-snapshot

  vol_group_name - string specifying the name of the LVM volume group to create on the volume. If not specified, a volume group name is randomly generated.

  data_percentage - percentage of the volume that is used to store data, remaining portion of the volume is for snapshots. If not specified, 80% of the volume is used for data.

  <any option> - any option understood by mkfs.ext3. The options will be passed directly to the mkfs tool and will be used for the data volume.

  zfs

  pool_name - the name of the pool - defaults to volume name if this is not set

  mountpoint - mount path of the pool root (or "legacy" or "none", that is, mountpoint=legacy) - defaults to /pool_name

  autoreplace - on/off - controls automatic device replacement - defaults to off

  delegation - on/off - controls whether a non-privileged user is granted access based on the dataset permissions defined on the dataset - defaults to on

  failmode wait/continue/panic - defaults to wait

  version - 1-10 - defaults to 10 (current)

  ntfs, ntfs03, ntfs08

  volume_label - the volume label for the dst volume. If empty, the vol_name property value is used instead.

  active - create the new partition as active (bootable). Valid values are yes and no. If omitted, the default value of no is used during format while the value defaults to the src volume type during fscopy

Examples

vol format my-app:data fs=ext3    

format application user volume