6.12 Pool Cacheenable

pool cacheenable <name> <device> <size>

Associate a cache with an existing pool.

nlvm [nlvm_options] cacheenable <name> <cachedev> <cachesize>

Command Options

name=pool_name

Mandatory. Specify the name of an existing pool for which you want to associate a cache.

Example 

name=MYPOOL1
cachedev=cachedev_name

Mandatory. Specify the name of the NSS cache device from which the cache has to be allocated.

Examples 

cachedev=MYCACHEDEV1
cachesize=<value[K|M|G|T]|max>

Mandatory. Specify the amount of space to be used on the associated device. The size is not used if you specify the part= option instead of device=. The total cache device size must be greater than 10 megabytes.

If multiple devices are specified, each device option instance must have a matching size option instance. The first size instance is matched to the first device instance, and so on.

Example 

size=200G
size=3.98T

Command Examples

nlvm pool cacheenable name=MYPOOL1 cachedev=MYCACHEDEV1 cachesize=2G

Associate cache size of 2G from MYCACHEDEV1 to an existing pool MYPOOL1.

By default, an additional 1/4th of the cache size is allocated to cache metadata.