Bug 2121576

Summary: Document NFS filesystem limited re-export support
Product: Red Hat Enterprise Linux 9 Reporter: Dave Wysochanski <dwysocha>
Component: DocumentationAssignee: Michal Stubna <mstubna>
Documentation sub component: default QA Contact: RHEL DPM <rhel-docs>
Status: CLOSED WONTFIX Docs Contact:
Severity: medium    
Priority: medium CC: fsorenso, mstubna, rhel-docs, tcapek
Version: 9.2Keywords: Documentation, Triaged
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: No Doc Update
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2022-12-08 13:25:17 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:
Bug Depends On: 2006399, 2094072, 2121565, 2121567, 2121571, 2150887    
Bug Blocks:    

Description Dave Wysochanski 2022-08-25 20:27:48 UTC 
Document URL: 
Somewhat TBD but I think this probably is the best location:
https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_using_network_file_services/exporting-nfs-shares_configuring-and-using-network-file-services

The other possibility is somewhere in here:
https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/managing_file_systems/index


Section Number and Name: 

Describe the issue: 
The NFS team intends to have limited re-export support of NFS shares supported in an upcoming RHEL9 release (current target is RHEL9.2).  We need to document this a bit in our official documentation.

Suggestions for improvement: 

Additional information: 
Other reference information that may be of use:
- kernel documentation (see https://bugzilla.redhat.com/show_bug.cgi?id=2006399) though this file is inside an kernel-doc RPM so it may not be as accessible
- a kbase: https://access.redhat.com/solutions/6973264
Comment 1 Dave Wysochanski 2022-09-23 14:27:13 UTC 
Cut pasting from previous kernel-doc bug
Comment 2 Dave Wysochanski 2022-09-28 13:13:19 UTC 
Please note in the documentation for this feature that NFS4.0 is not supported.  For explanation of why, see https://bugzilla.redhat.com/show_bug.cgi?id=2121571#c10
Comment 3 Dave Wysochanski 2022-11-16 20:32:20 UTC 
I think we should make it clear this is a "Technology Preview" feature [1][2], and document limitations and pitfalls where possible.
[1] https://access.redhat.com/solutions/21101
[2] https://access.redhat.com/support/offerings/techpreview
Comment 5 Dave Wysochanski 2022-11-17 18:36:08 UTC 
Note that RHEL8 already has a RHEL-only patch to throw a "Tech Preview" warning if someone uses reexport, for more info see https://bugzilla.redhat.com/show_bug.cgi?id=1972229