Bug 1661949

Summary:	[DOCS] Disable NFSv4 idmapping shows incorrect command for clients as path differs for servers and clients.
Product:	OpenShift Container Platform	Reporter:	Joel Rosental R. <jrosenta>
Component:	Documentation	Assignee:	Bob Furu <bfuru>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Liang Xia <lxia>
Severity:	low	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	low
Version:	3.11.0	CC:	aos-bugs, jokerman, mmccomas, wsun
Target Milestone:	---
Target Release:	3.11.z
Hardware:	Unspecified
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2020-03-03 20:05:48 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Joel Rosental R. 2018-12-24 18:19:24 UTC

Document URL: 
https://docs.openshift.com/container-platform/3.11/install_config/persistent_storage/persistent_storage_nfs.html#nfs-additional-config-and-troubleshooting

Section Number and Name: 
Additional Configuration and Troubleshooting

Describe the issue: 
This section suggests that in order to disable ID mapping on NFSv4 on both server and client the following command should be executed:

`# echo 'Y' > /sys/module/nfsd/parameters/nfs4_disable_idmapping`

However, as stated in the KCS article mentioned above the paths are different for server and clients:

NFS client 
 # echo 'Y' > /sys/module/nfs/parameters/nfs4_disable_idmapping 

NFS server
 # echo 'Y' > /sys/module/nfsd/parameters/nfs4_disable_idmapping 

Suggestions for improvement: 
See above.

Additional information:

Comment 1 Joel Rosental R. 2018-12-24 18:20:38 UTC

Forgot to mention, same error is present in previous product pages:

https://docs.openshift.com/container-platform/3.10/install_config/persistent_storage/persistent_storage_nfs.html#nfs-additional-config-and-troubleshooting
https://docs.openshift.com/container-platform/3.9/install_config/persistent_storage/persistent_storage_nfs.html#nfs-additional-config-and-troubleshooting
https://docs.openshift.com/container-platform/3.7/install_config/persistent_storage/persistent_storage_nfs.html#nfs-additional-config-and-troubleshooting

etc.

Comment 2 Bob Furu 2020-02-24 20:27:51 UTC

Created https://github.com/openshift/openshift-docs/pull/19968

Once approved, merge to master-3 and CP to enterprise-3.11

Added additional command added to show methods for both client and server, as described in bug.

@jrosenta - We are only supporting OCP 3.11 branch, so this was not backported to versions prior. PTAL to confirm this is correct.

@liangxia PTAL or let me know who from QE can review. Thanks.

Comment 3 Liang Xia 2020-02-25 02:08:43 UTC

The change looks good.

Comment 4 Bob Furu 2020-03-03 16:56:21 UTC

Out for peer review

Comment 5 Bob Furu 2020-03-03 20:05:48 UTC

Peer review complete. Merged to master-3 and CP to enterprise-3.11.

Verified published docs are live:
https://docs.openshift.com/container-platform/3.11/install_config/persistent_storage/persistent_storage_nfs.html#nfs-additional-config-and-troubleshooting

Closing bug.

Comment 6 Red Hat Bugzilla 2023-09-15 00:14:47 UTC

The needinfo request[s] on this closed bug have been removed as they have been unresolved for 500 days