9.2 NSS Management Utility (NSSMU) Quick Reference

The Novell Storage Services Management Utility (NSSMU) is a console-based utility for managing NSS storage media on a server. You can use NSSMU at any time as an alternative to the browser-based iManager Storage plug-in.

NSSMU is installed when you install NSS. The Linux install creates symlinks in the /opt/novell/nss/sbin folder for common NSS utilities, including NSSMU. Symlinks allow the path to NSSMU to become part of the root user’s path, which allows you to run nssmu from a terminal console as the root user.

Table 9-11 identifies key functions available in NSSMU. This quick reference is also available in the nssmu(8) man page. To access the man page, enter the following at a terminal console prompt:

man 8 nssmu

Table 9-11 Summary of Management Options in NSSMU

Management Options

Description

Devices

  • F3 = Initialize device (Do not initialize your system device.)
  • F5 = Refresh display
  • F6 = Share (shareable/not shareable for clustering)
  • Enter = Show partitions
  • Esc = Previous menu

Use this option to initialize and maintain physical storage devices and software RAID devices available to this server. Use the Software RAID Devices option to create, repair, or delete RAIDs.

Initialize the selected device by erasing its partition table, effectively destroying all of its data. If devices are present but not showing up for creating pools and volumes, you should initialize the disk.

When you initialize a device, you can select the DOS or the GUID Partition Table (GPT) partitioning scheme for a given device.

The DOS partitioning scheme supports devices up to 2 TB in size. It allows up to four partitions on a device.

The GPT partitioning scheme supports device sizes up to 2E64 sectors (that is, up to 8388608 petabytes (PB) based on the 512-byte sector size). It allows up to 128 partitions per disk. Each of its disks partitions is a logical device that is identified by a unique 128-bit (16-byte) GUID.

Partitions

  • Ins = Create an NSS partition (disabled)
  • Del = Delete an NSS partition
  • F3 = Mirror partition (that contains an existing pool)
  • F5 = Refresh details of the partition
  • F6 = Label
  • Enter =Show volumes
  • Esc = Previous menu

Use this option to display details about partitions. All types of partitions are displayed, including those for Linux file systems.

The Create option is disabled. NSS partitions are automatically created for you as you define NSS pools or software RAIDs.

You can delete a single partition at a time when repairing a failed software RAID partition. To delete all partitions for a software RAID, you should delete the RAID itself from the Software RAIDs page; otherwise, the RAID is not cleanly deleted.

The Mirror option lets you specify 1 to 3 partitions to mirror an existing partition that contains an NSS pool. Effectively, you are creating a RAID1 mirror device for the pool. Each segment of the defined RAID is a complete mirror of the original pool and is the same size as the original partition. After you mirror the partition, manage the RAID from the Software RAIDs page.

If you widen the NSSMU display screen, it widens the Partitions list panel and allows you to see the partitions' full names.

Pools

  • Ins = Create a pool
  • Del = Delete a pool
  • F3 = Expand a pool (by adding space)
  • F4 = Update NDS/eDirectory
  • F5 = Refresh the pool list
  • F6 = Rename a pool
  • F7 = Activate/deactivate a pool
  • s = Display pool segments, segment size, and devices
  • F8 = More (list more options)
  • F9 = Show deleted volumes (then salvage, purge, or pause/resume autopurging)
  • M = Move pool
  • Enter = Show volumes for a pool
  • Esc = Previous menu
  • Space = Refresh details of the selected pool

Use this option to create, delete, rename, and expand NSS storage pools to efficiently use all free space in the available devices.

After you create a pool, you can expand it by adding free space from the same or different device to increase its size. Select from the available free space to allocate it to the pool. Each device can contribute a different amount of space to the pool. Devices that contribute space must be in the same share state as the pool, that is, Shared or Not Shared. You can increase the size of a pool, but you cannot reduce it.

The move pool option moves an NSS pool from one location to another on the same system. The pool remains active during this process. All the segments in the pool are consolidated and moved to the specified device(s). If the specified device is larger than the original device, the pool is automatically expanded on the completion of move job.

