A.38 Volume Management Commands

A.38.1 Volumes Command

NSS provides the volumes command and /volumes option for viewing a list of the currently mounted volumes, their status, and the attributes for NSS volumes. To view which attributes are currently set for a volume, enter

nss /volumes

You can also use enter the volumes command to get the same output.

The volumes utility for NCP provides additional information about the mounted volumes on a Linux server, such as its Linux path. For information, see Section B.21, volumes (NCP Console Utility).

For example, the NSS volumes command outputs state and attributes information in a tabular format:

     Volume Name           State                Attributes
-----------------------  -----------  -----------------------------------
_ADMIN                   ACTIVE       Hardlinks
                                      AD Enabled
DATA1                    ACTIVE       Salvage
                                      Trustee Index
DATA2                    ACTIVE       Salvage
                                      Compression
                                      User Space Restrictions
                                      Directory Quotas
                                      Migration
                                      Modified File List
                                      AD Enabled
                                      Trustee Index
VOL1                     ACTIVE       Salvage
                                      AD Enabled
                                      Trustee Index
VOL2                     ACTIVE       Salvage

The following volume attributes are displayed:

Attribute	For Information
Compression	Section A.6, Compression Commands
Data shredding	Section A.7, Data Shredding Commands
Directory quotas	Section A.31.2, Directory Quotas Commands
Encryption	Section A.38.3, Encrypted Volume Activity Commands
Hard links	Section A.14, NSS Media Upgrade Commands
Migration (for near-line storage support)	Section A.19, Migration Support Commands for Near-Line Storage
Modified File List (MFL)	Section A.20, Modified File List (MFL) Commands
Salvage	Section A.33, Salvage and Purge Commands
User quotas	Section A.31.3, User Quotas Commands
AD Enabled	Volume AD-enabling
Trustee Index	Trustee Index Media

A.38.2 Volume Activity Commands

nss /ExtendMac=volumename: Enable extended Macintosh name space on the specified NSS volume.
nss /ForceActivate=volumename: Forces an NSS volume to become active. For encrypted NSS volumes, this command cannot force an activation unless the volume has been previously activated with a password on the first activation after a reboot.
nss /ForceDeactivate=volumename: Forces an NSS volume to the deactive state. Does not prompt for open files.
nss /VolumeActivate=volumename: Activates the specified NSS volume.
nss /VolumeDeactivate=volumename: Deactivates the specified NSS volume.
nss /VolumeMaintenance=volumename: Places a specified volume into maintenance mode. Volumes can be put in maintenance mode, but maintenance occurs only at the storage pool level.
mount volume_name: Mount the specified unencrypted NSS volume or an encrypted NSS volume that has been previously activated with its password. If it has not been previously activated, it returns an error message, requesting more information.
mount all: Mount all unencrypted NSS volumes and all encrypted NSS volumes that have been previously activated with their passwords. Encrypted NSS volumes that were not previously activated return error messages, requesting more information.

A.38.3 Encrypted Volume Activity Commands

Use the commands in this section to display volume status and to activate, mount, deactivate, or dismount encrypted NSS volumes.

You must enter a password the first time the volume is activated or mounted following a system reboot. Thereafter, other environmental security and authentication measures control access to user data.

IMPORTANT:Use NSSMU to mount encrypted volumes the first time after a server reboot. Thereafter, you can use the Linux mount command.

You cannot use wildcard commands, such as nss /VolumeAutoActivate, to activate encrypted NSS volumes.

You cannot use the wildcard option of All as the volume name for volumes where the password has not previously been provided. Until an encrypted volume is activated with its password following each system reboot, the All option does not find the volume and does not execute the command. The system returns an error message.

nss /activate=volume_name

Activate the specified unencrypted NSS volume.

On Linux, this command cannot be used to activate encrypted NSS volumes.

nss /activate=all

Activate all unencrypted NSS volumes. On Linux, this command cannot be used to activate encrypted NSS volumes.

nss /volumeactivate=volume_name

Activate the specified unencrypted NSS volume. If you are prompted for it, enter the encryption password. The password is required only on the first activation following a system reboot.

On Linux, this command cannot be used to activate encrypted NSS volumes.

nss /volumes

View the status of an encrypted and unencrypted NSS volumes. The encrypted volume returns a status of Encrypted.

A.38.4 VolumeAuto Commands for Load Time

Use the following command to view the volume’s current load-time policies.

VolumeAutoDisplay=volumename: Displays the volume’s current load-time policies.

Use the following commands in the nssstart.cfg file to control which volumes are active at load time. You cannot use these commands for encrypted NSS volumes. You must use NSSMU to activate the volume on the first time after restart so you can provide the password.

nss /VolumeAutoActivate=volumename: Activates the specified volume at load time.
nss /VolumeAutoDeactivate=volumename: Deactivates the specified volume at load time.