.\" Man page generated from reStructuredText.
.
.TH "GANESHA-CORE-CONFIG" "8" "Jan 20, 2023" "" "NFS-Ganesha"
.SH NAME
ganesha-core-config \- NFS Ganesha Core Configuration File
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.nf
/etc/ganesha/ganesha.conf
.fi
.sp
.SH DESCRIPTION
.sp
NFS\-Ganesha reads the configuration data from:
| /etc/ganesha/ganesha.conf
.sp
This file lists NFS related core config options.
.SS NFS_CORE_PARAM {}
.sp
Core parameters:
.INDENT 0.0
.TP
.B NFS_Port (uint16, range 0 to UINT16_MAX, default 2049)
Port number used by NFS Protocol.
.TP
.B MNT_Port (uint16, range 0 to UINT16_MAX, default 0)
Port number used by MNT Protocol.
.TP
.B NLM_Port (uint16, range 0 to UINT16_MAX, default 0)
Port number used by NLM Protocol.
.TP
.B Rquota_Port (uint16, range 0 to UINT16_MAX, default 875)
Port number used by Rquota Protocol.
.TP
.B Bind_addr(IPv4 or IPv6 addr, default 0.0.0.0)
The address to which to bind for our listening port.
.TP
.B NFS_Program(uint32, range 1 to INT32_MAX, default 100003)
RPC program number for NFS.
.TP
.B MNT_Program(uint32, range 1 to INT32_MAX, default 100005)
RPC program number for MNT.
.TP
.B NLM_Program(uint32, range 1 to INT32_MAX, default 100021)
RPC program number for NLM.
.TP
.B Drop_IO_Errors(bool, default false)
For NFSv3, whether to drop rather than reply to requests yielding I/O
errors. It results in client retry.
.TP
.B Drop_Inval_Errors(bool, default false)
For NFSv3, whether to drop rather than reply to requests yielding invalid
argument errors.  False by default and settable with Drop_Inval_Errors.
.TP
.B Drop_Delay_Errors(bool, default false)
For NFSv3, whether to drop rather than reply to requests yielding delay
errors.  False by default and settable with Drop_Delay_Errors.
.TP
.B Plugins_Dir(path, default "/usr/lib64/ganesha")
Path to the directory containing server specific modules
.TP
.B Enable_NFS_Stats(bool, default true)
Whether to collect performance statistics. By default the performance
counting is enabled. Enable_NFS_Stats can be enabled or disabled
dynamically via ganesha_stats.
.TP
.B Enable_Fast_Stats(bool, default false)
Whether to use fast stats. If enabled this will skip statistics counters
collection for per client and per export.
.TP
.B Enable_FSAL_Stats(bool, default false)
Whether to count and collect FSAL specific performance statistics.
Enable_FSAL_Stats can be enabled or disabled dynamically via ganesha_stats
.TP
.B Enable_FULLV3_Stats(bool, default false)
Whether to count and collect "detailed statistics" for NFSv3.
Enable_FULLV3_Stats can be enabled or disabled dynamically via
ganesha_stats.
.TP
.B Enable_FULLV4_Stats(bool, default false)
Whether to count and collect "detailed statistics" for NFSv4.
Enable_FULLV4_Stats can be enabled or disabled dynamically via
ganesha_stats.
.TP
.B Enable_CLNT_AllOps_Stats(bool, default false)
Whether to count and collect statistics for all NFS operations requested
by NFS clients. Enable_CLNT_AllOps_Stats can be enabled or disabled
dynamically via ganesha_stats.
.TP
.B Short_File_Handle(bool, default false)
Whether to use short NFS file handle to accommodate VMware NFS client.
Enable this if you have a VMware NFSv3 client. VMware NFSv3 client has a max
limit of 56 byte file handles.
.TP
.B Manage_Gids_Expiration(int64, range 0 to 7*24*60*60, default 30*60)
How long the server will trust information it got by calling getgroups()
when "Manage_Gids = TRUE" is used in a export entry.
.TP
.B heartbeat_freq(uint32, range 0 to 5000 default 1000)
Frequency of dbus health heartbeat in ms.
.TP
.B Enable_NLM(bool, default true)
Whether to support the Network Lock Manager protocol.
.TP
.B Blocked_Lock_Poller_Interval(int64, range 0 to 180, default 10)
Polling interval for blocked lock polling thread
.TP
.B Protocols(enum list, default [3,4,9P])
.INDENT 7.0
.TP
.B Possible values:
3, 4, NFS3, NFS4, V3, V4, NFSv3, NFSv4, 9P
.UNINDENT
.sp
The protocols that Ganesha will listen for.  This is a hard limit, as this
list determines which sockets are opened.  This list can be restricted per
export, but cannot be expanded.
.TP
.B NSM_Use_Caller_Name(bool, default false)
Whether to use the supplied name rather than the IP address in NSM
operations.
.TP
.B Clustered(bool, default true)
Whether this Ganesha is part of a cluster of Ganeshas. Its vendor specific
option.
.TP
.B fsid_device(bool, default false)
Whether to use device major/minor for fsid.
.TP
.B mount_path_pseudo(bool, default false)
Whether to use Pseudo (true) or Path (false) for NFS v3 and 9P mounts.
.sp
This option defaults to false for backward compatibility, however, for
new setups, it\(aqs strongly recommended to be set true since it then means
the same server path for the mount is used for both v3 and v4.x.
.sp
Note that as an export related option, it seems very desirable to be
able to change this on config reload, unfortunately, at the moment it
is NOT changeable on config reload. A restart is necessary to change this.
.TP
.B Dbus_Name_Prefix
DBus name prefix. Required if one wants to run multiple ganesha instances on
single host. The prefix should be different for every ganesha instance. If
this is set, the dbus name will be <prefix>.org.ganesha.nfsd
.TP
.B Enable_UDP(enum, values [False, True, Mount], default True)
Whether to create UDP listeners for Mount, NFS, NLM, RQUOTA, and register
them with portmapper. Set to false, e.g., to run as non\-root. Set to Mount
to enable only Mount UDP listener.
.TP
.B Max_Uid_To_Group_Reqs(uint32, range 0 to INT32_MAX, default 0)
Maximum number of concurrent uid2grp requests that can be made by ganesha.
In environments with a slow Directory Service Provider, where users are
part of large number of groups, and Manage_Gids is set to True, uid2grp
queries made by ganesha can fail if a large number of them are made in
parallel. This option throttles the number of concurrent uid2grp queries
that ganesha makes.
.TP
.B Enable_V3fh_Validation_For_V4(bool, default false)
Set true to enforce when v3 file handle used for v4
.TP
.B Readdir_Res_Size(uint32, range 4096 to 64*1024*1024, default 64*1024*1024)
Response size of readdir request.
Suggested values are 4096,8192,16384 and 32768. Recommended 16384(16K) if
readdir(ls command) operation performed on directory which has more files.
.TP
.B Readdir_Max_Count(uint32, range 32 to 1024*1024, default 1024*1024)
Maximum number of directory entries returned for a readdir request.
Suggested values are 4096,8192,16384 and 32768. Recommended 16384(16K) if
readdir(ls command) operation performed on directory which has more files.
.TP
.B Getattrs_In_Complete_Read(bool, default true)
Whether to call extra getattrs after read, in order to check file size and
validate the EOF flag correctness. Needed for ESXi client compatibility
when FSAL\(aqs don\(aqt set it correctly.
.UNINDENT
.SS Parameters controlling TCP DRC behavior:
.INDENT 0.0
.TP
.B DRC_Disabled(bool, default false)
Whether to disable the DRC entirely.
.TP
.B TCP_Npart(uint32, range 1 to 20, default 1)
Number of partitions in the tree for the TCP DRC.
.TP
.B DRC_TCP_Size(uint32, range 1 to 32767, default 1024)
Maximum number of requests in a transport\(aqs DRC.
.TP
.B DRC_TCP_Cachesz(uint32, range 1 to 255, default 127)
Number of entries in the O(1) front\-end cache to a TCP Duplicate Request
Cache.
.TP
.B DRC_TCP_Hiwat(uint32, range 1 to 256, default 64)
High water mark for a TCP connection\(aqs DRC at which to start retiring
entries if we can.
.TP
.B DRC_TCP_Recycle_Npart(uint32, range 1 to 20, default 7)
Number of partitions in the recycle tree that holds per\-connection DRCs so
they can be used on reconnection (or recycled.)
.TP
.B DRC_TCP_Recycle_Expire_S(uint32, range 0 to 60*60, default 600)
How long to wait (in seconds) before freeing the DRC of a disconnected
client.
.TP
.B DRC_TCP_Checksum(bool, default true)
Whether to use a checksum to match requests as well as the XID
.UNINDENT
.SS Parameters controlling UDP DRC behavior:
.INDENT 0.0
.TP
.B DRC_UDP_Npart(uint32, range 1 to 100, default 7)
Number of partitions in the tree for the UDP DRC.
.TP
.B DRC_UDP_Size(uint32, range 512, to 32768, default 32768)
Maximum number of requests in the UDP DRC.
.TP
.B DRC_UDP_Cachesz(uint32, range 1 to 2047, default 599)
Number of entries in the O(1) front\-end cache to the UDP Duplicate Request
Cache.
.TP
.B DRC_UDP_Hiwat(uint32, range 1 to 32768, default 16384)
High water mark for the UDP DRC at which to start retiring entries if we can
.TP
.B DRC_UDP_Checksum(bool, default true)
Whether to use a checksum to match requests as well as the XID.
.UNINDENT
.SS Parameters affecting the relation with TIRPC:
.INDENT 0.0
.TP
.B RPC_Max_Connections(uint32, range 1 to 10000, default 1024)
Maximum number of connections for TIRPC.
.TP
.B RPC_Idle_Timeout_S(uint32, range 0 to 60*60, default 300)
Idle timeout (seconds). Default to 300 seconds.
.TP
.B MaxRPCSendBufferSize(uint32, range 1 to 1048576*9, default 1048576)
Size of RPC send buffer.
.TP
.B MaxRPCRecvBufferSize(uint32, range 1 to 1048576*9, default 1048576)
Size of RPC receive buffer.
.TP
.B RPC_Ioq_ThrdMax(uint32, range 1 to 1024*128 default 200)
TIRPC ioq max simultaneous io threads
.TP
.B RPC_GSS_Npart(uint32, range 1 to 1021, default 13)
Partitions in GSS ctx cache table
.TP
.B RPC_GSS_Max_Ctx(uint32, range 1 to 1048576, default 16384)
Max GSS contexts in cache. Default 16k
.TP
.B RPC_GSS_Max_Gc(uint32, range 1 to 1048576, default 200)
Max entries to expire in one idle check
.UNINDENT
.SS Parameters for TCP:
.INDENT 0.0
.TP
.B Enable_TCP_keepalive(bool, default true)
Whether tcp sockets should use SO_KEEPALIVE
.TP
.B TCP_KEEPCNT(UINT32, range 0 to 255, default 0 \-> use system defaults)
Maximum number of TCP probes before dropping the connection
.TP
.B TCP_KEEPIDLE(UINT32, range 0 to 65535, default 0 \-> use system defaults)
Idle time before TCP starts to send keepalive probes
.TP
.B TCP_KEEPINTVL(INT32, range 0 to 65535, default 0 \-> use system defaults)
Time between each keepalive probe
.UNINDENT
.SS NFS_IP_NAME {}
.INDENT 0.0
.TP
.B Index_Size(uint32, range 1 to 51, default 17)
Configuration for hash table for NFS Name/IP map.
.TP
.B Expiration_Time(uint32, range 1 to 60*60*24, default 3600)
Expiration time for ip\-name mappings.
.UNINDENT
.SS NFS_KRB5 {}
.sp
\fBPrincipalName(string, default "nfs")\fP
.INDENT 0.0
.TP
.B KeytabPath(path, default "")
Kerberos keytab.
.TP
.B CCacheDir(path, default "/var/run/ganesha")
The ganesha credential cache.
.TP
.B Active_krb5(bool, default false)
Whether to activate Kerberos 5. Defaults to true (if Kerberos support is
compiled in)
.UNINDENT
.SS NFSv4 {}
.INDENT 0.0
.TP
.B Graceless(bool, default false)
Whether to disable the NFSv4 grace period.
.TP
.B Lease_Lifetime(uint32, range 0 to 120, default 60)
The NFSv4 lease lifetime.
.TP
.B Grace_Period(uint32, range 0 to 180, default 90)
The NFS grace period.
.TP
.B DomainName(string, default "localdomain")
Domain to use if we aren\(aqt using the nfsidmap.
.TP
.B IdmapConf(path, default "/etc/idmapd.conf")
Path to the idmap configuration file.
.TP
.B UseGetpwnam(bool, default false if using idmap, true otherwise)
Whether to use local password (PAM, on Linux) rather than nfsidmap.
.TP
.B Allow_Numeric_Owners(bool, default true)
Whether to allow bare numeric IDs in NFSv4 owner and group identifiers.
.TP
.B Only_Numeric_Owners(bool, default false)
Whether to ONLY use bare numeric IDs in NFSv4 owner and group identifiers.
.TP
.B Delegations(bool, default false)
Whether to allow delegations.
.TP
.B Deleg_Recall_Retry_Delay(uint32_t, range 0 to 10, default 1)
Delay after which server will retry a recall in case of failures
.TP
.B pnfs_mds(bool, default false)
Whether this a pNFS MDS server.
For FSAL Gluster, if this is true, set pnfs_mds in gluster block as well.
.TP
.B pnfs_ds(bool, default false)
Whether this a pNFS DS server.
.TP
.B RecoveryBackend(enum, default "fs")
Use different backend for client info:
.INDENT 7.0
.IP \(bu 2
fs : filesystem
.IP \(bu 2
fs_ng: filesystem (better resiliency)
.IP \(bu 2
rados_kv : rados key\-value
.IP \(bu 2
rados_ng : rados key\-value (better resiliency)
.IP \(bu 2
rados_cluster: clustered rados backend (active/active)
.UNINDENT
.TP
.B RecoveryRoot(path, default "/var/lib/nfs/ganesha")
Specify the root recovery directory for fs or fs_ng recovery backends.
.TP
.B RecoveryDir(path, default "v4recov")
Specify the recovery directory name for fs or fs_ng recovery backends.
.TP
.B RecoveryOldDir(path, "v4old")
Specify the recovery old directory name for fs recovery backend.
.TP
.B Minor_Versions(enum list, values [0, 1, 2], default [0, 1, 2])
List of supported NFSV4 minor version numbers.
.TP
.B Slot_Table_Size(uint32, range 1 to 1024, default 64)
Size of the NFSv4.1 slot table
.TP
.B Enforce_UTF8_Validation(bool, default false)
Set true to enforce valid UTF\-8 for path components and compound tags
.TP
.B Max_Client_Ids(uint32, range 0 to UINT32_MAX, default 0)
Specify a max limit on number of NFS4 ClientIDs supported by the
server. With filesystem recovery backend, each ClientID translates to
one directory. With certain workloads, this could result in
reaching inode limits of the filesystem that /var/lib/nfs/ganesha
is part of. The above limit can be used as a guardrail to prevent
getting into this situation.
.TP
.B Server_Scope(string, default "")
Specify the value which is common for all cluster nodes.
For e.g., Name of the cluster or cluster\-id.
.UNINDENT
.SS RADOS_KV {}
.INDENT 0.0
.TP
.B ceph_conf(string, no default)
Connection to ceph cluster, should be file path for ceph configuration.
.TP
.B userid(path, no default)
User ID to ceph cluster.
.TP
.B namespace(string, default NULL)
RADOS Namespace in which to store objects
.TP
.B pool(string, default "nfs\-ganesha")
Pool for client info.
.TP
.B grace_oid(string, default "grace")
Name of the object containing the rados_cluster grace DB
.TP
.B nodeid(string, default result of gethostname())
Unique node identifier within rados_cluster
.UNINDENT
.SS RADOS_URLS {}
.INDENT 0.0
.TP
.B ceph_conf(string, no default)
Connection to ceph cluster, should be file path for ceph configuration.
.TP
.B userid(path, no default)
User ID to ceph cluster.
.TP
.B watch_url(url, no default)
rados:// URL to watch for notifications of config changes. When a
notification is received, the server will issue a SIGHUP to itself.
.UNINDENT
.\" Generated by docutils manpage writer.
.