B.1 January 2014 (OES 11 SP2)

B.1.1 NLVM Commands

Location

Change

Section 6.1.2, Syntax Conventions

Device names support node names (sdc and mpatha), full Linux path names (/dev/sdc and /dev/mapper/mpatha), and keywords anydisk or anyshared (for commands that support keyword use).

Section 6.2, NLVM Options

NLVM options can appear in any order in the command after nlvm. Previously, the NLVM options had to follow immediately after nlvm.

-m option in Section 6.2, NLVM Options

This option prevents pools that have been unmounted from being mounted.

Pools are by design auto mounted. Therefore, running the nssmu utility, or running most nlvm commands without the -m option can cause an unmounted pool to be remounted if underlying devices and partitions still exist. To execute an nlvm command without mounting the unmounted pools, you must include the -m option. The nlvm mount command internally sets the -m flag, so only the specified pool is mounted.

-s , --share in Section 6.2, NLVM Options

In a cluster, if the SBD does not exist or fails, you can use the -s option with NLVM commands to prepare a device and create an SBD partition. To minimize the risk of corruption, you must ensure that nobody else is changing any storage on any nodes at the same time.

-t , --terse option in Section 6.2, NLVM Options

This NLVM option is new. You can use the --terse option with nlvm list commands to display output in a format for parsing.

Section 6.3, Common Options

This section is new. You can use the more or all options with nlvm list commands to display additional or detailed information about storage objects.

Section 6.41, Move

You can check the status of a pool move by using the nlvm list move <move_name> command.

You can issue the nlvm complete move <move_name> command to finalize the move. Other NSS utilities might also complete the move. For information, see Moving a Pool in the OES 11 SP3: NSS File System Administration Guide for Linux.

Section 6.5, Create Linux Volume

If you use the ncp option, the volume name used for the name option must comply with the name limitations described in Section 5.2.4, NCP Volume Names.

Section 6.5, Create Linux Volume

You can use the volid option in combination with the shared and ncp options to assign an NCP volume ID to a clustered LVM volume that is unique across all nodes in every peer cluster of a Business Continuity Cluster.

Section 6.5, Create Linux Volume

You can use the part=<partition_name> option instead of the device and size options to specify an existing partition as the location for a non-clustered Linux volume.

Section 6.5, Create Linux Volume

Specify an unshared initialized device. For OES 11 SP2 and later, you can alternatively specify a shared device with no data partitions or an uninitialized device.

For a cluster-enabled LVM volume, issue the command from the master node in the cluster.

Section 6.52, Unmount

The nlvm unmount <poolname> command also removes the Device Mapper object for the pool, the link to the Device Mapper object, and the mount point for the pool. This allows you to gracefully log out the server from an iSCSI device that contains a pool.

Section 6.6, Create Partition

Because a physical partition must end on a cylinder boundary, its size might be slightly different than the size you specify.

Section 6.6, Create Partition

Added:

type=8e  (partition type for Linux LVM)

type=1ac (partition type for snapshots)

Section 6.6, Create Partition

A physical partition size might be rounded up or down to the next nearest cylinder boundary depending on the partition type, the specified size, and the amount of free space.

Section 6.6, Create Partition

Before you create a Novell Cluster Services SBD partition, you must take the cluster down, and stop Novell Cluster Services from running on all nodes.

Section 6.7, Create Pool

For a cluster-enabled pool, issue the command from the master node in the cluster.

Section 6.8, Create RAID

When mirroring a pool that consumes an entire MSDOS partitioned disk, you can use an MSDOS or GPT partitioned device of the same size.

Section 6.8, Create RAID

The type option is optional for mirroring existing partitions.

The name option is optional for mirroring an existing SBD partition.

Section 6.8, Create RAID

Because a physical partition must end on a cylinder boundary, its size might be slightly different than the size you specify.

Section 6.8, Create RAID

For Novell type partitions, the physical partition size might be rounded down to the next nearest cylinder boundary.

When you mirror an existing partition, the type option must precede the part option in the command.

