6.10 Create Volume

create volume <name> <pool> [passw] [keytype] [quota] [volid] [adenable]

Create an NSS volume on an existing pool. NSS volumes are always mounted at /media/nss/<VolumeName> unless otherwise specified.

nlvm [nlvm_options] create volume <name> <pool> [passw] [keytype] [quota] [volid] [adenable]

Command Options

name=volume_name

Mandatory. Specify the name of the NSS volume to create. This name must be unique from other volumes. The volume name is automatically converted to uppercase.

Volume names are 2 to 15 characters. The naming conventions are the same as for pools.

Example

name=MYVOL1

pool=pool_name

Mandatory. Specify the name of an existing NSS pool where you want to create the volume.

Example

pool=MYPOOL1

passw=password

Specify a password if the volume is an encrypted volume.

Example

passw=novell

keytype=<AES128|AES256>

Optional. Specify a keytype value along with the password if the volume is an encrypted volume. If the keytype option is not used, AES128 encryption algorithm is used by default on the encrypted volume. Valid options are AES128 and AES256. This option should be used only with the passw option.

The AES256 value should be used only on the NSS64 pool type with the pool media upgraded to AES.

Example

keytype=AES256

quota=size

Optional. Specify a quota for the volume. A quota is the maximum amount of space in the pool that can be used by the volume. If no quota is specified or if the quota value exceeds the size of the pool, the volume can grow to the size of the pool.

If the maximum pool size is smaller than the specified volume quota, the volume can grow only to the size of the pool. If you later expand the size of the pool, then the volume quota is again the limiting factor.

Example

quota=500G

volid=value

(Optional) Used in combination with a clustered NSS pool to assign an NCP volume ID for a clustered NSS volume. If the volid option is not used, a volume ID is automatically assigned. For clustered volumes, the valid range is 254 to 0, in descending order.

In a Cluster Services cluster, the volume ID must be unique across all member nodes. In a Business Continuity Cluster, the volume ID must be unique across all nodes in every peer cluster.

Example

pool=MYPOOL50 volid=250

MYPOOL50 is a clustered NSS pool.

adenable=yes

(Optional) To create a volume with AD enabled, enter the value as 'yes'.

Example

adenable=yes

Command Examples

nlvm create volume name=MYVOL1 pool=MYPOOL1: Create a non-encrypted NSS volume on an existing pool named MYPOOL1.
nlvm create volume name=MYVOL1 pool=MYPOOL1 passw=novell keytype=AES256: Create an NSS volume on an existing pool named MYPOOL1, and encrypt the volume using the AES256 encryption algorithm and password as novell.
nlvm create volume name=MYVOL1 pool=MYPOOL1 quota=500G: Create a non-encrypted NSS volume on an existing pool named MYPOOL1. The volume has a quota of 500 GB.
nlvm create volume name=MYVOL50 pool=MYPOOL50 volid=250: Create a non-encrypted, clustered NSS volume on an existing clustered NSS pool named MYPOOL50. Assign it the NCP volume ID of 250, which the administrator knows to be unique across all member nodes in the OES Cluster Services cluster and across all peer clusters in a Business Continuity Cluster.
nlvm create volume name=MYVOL1 pool=MYPOOL1 adenable=yes: Create a non-encrypted NSS volume on an existing NSS pool named MYPOOL1 with AD media enabled.