chpool

Modifies the settings of one or more storage pools.

Read syntax diagramSkip visual syntax diagram
>>-chpool--+--------+--+--------------+------------------------->
           +- -?----+  '- -name--name-'
           +- -h----+
           '- -help-'

>--+----------------------+--+---------------------+------------>
   '- -thresh--percentage-'  '- -desc--description-'

     .-----------.
     V           |
>--+---pool_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.
–name name
Specifies the name to assign to the storage pool. This name can be up to 256 characters in length.
Note: You cannot change the name of the SYSTEM storage pool.
–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. If set to 0, no alert is 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.

Note: You cannot change the description of the SYSTEM storage pool.
pool_name
Specifies the names of one or more storage pools to modify.
Note: If you specify a name using the –name parameter, you may specify only one storage pool.
Specifies that you want to read the names of one or more storage pools to modify from stdin (for example, – << /work/stgpool_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 cannot modify the names of multiple storage pools at one time.

Example

Modify settings for two storage pools The following example modifies the threshold setting for two storage pools: stgpool1 and stgpool2.
sfscli> chpool -thresh 70 stgpool1 stgpool2
Storage pool stgpool1 modified.
Storage pool stgpool2 modified.

Parent topic: Administrative commands

Related reference
disabledefaultpool
lspool
mkpool
rmpool
setdefaultpool

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