B.7 nssupdate

The NSS Update (nssupdate) utility is used to resize a pool to a larger size so that it can consume contiguous free space that follows the existing pool on a device.

You should not need to run this utility if you increase the size of a pool in the NSS-supported EVMS (Enterprise Volume Management System) environment. When working with NSSMU (NSS Management Utility) and the Storage plug-in for Novell iManager to manage NSS pools and volumes on EVMS-managed devices, NSS automatically makes any necessary changes to the pool’s underlying structure.

You can use this tool to manually resize a pool if you are using the NSS file system on a device that is managed by a volume manager other than EVMS, such as LVM2 (Linux Volume Manager 2). After you have performed all steps to increase the size of the LVM2 device and partitions by using Linux tools, use the NSS Update utility to let NSS know to expand the pool size to the desired new size (specified in bytes).

B.7.1 Syntax

nssupdate -pool poolName -size sizeInBytes [-shared | -notshared]

Issue this command from a terminal console prompt as the root user.

B.7.2 Availability

Novell Open Enterprise Server 2 for Linux

B.7.3 Options

-pool poolname

Specifies the name of the pool you want to resize.

-size sizeInBytes

Specifies the new maximum size of the pool in bytes.

The value for sizeInBytes cannot exceed the actual size of the device. You can enter any value larger than the pool’s current size and up to the size of the device. The space you designate must already be free for consumption by the pool. Make sure you understand exactly what space is free on the device so that you do not inadvertently overwrite any metadata stored at the end of the device. The pool begins at the same sector location as it currently does, and the extension is based on space that follows its current end location on the device.

[-shared | -notshared]

Sets the share state of the pool. The -shared option sets the share state to Shareable in a Cluster so that the pool can be shared in a cluster environment that is using Novell Cluster Services (NCS) for Linux. The -unshared option sets the share state to Not Shareable.

These options are intended to be used when you are using NSS pools with Novell Cluster Services clusters. NCS requires that the devices be managed by EVMS. You cluster-enable the shared device by placing the Cluster Segment Manager on the device before creating the file system on it. For the NSS file system, you create the clustered pool on the shared device and manage it with NSS management tools, such as NSSMU or the Storage plug-in to Novell iManager.

IMPORTANT:The shared state is not viable for NSS on non-EVMS-managed devices, because NCS currently requires the Cluster Segment Manager and EVMS.

B.7.4 Example

Open a terminal console, then log in as the root user to use this command.

nssupdate -pool puserdata -size 2147483648

Resizes the pool named puserdata to 2 GB (where 1 GB is 1024E3 (10243) bytes or 1,073,741,824 bytes).