Documentation: Add an explanation of NFSv4 client identifiers
authorChuck Lever <chuck.lever@oracle.com>
Mon, 18 Apr 2022 15:58:50 +0000 (11:58 -0400)
committerAnna Schumaker <Anna.Schumaker@Netapp.com>
Tue, 17 May 2022 19:33:21 +0000 (15:33 -0400)
commita28faaddb2be19659701602fc7c9934ff5fc3fa5
treea1f392de495ed799d432f92611cb88db38b00070
parent5e12f172db9536df4720a50e8aa70c5e212c2037
Documentation: Add an explanation of NFSv4 client identifiers

To enable NFSv4 to work correctly, NFSv4 client identifiers have
to be globally unique and persistent over client reboots. We
believe that in many cases, a good default identifier can be
chosen and set when a client system is imaged.

Because there are many different ways a system can be imaged,
provide an explanation of how NFSv4 client identifiers and
principals can be set by install scripts and imaging tools.

Additional cases, such as NFSv4 clients running in containers, also
need unique and persistent identifiers. The Linux NFS community
sets forth this explanation to aid those who create and manage
container environments.

Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Signed-off-by: Anna Schumaker <Anna.Schumaker@Netapp.com>
Documentation/filesystems/nfs/client-identifier.rst [new file with mode: 0644]
Documentation/filesystems/nfs/index.rst