6.11 Create Cachedev

create cachedev <name> <size> <device>

Create an NSS cachedev.

nlvm [nlvm_options] create cachedev <name> <size> <device>

Command Options

name=cachdev_name

Mandatory. Specify the name of the cache device to create. This name must be unique from other cache devices. The cache device name is automatically converted to uppercase.

Cache device names are 2 to 15 characters. Uppercase letters A to Z, number characters 0 to 9, and underscore (_) are valid characters for all cache devices. Names cannot start or end in underscore, and cannot contain double underscores.

If the cache device is not shared, the cache device can also contain special characters:

!@#$%&()

Names that contain special characters must be enclosed in quotation marks in all commands and scripts.

Example

name=MYCACHEDEV1
size=<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
device=<devicename>

Specify the device to use for the cache device.

Do not specify the device option in combination with the part option.

You can specify multiple device instances to create a cache device comprised of multiple segments. Each device option instance must have a matching size option instance. The first device instance is matched to the first size instance, and so on. When specifying multiple devices, device names must be provided for each instance.

Examples

device=sdb
device=sde device=sdf device=sdg    (Specify a size for each instance.)

Command Examples

nlvm create cachedev name=MYCACHEDEV1 device=sdd size=10G device=sde size=15G

Create a cachedev named MYCACHEDEV1 from device sdd and sde that has size of 10 GB and 15 GB respectively.