Project

General

Profile

Actions

Documentation #58393

open

nfs docs should mention idmap issue, refer to external tools/setup

Added by Dan Mick over 1 year ago. Updated over 1 year ago.

Status:
New
Priority:
Normal
Assignee:
Category:
NFS (Linux Kernel)
Target version:
-
% Done:

0%

Tags:
Backport:
Reviewed:
Affected Versions:
Labels (FS):
Pull request ID:

Description

I tried to use an NFS mount set up by others, and the files in it were owned by root:root in the underlying cephfs. Unsurprisingly, without any help, the nfs mount ended up presenting those as nobody:nogroup, and I could not read them. Because I grew up on Sun NFS systems and had a lot of past experience with various levels of idmap, I knew to start looking for solutions with "idmap" as a keyword; even so, it took a long time to dig through information, bouncing off rpc.idmapd, idmapd.conf, and nfsidmap before discovering what needed configuration.

It seems like at least mentioning these mechanisms in the upstream documentation would be worthwhile. Granted, explaining and documenting the entire idmap administration process is overkill, but at least the equivalent of a "SEE ALSO" would allow NFS (and other external filesystem-with-id-mapping-issues) noobs to have a chance of success.

Actions #1

Updated by Venky Shankar over 1 year ago

Dan Mick wrote:

I tried to use an NFS mount set up by others, and the files in it were owned by root:root in the underlying cephfs. Unsurprisingly, without any help, the nfs mount ended up presenting those as nobody:nogroup, and I could not read them. Because I grew up on Sun NFS systems and had a lot of past experience with various levels of idmap, I knew to start looking for solutions with "idmap" as a keyword; even so, it took a long time to dig through information, bouncing off rpc.idmapd, idmapd.conf, and nfsidmap before discovering what needed configuration.

It seems like at least mentioning these mechanisms in the upstream documentation would be worthwhile. Granted, explaining and documenting the entire idmap administration process is overkill, but at least the equivalent of a "SEE ALSO" would allow NFS (and other external filesystem-with-id-mapping-issues) noobs to have a chance of success.

Jeff,

This isn't related to NFS client as such - any pointers related to the above that would make our docs better would be great.

Actions #2

Updated by Venky Shankar over 1 year ago

  • Assignee set to Jeff Layton

(temp assigning to Jeff, so that its notified)

Actions

Also available in: Atom PDF