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)

--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>).
• Specifying partitions, as is available in the distributed version of the product, will currently result in an error.
• The following file systems are currently supported: ext2, ext3

  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

  <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.

Examples

vol format my-app:data fs=ext3    

format application user volume