label add

Registers a label. Permissions required: fc or a.

Registers a label. See Using Storage Labels for more information on labels. Attempting to register a label that is already registered, results in an error.

When registering a label for a Storage Pool, the label and its associated values apply to all the disks in the Storage Pool.

Syntax

CLI
maprcli label add
    -label <label to be registered>
    [ -maxactiveioperdisk max active io per disk  ]
    [ -numdisksperinstance num disks per mfs instance  ]
    [ -isssd is solid state drive ]
    [ -istrimenabled is trim enabled ]
REST
Request Type POST
Request URL
http[s]://<host>:<port>/rest/label/add?<parameters> 

Parameters

label
Default Value: default
Possible Values: Any label
Description: The label to use for the storage pool. See Using Storage Labels for more information on labels.
The label should contain only the following characters:
A-Z a-z 0-9 _ - .
maxactiveioperdisk
Default Value: 100
Possible Values: Any integer value between 100 and 50000.
The number of concurrent IO operations per second that can be issued on the disk. Not specifying this value uses the default value specified in the mfs.conf file.
numdisksperinstance
Default Value: 20
Possible Values: Any integer value between 1 and 24.
Used in partitioning disks of the same type among multiple instances of fileservers on the same node.
isssd
Default Value: true
Possible Values: true or false
Set to true to indicate that the disk is an SSD.
istrimenabled
Default Value: false
Possible Values: true or false
Set to true to indicate that the SSD disk is TRIM enabled.

TRIM enables the File System to inform a SSD disk which data blocks it can erase because they are no longer in use. The use of TRIM can improve the performance of writing data to SSDs and contribute to longer SSD life. Set this parameter to true only if the SSD vendor recommends it.

Examples

  1. Register a label, before using it to label a storage pool.

    CLI
    maprcli label add -label WDCheetah
    REST
    https://abc.sj.us:8443/rest/labels/add?label=WDCheetah
  2. Register a label with additional settings such as the maximum active IO per disk and marking it as a SSD, before using it to label a storage pool.

    CLI
    maprcli label add -label WDCheetah -maxactiveioperdisk 5000 -isssd true -istrimenabled true
    REST
    https://abc.sj.us:8443/rest/labels/add?label=WDCheetah&maxactiveioperdisk=5000&-isssd=true&istrimenabled=true