Shell Commands › Volume Management › create (Volume Management)--Create a New Volume for an Application

create (Volume Management)--Create a New Volume for an Application

Create a new application or global volume

Syntax

vol create <name> (mkfs=<fs> | fs=<fs>) [ <prop>=<val> ]* [ -n ] [--prefill] [ --batch ] 

Options

<name>

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

or _GLOBAL_RO:<volume>.

<fs>

File system type (for example, ext3)

<prop>=<val>

Volume parameters. The following parameters may be set:

size

Volume size, units may be specified (for example, 128M[B], 2G[B]). If units are not specified, it is assumed that the value is in MB. Default is 1G

comment

Volume comment. This parameter is not supported if the 'link' parameter is specified.

fs_options

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

link

Name of application user or global volume to which the volume is to be linked. The format of the link is the following:

<application>:<volume>

or _GLOBAL:<volume>.

-n

Skip verification that volume reference is in the class descriptor if adding an application singleton class volume.

--prefill

Allocate ALL blocks of volume.

--batch

Display output in UDL format.

Notes:

• Only grid maintainers may create global read-only volumes or symbolic links to global read-only volumes (that is, GLOBAL_RO:<volume>).
• The “mirrored=” argument is not useful on CA AppLogic for System z® as disk mirroring is not managed by the product. Providing “mirrored=” to “volume create” will produce a warning but it will otherwise be ignored.
• 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 create my-app:data fs=ext3

create 1G application user volume

vol create my-app:data fs=ext3 fs_options="-j -J size=180 -m 0"

create 1G application user volume specifying journal size and reserved blocks.

vol create my-app:DBASE.boot fs=ext3 size=256M -n

create 256M application singleton class boot volume and don't check that volume reference exists in the class descriptor of DBASE.

vol create my-app:data fs=ext3-snapshot size=1G fs_options="vol_group_name=VGVOL data_percentage=75"

create 1G application user volume of type ext3-snapshot.

This section contains the following topics:

volume create Command Output Specification