Bug 2196248 - [docs] Add docs module for confirming jumbo frames are working
Summary: [docs] Add docs module for confirming jumbo frames are working
Keywords:
Status: NEW
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 16.0 (Train)
Hardware: Unspecified
OS: Unspecified
low
unspecified
Target Milestone: ---
: ---
Assignee: Erin Peterson
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-05-08 13:01 UTC by John Fulton
Modified: 2023-06-19 16:58 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed:
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker OSP-24835 0 None None None 2023-05-08 13:05:00 UTC

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


Note You need to log in before you can comment on or make changes to this bug.