NAME
setoncenv — NFS environment configuration command
SYNOPSIS
/usr/sbin/setoncenv
[-a][v]
variable
value
/usr/sbin/setoncenv
-l[v]
[subsystem|variable]
/usr/sbin/setoncenv
-r[v]
variable
[value]
DESCRIPTION
setoncenv
initializes, displays, and removes the value of NFS configuration
variables, found either in
/etc/rc.config.d/nfsconf,
or
/etc/rc.config.d/namesvrs.
The value can be an integer or a string and should be consistent with the
variable being set.
There is limited validation of the value parameter.
Quotes should be avoided unless the value can have white space; then quotes
should be used.
The
setoncenv
command can also be used to display the NFS kernel tunable variables.
Options
setoncenv
recognizes the following options:
- -a
Add a supported configuration variable, or change the value of an
existing configuration variable in the configuration file.
The
-a
option cannot be used to set a kernel tunable variable.
You must use
kctune
to manage kernel tunable variables.
- -l
Display the values of all configuration variables and kernel tunable variables
supported by
setoncenv.
Optionally you can specify either a subsystem or an individual variable.
- -r
Remove or comment out a configuration variable in a configuration file.
The
setoncenv
command will not remove or comment out variables from
/etc/rc.config.d/nfsconf
or
/etc/rc.config.d/namesvrs,
except
LOCKD_PORT,
STATD_PORT,
and
MOUNTD_PORT
configuration variables from
/etc/rc.config.d/nfsconf.
It also cannot be used to remove kernel tunable variables.
- -v
Provide verbose output.
NOTE:
Using a command or editor other than
setoncenv
to modify the supported configuration files can cause problems if
used simultaneously.
The
setoncenv
command will attempt to correct some issues, such as duplicate entries
where duplicate entries are not allowed, but there is no guarantee that
setoncenv
can recover a configuration file once the file has been edited
by another process.
In the event of duplicate entries in the
/etc/rc.config.d/nfsconf
and
/etc/rc.config.d/namesvrs
configuration files,
the last entry is the value used.
The
setoncenv
command recognizes the following subsystem names:
- autofs
Display all variables associated with the AutoFS subsystem.
- key
Display all variables associated with the KEY (see
keyserv(1M))
subsystem.
- klm
Display all variables associated with the Kernel Lock Manager subsystem.
- krpc
Display all variables associated with the kernel RPC subsystem.
- nfs
Display all variables associated with the NFS subsystem.
- nis
Display all variables associated with the NIS subsystem.
- nisplus
Display all variables associated with the NISPLUS subsystem.
The
setoncenv
command recognizes the following configuration variable names for the
AutoFS subsystem:
- AUTO_MASTER [path]
The location of the default auto_master file.
- AUTOFS [0 | 1]
Used to enable or disable the AutoFS service during system startup.
Allowed values are 0 to disable the service or 1 to enable the service.
- AUTOMOUNT_OPTIONS [option_string]
The run time arguments for the
automount
command used by
/sbin/init.d/nfs.client.
- AUTOMOUNTD_OPTIONS [option_string]
The run time arguments for the
automount
daemon used by
/sbin/init.d/nfs.client.
The
setoncenv
command recognizes the following configuration variable names for the
KEY subsystem:
- KEYSERV_OPTIONS [option_string]
The run time arguments for the
keyserv
daemon used by
/sbin/init.d/nis.client
or
/sbin/init.d/nis.server.
The
setoncenv
command recognizes the following configuration variable names for the
Kernel Lock Manager subsystem:
- LOCKD_OPTIONS [option_string]
The run time arguments for the
rpc.lockd
daemon used by
/sbin/init.d/nfs.client
or
/sbin/init.d/nfs.server.
- LOCKD_PORT [number]
The port number
rpc.lockd
should use for listening for incoming requests.
This variable will be obsolete in a future release.
- STATD_OPTIONS [option_string]
The run time arguments for the
rpc.statd
daemon used by
/sbin/init.d/nfs.client
or
/sbin/init.d/nfs.server.
- STATD_PORT [number]
The port number
rpc.statd
should use for listening for incoming requests.
The
setoncenv
command recognizes the following kernel tunable variable names
for the kernel RPC (KRPC) subsystem (a complete description of all KRPC kernel
tunable variables can be found in the
Managing NFS and KRPC Kernel Configurations in HP-UX 11i v2
white paper at http://docs.hp.com):
- rpc_clnt_idle_timeout
Controls the amount of time on the client a connection can stay idle
before being closed.
- rpc_clnt_max_conns
Controls the number of TCP connections between an NFS client and
an NFS server.
- rpc_svc_cltsmaxdupreqs
Controls the size of the duplicate request cache over UDP.
- rpc_svc_cotsmaxdupreqs
Controls the size of the duplicate request cache over TCP.
- rpc_svc_maxthreads
Sets a limit on the maximum number of threads that an NFS server
can launch to service NFS requests for a single TCP connection.
This tunable will be obsolete in a future release.
- rpc_svc_idle_timeout
Controls the amount of time a connection on the server can stay idle
before being closed.
- rpc_svc_nfs_cpu_bind_method
Specifies whether NFS/TCP service threads are bound to specific CPUs or
can bind to any available CPU.
This tunable will be obsolete in a future release.
The
setoncenv
command recognizes the following configuration variable names for the NFS
subsystem:
- MOUNTD_OPTIONS [option_string]
The run time arguments for the
rpc.mountd
daemon used by
/sbin/init.d/nfs.server.
- MOUNTD_PORT [number]
The port number
rpc.mountd
should use for listening for incoming requests.
- NFS_CLIENT [0 | 1]
Used to enable or disable the NFS client service by
/sbin/init.d/nfs.client.
Can either be 0 to disable or 1 to enable the service.
- NFS_SERVER [0 | 1]
Used to enable or disable the NFS server service by
/sbin/init.d/nfs.server.
Can either be 0 to disable or 1 to enable the service.
- PCNFS_SERVER [0 | 1]
Used to enable or disable the
pcnfsd
daemon by
/sbin/init.d/nfs.server.
- START_MOUNTD [0 | 1]
Used to enable or disable the
rpc.mountd
daemon by
/sbin/init.d/nfs.server.
- NUM_NFSD [number]
Number of NFS deamons
(nfsd)
to start on an NFS server.
The default is 16.
This variable will be obsolete in a future release.
- NUM_NFSIOD [number]
Number of NFS BIO daemons
(biod)
to start on an NFS client.
The default is 16.
This variable will be obsolete in a future release.
The
setoncenv
command recognizes the following kernel tunable variable names for the
NFS subsystem (a complete description of all NFS kernel tunable variables
can be found in the
Managing NFS and KRPC Kernel Configurations in HP-UX 11i v2
white paper at http://docs.hp.com):
- nfs2_do_symlink_cache
Used to enable or disable the symbolic link cache for NFS version 2
mounted file systems.
- nfs2_dynamic
Used to enable or disable dynamic retransmission for NFS version 2
mounted file systems.
- nfs2_shrinkreaddir
Limit the size of a READDIR request to be no greater than 1024 bytes
of directory information.
- nfs3_do_readdirplus
Control the ability to turn off the NFS version 3 readdirplus
functionality on the NFS server.
- nfs3_do_symlink_cache
Used to enable or disable the symbolic link cache for NFS version 3
mounted file systems.
- nfs3_dynamic
Used to enable or disable dynamic retransmission for NFS version 3
mounted file systems.
- nfs3_jukebox_delay
Controls the length of time the NFS version 3 client waits before
re-transmitting a request after receiving the error
NFS3ERR_JUKEBOX.
- nfs3_max_transfer_size
Controls the size of the data portion of an NFS version 3 READ, WRITE,
READDIR, or READDIRPLUS request.
- nfs3_max_transfer_size_clts
Controls the size of the data portion of an NFS version 3 READ, WRITE,
READDIR, or READDIRPLUS request over UDP.
- nfs3_max_transfer_size_cots
Controls the size of the data portion of an NFS version 3 READ, WRITE,
READDIR, or READDIRPLUS request over TCP.
- nfs_nrnode
Controls the size of the rnode cache on the NFS version 2 and
version 3 client.
- nfs_async_read_avoidance_enabled
Enables users to configure their NFS clients to allow applications to
send NFS READ calls on their own behalf, when all the biods are busy.
This tunable will be obsolete in a future release.
- nfs_clnt_avoid_write_copy
An unnecessary copy of data to XDR buffers impacts the write performance
of NFS.
Enabling the
nfs_clnt_avoid_write_copy
tunable avoids this copy
and improves the write performance of NFS.
This tunable will be obsolete in a future release.
- nfs_do_purge_rddir_cache
Controls how an NFS client manages the readdir cache contents.
This tunable will be obsolete in a future release.
- nfs_fine_grain_fs_lock
Enabling this tunable reduces the occurrence of alpha semaphore contention
in NFS file operations that are performed serially.
This tunable will be obsolete in a future release.
- nfs_new_lock_code
Controls the performance of asynchronous I/O against files that are
locked on NFS filesystems.
This tunable will be obsolete in a future release.
- nfs_new_rnode_lock_code
Allows the threads that are waiting for an rnode lock to sleep interruptibly
or noninterruptibly.
This tunable will be obsolete in a future release.
- nfs_posix_pathconf_chown
Controls whether or not the function calls pathconf and fpathconf conform
to POSIX standard when called over NFS filesystems.
This tunable will be obsolete in a future release.
- nfs_wakeup_one
Enables you to specify whether the NFS client must activate all NFS threads
or only a single NFS thread waiting for the same rnode lock.
It also enables
you to specify whether the NFS client must activate all sleeping biods or
only a single sleeping biod while servicing a new request.
This tunable will be obsolete in a future release.
- nfs3_hacc_size
Allows you to specify the number of hash buckets to be used by
the NFS v3 access cache.
This tunable will be obsolete in a future release.
- nfs3_new_acache
Allows you to specify which search algorithm (linear or hashed) to use to
find an entry in the access cache.
This tunable will be obsolete in a future release.
- nfs_portmon
Used to enable or disable the check to verify that the source port
is a reserved port.
- nfs_exportfs_rwlock
Allows you to use either hashed exclusive spinlocks or hashed reader/writer
spinlocks to protect the exportfs table.
This tunable will be obsolete in a future release.
- nfs_srv_read_copy_avoid
An unnecessary copy of data to XDR buffers impacts the read performance
of NFS.
Enabling this tunable avoids this copy and may improve the read
performance of NFS.
This tunable will be obsolete in a future release.
- nfs3_adaptive_cache_validate
Used to enable or disable write WCC (weak cache consistency) check
when a write is followed by a read.
Also, check for cache and invalidate
the same in case of read before write.
This tunable will be obsolete in a future release.
The
setoncenv
command recognizes the following configuration variable names for the
NIS subsystem:
- MAX_NISCHECKS [number]
The maximum number of times the NIS client should attempt to contact
an NIS server before failing.
This variable is used during system startup.
- NIS_CLIENT [0 | 1]
Used to enable or disable the NIS client during system startup.
Can either be 0 to disable or 1 to enable the service.
- NIS_DOMAIN [domain_string]
Used to set the domain name by
/sbin/init.d/nis.server
and
/sbin/init.d/nis.client.
- NIS_MASTER_SERVER [0 | 1]
Used to enable or disable the NIS Master Server by
/sbin/init.d/nis.server.
Can either be 0 to disable or 1 to enable the service.
- NIS_SLAVE_SERVER [0 | 1]
Used to enable or disable the NIS Slave Server by
/sbin/init.d/nis.server.
Can either be 0 to disable or 1 to enable the service.
- YPBIND_OPTIONS [option_string]
The run time arguments for the
ypbind
daemon used by
/sbin/init.d/nis.client.
- YPPASSWDD_OPTIONS [option_string]
The run time arguments for the
rpc.yppasswdd
daemon used by
/sbin/init.d/nis.server.
- YPSERV_OPTIONS [option_string]
The run time arguments for the
ypserv
daemon used by
/sbin/init.d/nis.server.
- YPSET_ADDR [string]
This sets the IP address of an NIS server that the client should
bind to.
This value is used by
/sbin/init.d/nis.client.
- YPUPDATED_OPTIONS [option_string]
The run time arguments for the
rpc.ypupdated
daemon used by
/sbin/init.d/nis.server.
- YPXFRD_OPTIONS [option_string]
The run time arguments for the
ypxfrd
daemon used by
/sbin/init.d/nis.server.
The
setoncenv
command recognizes the following configuration variable names for the
NISPLUS subsystem:
- NISPLUS_CLIENT [0 | 1]
Used to enable or disable the NISPLUS client by
/sbin/init.d/nisplus.client.
Can either be 0 to disable or 1 to enable the service.
This variable will be obsolete in a future release.
- NISPLUS_SERVER [0 | 1]
Used to enable or disable the NISPLUS server by
/sbin/init.d/nisplus.server.
Can either be 0 to disable or 1 to enable the service.
This variable will be obsolete in a future release.
- NIS_CACHEMGR_OPTIONS [option_string]
The run time arguments for the
nis_cachemgr
daemon used by
/sbin/init.d/nisplus.client.
This variable will be obsolete in a future release.
- RPC_NISD_OPTIONS [option_string]
The run time arguments for the
rpc.nisd
daemon used by
/sbin/init.d/nisplus.server.
This variable will be obsolete in a future release.
- EMULYP [option_string]
The run time arguments for the
rpc.nisd
daemon used by
/sbin/init.d/nisplus.server.
This variable will be obsolete in a future release.
WARNINGS
HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
supported.
Some of the configuration variables and tunables are
introduced in patches.
Please install NFS cumulative patch
PHNE_35960
or later,
Kernel RPC cumulative patch
PHNE_34549
or later,
and Lock Manager cumulative patch
PHNE_34551
or later to ensure all of the configuration variables and tunables mentioned
are available.
AUTHOR
setoncenv
was developed by the Hewlett-Packard Company.
SEE ALSO
automount(1M),
automountd(1M),
kctune(1M),
keyserv(1M),
lockd(1M),
mount_nfs(1M),
mountd(1M),
nfsd(1M),
nis_cachemgr(1M),
pcnfsd(1M),
rpc.nisd(1M),
rpcbind(1M),
statd(1M),
syslogd(1M),
yppasswdd(1M),
ypserv(1M),
ypupdated(1M),
rc.config(4),
nfs(7).
