label add

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

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
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