Bug 2196248

Summary: [docs] Add docs module for confirming jumbo frames are working
Product: Red Hat OpenStack Reporter: John Fulton <johfulto>
Component: documentationAssignee: Erin Peterson <erpeters>
Status: NEW --- QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: low    
Version: 16.0 (Train)CC: erpeters
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 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 John Fulton 2023-05-08 13:01:17 UTC
There should be a "documentation module" included in any "internal ceph documents" for all supported release of OSP (e.g. 16.2, 17.0, 17.1) which covers configuring and validating jumbo frames.

This topic is already documented prescriptively in an OSP10 reference architecture in section 5.2.2 [1].

The proposed documentation could be as simple as:

"""
If you set the MTU for the storage network to 9000, then use a command like the following from to confirm that packets of that size are able to reach their target.

ping -M do -s 8972 <STORAGE_SERVER_IP>

If the above command fails, then you may need to configure your switch.
"""


[1] https://access.redhat.com/documentation/en-us/reference_architectures/2017/html/hyper-converged_red_hat_openstack_platform_10_and_red_hat_ceph_storage_2/custom-templates#configure-environmental-networking

Comment 1 John Fulton 2023-05-08 13:01:54 UTC
This issue came up in https://bugzilla.redhat.com/show_bug.cgi?id=2193238

Comment 2 John Fulton 2023-05-08 13:18:20 UTC
(In reply to John Fulton from comment #1)
> This issue came up in Red Hat https://bugzilla.redhat.com/show_bug.cgi?id=2193238

So the proposed module needs to also be included in the DCN documenation: 

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.2/html-single/distributed_compute_node_and_storage_deployment/index