mkpool

Defines one or more new user storage pools.

Read syntax diagramSkip visual syntax diagram
>>-mkpool--+--------+--+---------------------+------------------>
           +- -?----+  |             .-16--. |
           +- -h----+  '- -partsize--+-64--+-'
           '- -help-'                '-256-'

>--+-----------------------+--+----------------------+---------->
   |              .-auto-. |  '- -thresh--percentage-'
   '- -allocsize--+-4----+-'
                  '-128--'

                              .-----------.
                              V           |
>--+---------------------+--+---pool_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.
–partsize size
Specifies the partition size, in megabytes, to use when a fileset allocates space. The partition size can be set to 16, 64, or 256 MB. The default size is 16 MB.
Restriction: You cannot change the partition size after it is set.

For normal use, set the partition size to 16MB. To improve performance, especially for handling extremely large files, you can specify a larger partition size. Be aware that when you set a partition size higher than 16 MB, the pools take up more storage.

–allocsize size
Specifies the allocation size, in kilobytes, by which a file that resides on a storage pool is to be extended. The allocation size can be set to auto, 4, or 128. If you specify auto, the system sets the size automatically. The default value is auto.
Restriction: You cannot change the allocation size after it is set.
–thresh percentage
Specifies a percentage of the storage pool's estimated capacity that, when reached or exceeded, causes the metadata server to generate an alert. If the capacity drops and then reaches the percentage again, additional alerts are sent.

You can specify a value between 0 and 100. The default alert threshold percentage is 80. If set to 0, no alerts are generated.

–desc description
Specifies a description for the storage pool. 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.

pool_name
Specifies the names of one or more storage pools to create. Each name can be up to 256 characters in length.
Specifies that you want to read the names of one or more storage pools to create from stdin (for example, – << /work/stgpools_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.

Description

You can create multiple storage pools with the same values for the partition size, allocation size, and alert threshold in a single command; however, you cannot set the name or description for multiple storage pools.

Example

Create two storage pools The following example creates two storage pools (stgpool1 and stgpool2), sets the partition size on both to 256 MB, and specifies to send alerts when the allocated capacity reaches 70%.
sfscli> mkpool -partsize 256 -thresh 70 stgpool1 stgpool2
Storage pool stgpool1 created.
Storage pool stgpool2 created.

Parent topic: Administrative commands

Related reference
disabledefaultpool
chpool
lspool
rmpool
setdefaultpool

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