Before you create a Novell Cluster Services SBD RAID 1, you must take the cluster down, and stop Novell Cluster Services from running on all nodes.

Added examples for creating a mirrored SBD RAID 1 device and for mirroring an existing SBD partition.

Section 6.9, Create Snap

The part option for the e nlvm create snap command allows you to specify a snap partition (type 1AC) as the target of the snapshot.The minimum snapshot size was increased from 1 MB to 50 MB.

Section 6.10, Create Volume

You can use the volid option in combination with a clustered NSS pool to assign an NCP volume ID to a clustered NSS volume that is unique across all nodes in every peer cluster of a Business Continuity Cluster.

Section 6.13, Delete Partition

Before you delete a Novell Cluster Services SBD partition, you must take the cluster down, and stop Novell Cluster Services from running on all nodes.

Section 6.15, Delete RAID

Before you delete a Novell Cluster Services SBD RAID 1, you must take the cluster down, and stop Novell Cluster Services from running on all nodes.

Section 6.24, Linux Mount

This command is new.

Section 6.25, Linux Unmount

This command is new.

Section 6.28, List Linux Volume

This command is new.

Section 6.27, List Devices

Section 6.29, List Linux Volumes

Section 6.31, List Moves

Section 6.33, List Partitions

Section 6.35, List Pools

Section 6.37, List Snaps

Section 6.39, List Volumes

The more option prints additional information about the storage object.

The all option prints detailed information about the storage object. This is the same information as for the specific nlvm list command for an object.

The -t or --terse NLVM option can be used with nlvm list commands to print the output in a format for parsing.

Section 6.40, Mount

The nlvm mount command internally sets the -m flag, so only the specified pool is mounted.

Section 6.41, Move

You can pause and resume a pool move.

Section 6.42, Pause Move

This command is new.

Section 6.47, Rename RAID

This command is new.

Section 6.50, Resume Move

This command is new.

Section 6.52, Unmount

Use the unmount command to temporarily unload a pool in order to manage underlying devices. Pools are by design auto mounted. Therefore, running the nssmu utility, or running most nlvm commands without the -m option can cause an unmounted pool to be remounted if underlying devices and partitions still exist. To execute an nlvm command without mounting the unmounted pools, you must include the -m option. The nlvm mount command internally sets the -m flag, so only the specified pool is mounted.

B.1.2 NLVM Examples for the NSS File System

B.1.3 Planning for NLVM

Location

Change

Section 5.9, Using NLVM with Linux Software RAIDs

We recommend that you do not use Linux software RAIDs (such as MD RAIDs and Device Mapper RAIDs) for devices that you plan to use for storage objects that are managed by NSS management tools. The Novell Linux Volume Manager (NLVM) utility and the NSS Management Utility (NSSMU) list the Linux software RAID devices that you have created by using Linux tools. Beginning with Linux Kernel 3.0 in OES 11 SP1, NLVM and NSSMU can see these devices, initialize them, and allow you to create storage objects on them. However, this capability has not yet been fully tested.

IMPORTANT:In OES 11, a server hang or crash can occur if you attempt to use a Linux software RAID when you create storage objects that are managed by NSS management tools.

Section 5.10, Using iSCSI Devices with NSS Software RAID5

This section is new.

B.1.4 Troubleshooting NLVM

Location

Change

Section 9.1, Viewing Error Code Messages

With the latest OES 11 SP1 patches, the NSS utility provides an /err switch that can be used from the command prompt to view error messages for NLVM commands error codes:

nss /err=<error_code_number>

Section 9.6, Error 20897 - This node is not a cluster member

This section is new.

NLVM Fails to Mirror from a DOS Partitioned Device to a GPT Partitioned Device of the Same Size

This issue is fixed in OES 11 SP2. This issue was fixed in the November 2012 Scheduled Maintenance Patches for OES 11 and OES 11 SP1.

B.1.5 What’s New or Changed in Novell Linux Volume Manager

Location

Change

Section 2.2, What’s New (OES 11 SP2)

This section is new.