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.
Category:
NFS (Linux Kernel)
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.
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.
- Assignee set to Jeff Layton
(temp assigning to Jeff, so that its notified)
Also available in: Atom
PDF