NSS

Purpose

Use the Novell^® Storage Services^TM (NSS^TM) console commands to do the following:

• Unload NSS
• Display NSS module or volume information
• Check NSS volume statistics
• Change NSS caching
• Modify other NSS tunables

Using NSS

To use the NSS console commands, enter the following at the server console:

• nss /help or nss /? opens the NSS console Help facility.
• nss /modules lists the providers, loadable storage subsystems, and semantic agents.
• nss /status lists the current NSS status.
• volumes lists all the NetWare^® volumes that are mounted and includes the NSS_Admin volume.
• nss volumes lists all the NSS volumes, including NSS_Admin.

NSS Load Commands

To use the NSS load commands, enter the following at the server console:

• help opens the NSS console Help facility.
• /? opens the NSS console Help facility.
• /(No)SkipLoadModules prevents autoloading of all the NSS modules.

NSS DOS FAT Commands

Use these NSS DOS FAT commands at the server console:

• nss /(No)FATInMemory loads the entire FAT into memory for faster access, regardless of its size. The default is OFF.
• nss /(No)FATLongNames enables long filenames on FAT volumes. The default is ON.
• nss /(No)FATLazyWrites performs lazy writes of FAT. The default is ON.
• nss /FATLazyWriteDelay=value sets the FAT lazy write delay (in seconds). The default is 60. The range is 5 to 180.
• nss /FATPartition=partition_type_number supports up to three additional partition types containing 16-bit FATs, such as /FATPartition=12,13.

PURGE and SALVAGE Commands

Both PURGE and SALVAGE commands are supported and behave almost the same in NSS as in previous versions of NetWare.

The SALVAGE command for the traditional NetWare file system and previous releases of NetWare was either turned on or off for the whole file system. In NSS, you can turn SALVAGE on or off for each NSS volume.

Use SALVAGE at the server console as follows:

• nss /salvage=all enables SALVAGE on all NSS volumes.
• nss /salvage=volume_name enables SALVAGE on the NSS volume you specify.
• nss /nosalvage=all disables SALVAGE on all NSS volumes.
• nss /nosalvage=volume_name disables SALVAGE on the NSS volume you specify.

NSS Buffer Cache Commands

Use these NSS commands at the server console to change your cache buffers:

• nss /MinBufferCacheSize sets the minimum buffer size. The default is 512. The range is 256 to 1048576. When NSS is loaded, it requires at least 512 cache buffers.
• nss /MinOSBufferCacheSize sets the minimum size for NetWare. The default is 1024. The range is 1024 to 1048576. We do not recommend that you set this value below 1024.
• nss /NameCacheSize sets the number of Name Cache entries. NSS keeps a cache of file and directory entry names it has recently looked up. This speeds up opening files and path searches. The default is 2111. The range is 3 to 65521.
• nss /(No)NameCache sets Name Cache to ON or OFF. The default is ON.
• nss /(No)CacheBalance sets the buffers to percentages rather than integers for dynamic balancing of free memory for the buffer cache. The default is ON. Use this switch with /MinBufferCacheSize.
• nss /CacheBalanceTimer sets the cache balance timer in seconds. NSS checks the total number of cache buffers in the system and determines if the CacheBalance percentage is met. NSS then gives or takes the appropriate number of cache buffers. The default is 30. The range is 1 to 3600.
• nss /AuthCacheSize sets the number of Authorization Cache entries. If many trustees have been set on different files and directories, we recommend that you increase this number. The default is 1024. The range is 16 to 50000.
• nss /BufferFlushTimer sets the Flush Time for modified cache buffers in seconds. The default is 1 second. The range is 1 to 3600 seconds.
• nss /CacheStats shows the cache buffer statistics.

Other NSS Commands

Use these NSS commands at the server console to manage NSS:

• nss /Activate=volume_name activates an NSS volume.
• nss /Deactivate=volume_name deactivates an NSS volume.
• nss /Maintenance=volume_name switches the specified NSS volume to maintenance mode.
• nss /ForceActivate=volume_name forces an NSS volume to become active.
• nss /VerifyVolume=volume_name verifies the specified NSS volume's physical integrity.
• nss /RebuildVolume=volume_name rebuilds the specified NSS volume.
• nss /RebuildVolume allows you to select an NSS volume from the menu for rebuild.
• nss /AutoVerifyVolume=volume_name allows you to verify an NSS volume at startup.
• nss /StorageResetThreshold=value allows you to reset the threshold for a low storage space warning. The default is 10. The range is 1 to 1000000.
• nss /(No)StorageAlertMessages turns ON or OFF the low storage message to users. The default is ON.
• nss /NumWorkToDo=value sets the number of WorkToDo entries which may be concurrently executing. NSS uses WorkToDo entries for tasks such as flushing file metadata to disk in the background. Increasing the number of WorkToDo entries might be useful on a system that is heavily used. NSS always reserves 20 WorkToDo entries. The default is 40. The range is 5 to 100.
• nss /FileFlushTimer=value sets the Flush Time for modified open files in seconds. Increasing this number might reduce the number of writes to disk; however, it increases the amount of data that will be lost if the system crashes. The default is 10 seconds. The range is 1 to 3600 seconds.
• nss /OpenFileHashShift=value sets the size of the Open File hash table (in powers of 2). If many files are used concurrently on the server, we recommend that you increase this number. The default is 11. The range is 8 to 20.
• nss /ClosedFileHashShift=value sets the number of closed files that can be cached in memory. The default is 512. The range is 1 to 100000.
• nss /MailBoxSize=value sets the size of your mailbox. The default is 228. The range is 64 to 256.

Additional Information