6.2.12.14 mkvolume

Create a volume or clone a volume snapshot.

Purpose

The mkvolume command allows you to create a new Exascale volume or clone a volume snapshot.

Syntax

To create a new volume:

mkvolume size --vault vault [ --attributes attribute=value[,attribute=value] ... ]

To clone a volume snapshot:

mkvolume --attributes volumeSnapshot=parent_snapshot_id[,name=clone_name][,iopsProvisioned=integer_value][,iopsInherited={true|false}]

Command Options

The options for the mkvolume command are:

• size: Specifies the size of the volume. The size can be specified using suffixes K, KB, M, MB, G, GB, T, TB. The suffix is not case-sensitive.

  Note:

  If you intend to use the volume to support Oracle ACFS, note that ACFS requires a minimum volume size of 512 MB.

• --vault: Specifies the vault that the volume is created in.

• --attributes: Optionally specifies attributes for the volume.

  Use the describe mkvolume command to view details about all the volume attributes you can set with mkvolume.

Usage Notes

When cloning a volume snapshot, use only the following attribute settings. No other command options or settings are required or permitted.

• volumeSnapshot=parent_snapshot_id: Identifies the volume snapshot that you want to clone.

• name=clone_name: Optionally specifies the name of the volume clone, which makes it easier for you to identify later. If not specified, a system-generated name is assigned.

• iopsProvisioned=integer_value: Optionally specifies the I/O bandwidth provisioned for the volume clone. The I/O bandwidth is expressed as the number of I/Os per second (IOPS).

• iopsInherited={true|false}: Optionally specifies whether the volume clone inherits I/O bandwidth from the nearest ancestor in the volume hierarchy with provisioned I/O bandwidth (not inherited).

Examples

Example 6-170 Create a Volume

This example shows creating a volume that is 100 MB in size and located in the vault named MYVOLS.

@> mkvolume 100m --vault MYVOLS

Example 6-171 Create a Volume with Attribute Settings

This example shows creating a volume with specific attribute settings that is 200 MB in size and located in the vault named MYVOLS.

@> mkvolume 200m --vault MYVOLS --attributes name=vol2,iopsProvisioned=1000