Documentation #58393
nfs docs should mention idmap issue, refer to external tools/setup
0%
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.
History
#1 Updated by Venky Shankar 9 months 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.
#2 Updated by Venky Shankar 9 months ago
- Assignee set to Jeff Layton
(temp assigning to Jeff, so that its notified)