If a clustered pool is moved, on performing cluster resource migration the Move pool job is resumed on other node. In the cluster setup, the exact status of the pool move can be seen only on the node where the pool move job is in progress.

For more information, see Section 15.12, Moving a Pool.

Volumes

  • Ins = Create a new volume
  • Del = Delete a volume
  • F2 = Rename mount point for the volume (new path with volume name)
  • F3 = View compression statistics
  • F4 = Update NDS/eDirectory
  • F5 = Refresh details of the volume
  • F6 = Rename volume
  • F7 = Dismount/mount a volume. If it is encrypted, the volume prompts for a password on the first mount after a system boot or reboot.
  • F8 = More (list more options)
  • F9 = Name Space - choose Long (default), UNIX, DOS, or Macintosh
  • Enter = View volume properties
  • Esc = Previous menu

Use this option to create, delete, rename, activate/deactivate, and mount/dismount NSS volumes and to set their attributes.

To store data in encrypted format, specify a password when you create the volume. This enables the Encryption attribute. The encryption setting persists for the life of the volume. The encryption password can be 2 to 16 standard ASCII characters, with a suggested minimum of 6. The password generates a 128-bit NICI key for encryption. On system reboot, specify the password when you activate the volume for the first time.

You can mount encrypted volumes only from NSSMU on the first time after a system reboot. Provide the password when needed. Until you provide a password for encrypted volumes, you cannot mount multiple encrypted volumes at a time.

Linux Volumes

  • Ins = Create
  • Del = Delete
  • F3 = Rename
  • F5 = Refresh details of the Linux volumes
  • F7 = Mount or Dismount
  • Esc = Previous menu

Use this option to create and manage the Linux volumes. For more information, see Managing Linux Volumes with NSSMU in the OES 11 SP3: Linux POSIX Volume Administration Guide.

RAID Devices

  • Ins = Create a software RAID
  • Del = Delete a software RAID device
  • F3 = Expand a RAID device (add partitions)
  • F4 = Rename a RAID device
  • F5 = Refresh details of the software RAID device
  • F6 = Restripe (to restripe or resume restriping for paused RAID 0 or RAID 5)
  • OR
  • F6 = Remirror (to remirror or resume remirroring for paused RADI 1)
  • Enter = Show segments (list member partitions for selected device)
  • Esc = Previous menu
  • F8 = More (list more options)
  • Space=Status Refresh

Use this option to create and manage NSS software RAID devices. A software RAID device emulates a hardware RAID device. RAID devices combine partitioned space on multiple physical devices into a single virtual device that you manage like any device. Each member device contributes an equal amount of space and only a single partition to the RAID.

Pressing F6 would either restripe or remirror based on the chosen RAID device.

NOTE:If the RAID 1 is already synchronized, pressing F6 will not show any remirroring progress.

Snapshot

  • Ins = Create a pool snapshot
  • Del = Delete a pool snapshot
  • F5 = Refresh display
  • F7 = Mount or dismount the pool snapshot as an active pool. The snapshot functions continue whether the snapshot is mounted or dismounted.
  • Esc = Previous menu

Use this option to create, delete, mount, and dismount pool snapshots for NSS pools.

Snapshots are stored on a separate partition that you specify, not another pool. After it is created, the partition for the snapshot pool cannot be expanded.

The default unit for setting and displaying the volume quota or pool size is Gigabyte (GB). However, the following units will also be displayed relative to the storage size:

Pool / Volume Quota Size

Displayed Unit

<= 1023 KB

KB

>= 1024 KB and <= 1023 MB

MB

>= 1024 MB and <= 1023 GB

GB

>= 1024 GB

TB

NOTE:

  • The pool size is not displayed in KB as the minimum allowed pool size should be at least 12 MB.

  • When the volume quota is entered without specifying any units, the volume quota size is assumed to be in GB. For example, specifying a value of 1 will be considered as 1 GB, 2 as 2 GB and 0.5 as 512 MB. Specifying the value of 'ALL' will create a pool consuming the entire disk space or LUN size.