6.10 Create Volume

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

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

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

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

Create an NSS volume on an existing pool named MYPOOL1, and encrypt the volume using the password of 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 Novell Cluster Services cluster and across all peer clusters in a Business Continuity Cluster.