Please put a notice in the Installation Guide, section "Switching between external and internal DNS names in inter-component communication" [1].

Suggested text:

-----------------------------------------------------------------------------------------------------------------------

Note: Using internal service names is incompatible with OpenShift clusters configured with the 'multi-tenant' network plugin. Red Hat recommends use of external (route) communications in that case.

-----------------------------------------------------------------------------------------------------------------------

[1] https://access.redhat.com/documentation/en-us/red_hat_codeready_workspaces/2.10/html-single/installation_guide/index#switching-between-external-and-internal-communication_crw