Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 2196248

Summary:	[docs] Add docs module for confirming jumbo frames are working
Product:	Red Hat OpenStack	Reporter:	John Fulton <johfulto>
Component:	documentation	Assignee:	Erin Peterson <erpeters>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	16.2 (Train)	CC:	alfrgarc, erpeters, gfidente, mariel
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:	2025-01-08 18:12:58 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 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

Comment 4 John Fulton 2024-12-10 20:09:42 UTC

This is documented in RHOSO for 18 here though it's not a module.

https://docs.redhat.com/en/documentation/red_hat_openstack_services_on_openshift/18.0/html-single/deploying_a_hyperconverged_infrastructure_environment/index#con_hci-ceph-mtu-settings_osp

If you want to do this as a module and include it in other docs as originally requested, that still makes sense to me.

Thus, this could be migrated to Jira and targeted at supported versions only (e.g. 17.1 and newer).

Comment 5 Erin Peterson 2025-01-08 18:12:58 UTC

17.1 and 16.2 documentation updated with requested content and republished.

17.1
====

Deploying Red Hat Ceph Storage and Red Hat OpenStack Platform together with director:
https://docs.redhat.com/en/documentation/red_hat_openstack_platform/17.1/html/deploying_red_hat_ceph_storage_and_red_hat_openstack_platform_together_with_director/assembly_integrating-an-overcloud-with-red-hat-ceph-storage_deployingcontainerizedrhcs#proc_ceph-configure-validate-jumbo-frames_assembly_integrating-an-overcloud-with-red-hat-ceph-storage

Deploying a Distributed Compute Node (DCN) architecture:
https://docs.redhat.com/en/documentation/red_hat_openstack_platform/17.1/html/deploying_a_distributed_compute_node_dcn_architecture/preparing_overcloud_templates_for_dcn_deployment#proc_ceph-configure-validate-jumbo-frames_preparing-overcloud-templates

16.2
====

Deploying an overcloud with containerized Red Hat Ceph:
https://docs.redhat.com/en/documentation/red_hat_openstack_platform/16.2/html/deploying_an_overcloud_with_containerized_red_hat_ceph/assembly_integrating-an-overcloud-with-red-hat-ceph-storage_deployingcontainerizedrhcs#proc_ceph-configure-validate-jumbo-frames_assembly_integrating-an-overcloud-with-red-hat-ceph-storage

Distributed compute node and storage deployment:
https://docs.redhat.com/en/documentation/red_hat_openstack_platform/16.2/html/distributed_compute_node_and_storage_deployment/preparing_overcloud_templates_for_dcn_deployment#proc_ceph-configure-validate-jumbo-frames_preparing-overcloud-templates