Switching between external and internal ways in inter-component communication

modules/installation-guide/nav.adoc

@@ -42,6 +42,7 @@
 ** xref:installing-che-using-storage-classes.adoc[]
 ** xref:configuring-storage-types.adoc[]
 ** xref:importing-tls-certificates-to-che-server-java-truststore.adoc[]
+** xref:switching-between-external-and-internal-communication.adoc[]
 
 * xref:upgrading-che.adoc[]
 

modules/installation-guide/pages/switching-between-external-and-internal-communication.adoc

@@ -0,0 +1,7 @@
+[id="switching-between-external-and-internal-communication"]
+// = Configuring Labels
+:navtitle: Switching between external and internal ways in inter-component communication
+:keywords: installation-guide
+:page-aliases: .:switching-between-external-and-internal-communication
+
+include::partial$proc_switching-between-external-and-internal-communication.adoc[]

modules/installation-guide/partials/assembly_advanced-configuration.adoc

@@ -34,5 +34,7 @@ The next sections describe some specific user stories.
 
 * xref:importing-tls-certificates-to-che-server-java-truststore.adoc[]
 
+* xref:switching-between-external-and-internal-communication.adoc[]
+
 
 :context: {parent-context-of-configuring-che}

modules/installation-guide/partials/proc_switching-between-external-and-internal-communication.adoc

@@ -0,0 +1,33 @@
+
+[id="switching-between-external-and-internal-communication_{context}"]
+= Switching between external and internal ways in inter-component communication
+
+The communication between {prod-cli} internal components uses the internal cluster host name.
+In following situations, instead, use external {platforms-ingress} in inter-component communication:
+
+* The OpenShift instance is running multiple {prod-short} instance.
+* The environment is restricting communication between namespaces.
+
+.Prerequisites
+
+* The `{orch-cli}` tool is available.
+* An instance of {prod-short} running in {platform-name}.
+
+
+.Procedure
+
+. To use external {platforms-ingress} in inter-component communication:
++
+[subs="+quotes,+attributes"]
+----
+$ {orch-cli} patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/useInternalClusterSVCNames", "value": false}]'
+----
+
+. To use internal cluster host name in inter-component communication:
++
+[subs="+quotes,+attributes"]
+----
+$ {orch-cli} patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/useInternalClusterSVCNames", "value": true}]'
+----