mkvol

Adds one or more volumes to a storage pool.

Read syntax diagramSkip visual syntax diagram
>>-mkvol--+--------+-- -lun--lun--+-----------------------+----->
          +- -?----+              '- -client--client_name-'
          +- -h----+
          '- -help-'

>--+-------------------+--+---------------------+--+-----+------>
   '- -pool--pool_name-'  |             .-yes-. |  '- -f-'
                          '- -activate--+-no--+-'

>--+---------------------+--+-volume_name-+--------------------><
   '- -desc--description-'  '- – ---------'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–lun lun
Specifies the identifier of a logical unit (LU) to make into a volume. The identifier is comprised of the logical unit number (LUN) format, an equal sign, and the LUN ID.

Example: vpd83naa5=12234678

–client client_name
Specifies the name of a client that is zoned to access the LU.
To create a volume in a user storage pool, you must specify a SAN File System client that meets the following conditions:
  • The client must have access to the LU that is being added as a SAN File System volume. To list all active clients that can access the LU, use the reportclient –lun command.
  • The client must be active and appear in the registered (active) client list.

Do not specify a client if you are creating a volume in the system storage pool.

–pool pool_name
Specifies the name of the storage pool to which to add the new volumes. The storage pool is either a user-defined, default, or system storage pool. If not specified, this command adds the volume to the default storage pool.
–activate
Specifies whether the volume is activated. The metadata server can allocate new data only on activated volumes. Possible values are the following:
yes
Specifies that the metadata server can allocate new data on the volume. This is the default value.
no
Specifies that the metadata server cannot allocate new data on the volume.
–f
Forces the metadata server to add the volume and write a new label to the volume if the volume already has a valid SAN File System label.
Tip: You can use –f only if the volume is not assigned to another storage pool in the same cluster.
–desc description
Specifies the description for the volume. The description must be enclosed in matching single (') or double (") quotation marks if it contains any blank characters. This description can be up to 256 characters in length.

The default is an empty string. Specifying this parameter with no description results in a syntax error.

Note: Do not specify this parameter for volumes that you are adding to the system storage pool.
volume_name
Specifies the names of one or more volumes to add. This name must be unique within the cluster (not necessarily the fileset) and can be up to 256 characters in length.
Specifies that you want to read the names of one or more volumes to add from stdin (for example, – << /work/vol_list.txt).

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

You must format the applicable LUNs before invoking this command.

The cluster must not be in an offline state when you run this command.

Example

Create a volume The following example creates a volume and adds it to the storage pool named fast:
sfscli> mkvol -lun vpd83naa5=12234678  -client client03 -pool fast -desc "fast
vol 1" first_vol
Volume first_vol successfully created.

Parent topic: Administrative commands

Related reference
activatevol
chvol
expandvol
lslun
lsvol
rediscoverluns
reportvolfiles
rmvol
suspendvol

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.