mkvol

Adds a volume to a storage pool.

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

>--+-----------------------+--+-------------------+------------->
   '- -client--client_name-'  '- -pool--pool_name-'

>--+---------------------+--+-----+--+---------------------+---->
   |             .-yes-. |  '- -f-'  '- -desc--description-'
   '- -activate--+-no--+-'

>--+-volume_name-+---------------------------------------------><
   '- - ---------'

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_id
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. Depending on the storage device, the required format for the ID may include spaces and surrounding quotation marks. For example, the VPD83Type1 format requires spaces and quotation marks, and the vpd83naa5 format does not.

Example: vpd83naa5=12234678

Example: "VPD83Type1=IBM 2105 00129280"

To ensure that you have the correct format for your storage device, use the lslun command and copy the LUN format from the output.
–client client_name
Specifies the name of a client to perform the labeling of the LUN.
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 volume. 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 a volume that you are adding to the system storage pool.
volume_name
Specifies the name of a volume to add. This name must be unique within the cluster and can be up to 256 characters in length.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the name of a volume to add.

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 LUN 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 tasks
Adding metadata LUNs to SAN File System
Adding volumes to a storage pool

Related reference
activatevol
chvol
expandvol
lslun
lsvol
rediscoverluns
reportvolfiles
rmvol
suspendvol

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2