A.6 Cache Management Commands (NetWare)

Use the commands in this section to manage the cache for NSS volumes on NetWare.

WARNING:If you give NSS more memory than you allow for the NetWare server, NSS fails to load. Your NSS-based sys: volume becomes inoperable until you load the c:nwserver\server.exe with an NSS override to correct the situation. For information, see Section A.1.2, Issuing NSS Commands at Server Startup (NetWare).

A.6.1 Buffer Cache Commands

nss /(No)CacheBalance=value

Enables the dynamic balancing of free memory for the NSS buffer cache. Sets the specified percentage of free kernel memory that NSS uses for its buffer cache.

Default: 85

Range: 1 to 99

nss /MinBufferCacheSize=value

Sets the specified minimum number of NSS buffer cache entries.

Default: 512 for NSS on NetWare

Range: 384 for NSS on NetWare to the amount of memory in KB divided by 4 KB (the block size). For a 32-bit machine, the maximum setting is 250000 buffers.

nss /MinOSBufferCacheSize=value

Sets the specified minimum number of NetWare buffer cache entries.

Default: 256

Range: 256 to memory size in KB/4KB

nss /CacheUserMaxPercent=value

Sets the specified maximum percentage of buffer cache that can be used for user data.

Default: 80

Range: 10 to 100

A.6.2 File Cache Commands

nss /ClosedFileCacheSize=value

Sets the number of closed files that can have their storage objects cached in memory. On average, each Closed File Cache entry consumes 0.4 to 1KB of RAM.

Default: 50000

Range: 16 to 1000000

Recommended: 100000

nss /(No)ClientFileCaching

Enable or disable client-side caching of opened files.

Default: On

A.6.3 Extended System Memory (ESM) Commands

Extended system memory (ESM) is the memory above 4 GB. By default, NSS on NetWare servers uses 80% of the ESM to cache user data for files greater than 128 KB in size. Only files with an End-of-File (EOF) files size greater than or equal to 128KB can be stored by ESM. To use ESM, the LSS must call it. ESM is called only by ZLSS and the cddvd LSSs. For example, large DOSFAT files are not stored in ESM memory.

/Above4GigMemoryPercent=value

Specifies the percentage of extended system memory used. This value can be set only at initialization time by adding the Above4GigMemoryPercent option in the nssstart.cfg file of the NetWare server.

nss /Above4GigMemoryPercent=value

For example:

nss /Above4GigMemoryPercent=90

Additional NSS command line options for managing NSS usage of ESM are:

/TrackESMCachePerf

Enables monitoring of the NSS ESM.

nss /TrackESMCachePerf
/NoTrackESMCachePerf

Disables monitoring of the NSS ESM.

nss /NoTrackESMCachePerf
/ESMCachePerf

Prints the statistics for NSS ESM.

nss /ESMCachePerf

A.6.4 ID Cache Commands

Use the following command to synchronize the cache of eDirectory IDs that is maintained for controlling access to NSS volumes.

nss /IDCacheResetInterval=value

Set the number of seconds between invalidation of the ID cache.

Default: 90000

Range: 0 to 200000000

ResetIDCache

Reset the various eDirectory ID caches.

If you Linux-enable a user who has been logged into the system before being Linux-enabled, make sure execute the resetidcache command from the NSS Console (nsscon) utility afterwards. This allows the proper reporting of ownership because it resets the mapping of user identities in the ID cache and forces it to update with the Linux UID for the user.

A.6.5 Name Cache Command

nss /NameCacheSize=value

Sets the specified maximum number of Name cache entries.

Default: 100000

Range: 17 to 1000000

A.6.6 Time Cache Command

ResetCachedTimes

Reset the various system caching for time conversions.

A.6.7 Cache Monitoring Commands

CacheStats

Shows the caching statistics for buffers.

FileCacheStats

Shows the caching statistics for file system objects.

NameCacheStats

Shows the caching statistics for names.

ResetStats

Resets caching and file statistics.