Sun Microsystems, Inc.
spacerspacer
spacer www.sun.com docs.sun.com |
spacer
black dot
 
 
3.  NFS Tunable Parameters nfssrv Module Parameters nfssrv:exi_cache_time  Previous   Contents   Next 
   
 

nfsserv:nfs_shrinkreaddir

Description

Due to a bug in the NFS version 2 server implementation, some older NFS servers can not correctly handle NFS Version 2 READDIR requests for more than 1024 bytes of directory information in certain situations. This parameter provides a workaround in the NFS Version 2 client.

If this parameter is enabled, the client does not generate a READDIR request for larger than 1024 bytes of directory information.

If this parameter is disabled, the over the wire size is set to the minimum of either the size passed in by the getdents(2) system call or NFS_MAXDATA, which is 8192 bytes.

Data Type

32-bit integer

Default

0 (disabled)

Range

0 (disabled), 1 (enabled)

Units

Boolean values

Dynamic?

Yes

Validation

None

When to Change

Examine the value of this parameter when using an older NFS Version 2 only server and interoperability problems occur when trying to read directories. Enabling this parameter might cause a slight performance drop to occur for applications that read directories.

Stability Level

Evolving

nfsserv:nfs3_shrinkreaddir

Description

A recent change to Solaris has changed the default buffer size that the readdir(3C) library support uses from 1048 bytes to 8192 bytes. This changes the number of bytes requested through the getdents(2) system call correspondingly. This in turn, translates almost directly into larger READDIR and READDIRPLUS requests made to NFS Version 3 server. This might result in interoperability problems with server implementations that cannot handle the larger request size.

Data Type

32-bit integer

Default

0 (disabled)

Range

0 (disabled), 1 (enabled)

Units

Boolean values

Dynamic?

Yes

Validation

None

When to Change

Examine the value of this parameter when using an NFS Version 3 server and interoperability problems occur when trying to read directories. Enabling this parameter might cause a slight performance drop to occur for applications that read directories.

Stability Level

Evolving

rpcmod Module Parameters

This section describes NFS parameters for the rpcmod module.

rpcmod:clnt_max_conns

Description

Controls the number of TCP connections that the NFS client uses when communicating with each NFS server. The kernel RPC is constructed so that it can multiplex RPCs over a single connection, but multiple connections can be used if desired.

Data Type

Integer (32-bit)

Default

1

Range

1 to 231 - 1

Units

Connections

Dynamic?

Yes

Validation

None

When to Change

In general, 1 connection is sufficient to achieve full network bandwidth. However, if TCP cannot utilize the bandwidth offered by the network in a single stream, then multiple connections might increase the throughput between the client and the server.

Increasing the number of connections doesn't come for free though. The price for increasing the number of connections is increased kernel resource usage to keep track of each of the connections.

Stability Level

Evolving

rpcmod:clnt_idle_timeout

Description

Controls the duration of time on the client that a connection between the client and server is allowed to remain idle before being closed.

Data Type

Long integer (32 bits on 32-bit platforms and 64 bits on 64-bit platforms)

Default

300,000 milliseconds (5 minutes)

Range

0 to 231 - 1 on 32-bit platforms

0 to 263 - 1 on 64-bit platforms

Units

Milliseconds

Dynamic?

Yes

Validation

None

When to Change

Use this parameter to change the time that idle connections are allowed to exist on the client before being closed, if desired. You might might want to close connections at a faster rate to avoid consuming system resources.

Stability Level

Evolving

rpcmod:svc_idle_timeout

Description

Controls the duration of time on the server that a connection between the client and server is allowed to remain idle before being closed.

Data Type

Long integer (32 bits on 32-bit platforms and 64 bits on 64-bit platforms)

Default

360,000 milliseconds (6 minutes)

Range

0 to 231 - 1 on 32-bit platforms

0 to 263 - 1 on 64-bit platforms

Units

Milliseconds

Dynamic?

Yes

Validation

None

When to Change

Use this parameter to change the time that idle connections are allowed to exist on the server before being closed, if desired. Close connections at a faster rate to avoid consuming system resources, if desired.

Stability Level

Evolving

 
 
 
  Previous   Contents   Next