A.37 Volume Management Commands

A.37.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.12, 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
DATA1                    ACTIVE       Salvage
                                      Compression
                                      Data Shredding
DATA2                    ACTIVE       Salvage
VOL1                     ACTIVE       Salvage
                                      User Space Restrictions
                                      Directory Quotas
VOL2                     ACTIVE        Salvage

The following volume attributes are displayed:

A.37.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.37.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 on Linux 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.

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.

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.37.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.