B.9 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 do not need to run this utility if you increase the size of a pool by using standard NSS management tools. When you work with the NSS Management Utility (NSSMU), the NLVM command line utility, or the Storage plug-in for NetIQ iManager to manage NSS pools and volumes, NSS automatically makes any necessary changes to the underlying structure of the pool.

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 NLVM, such as Linux Volume Manager 2 (LVM2). 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.9.1 Syntax

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

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

B.9.2 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, up to the size of the device. The space you designate must already be free for consumption by the pool. Make sure that you understand exactly which 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 the 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 OES 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 OES Cluster Services clusters. This requires that you use NSS partitions to create the pool. Use NSSMU, the NLVM command line utility, or the Storage plug-in to NetIQ iManager to set the device as shared and to manage the pool.

IMPORTANT:The shared state is not viable for NSS on pools created on non-NSS partitions.

B.9.3 Example

Open a terminal console, then log in as the root user to run 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).