Bug 2129111 - [External mode] Please document OVN specific routing requirement
Summary: [External mode] Please document OVN specific routing requirement
Keywords:
Status: NEW
Alias: None
Product: Red Hat OpenShift Data Foundation
Classification: Red Hat Storage
Component: documentation
Version: 4.10
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Anjana Suparna Sriram
QA Contact: Neha Berry
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2022-09-22 14:29 UTC by Tomas Coufal
Modified: 2023-08-09 16:43 UTC (History)
2 users (show)

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


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 2129112 0 unspecified CLOSED rook-ceph-tools is not using the same network settings as rook-ceph-operator 2023-08-09 17:00:43 UTC

Internal Links: 2129112

Description Tomas Coufal 2022-09-22 14:29:58 UTC
Describe the issue:

OVN-kubernetes is the default cluster network provider in OCP for some time now. It requires a specific setup for ODF when it is deployed in external mode. This is a common issue that should be documented in ODF docs.

Documentation should state a note or something which advises user to consider turning on routing via host if the external cluster is accessible via a private network. This is quite a common configuration especially on baremetal OCP installations. Users should execute following command:

{code}
oc patch network.operator cluster -p '{"spec":{"defaultNetwork":{"ovnKubernetesConfig":{"gatewayConfig":{"routingViaHost": true}}}}}' --type=merge
{code}

This is especially confusing since `rook-ceph-tools` pod is using different network settings, see related BZ.


Describe the task you were trying to accomplish:

Install ODF in external mode connecting it to a Ceph cluster accessible via private network configured by NMState operator.

Suggestions for improvement:

Users should execute following command:

{code}
oc patch network.operator cluster -p '{"spec":{"defaultNetwork":{"ovnKubernetesConfig":{"gatewayConfig":{"routingViaHost": true}}}}}' --type=merge
{code}

Document URL:
https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.10/html/deploying_openshift_data_foundation_in_external_mode/deploy-openshift-data-foundation-using-red-hat-ceph-storage#doc-wrapper

Chapter/Section Number and Title:
Deploying OpenShift Data Foundation in external mode > Chapter 2. Deploy OpenShift Data Foundation using Red Hat Ceph storage

Product Version: 4.10 (should apply to previous versions as well)

Environment Details: Baremetal (may be importatn 

Any other versions of this document that also needs this update:

Additional information:
https://chat.google.com/room/AAAABTq-uCM/ibDdFdKeuP4
https://chat.google.com/room/AAAABTq-uCM/xE4cR1lCRDk


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