OSDOCS-2478: Multicluster console

modules/enabling-multi-cluster-console.adoc

@@ -0,0 +1,56 @@
+// Module included in the following assemblies:
+//
+// * assemblies/web-console.adoc
+
+:_content-type: PROCEDURE
+[id="enable-multi-cluster-console_{context}"]
+= Enabling multicluster in the web console
+
+:FeatureName: Multicluster console
+include::snippets/technology-preview.adoc[leveloffset=+1]
+//
+
+.Prerequisites
+* Your cluster must be using the latest version of {product-title}.
+* You must have link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.5/html/install/index[Red Hat Advanced Cluster Management (ACM) for Kubernetes 2.5] or the link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.5/html/multicluster_engine_operator/index[multiculster engine (MCE) Operator] installed.
+* You must have administrator privileges.
+
+[WARNING]
+====
+Do not set this feature gate on production clusters. You will not be able to upgrade your cluster after applying the feature gate, and it cannot be undone.
+====
+
+.Procedure
+
+. Log in to the {product-title} web console using your credentials.
+
+. Enable ACM in the administrator perspective by navigating from *Administration* -> *Cluster Settings* -> *Configuration* -> *Console* `console.operator.openshift.io` -> *Console Plugins* and click *Enable* for `acm`.
+
+. A pop-up window will appear notifying you that updating the enablement of this console plug-in will prompt for the console to be refreshed once it has been updated. Select `Enable` and click *Save*.
+
+. Repeat the previous two steps for the `mce` console plug-in immediately after enabling `acm`.
+
+. A pop-up window that states that a web console update is available will appear a few moments after you enable. Click *Refresh the web console* in the pop-up window to update.
++
+[Note]
+====
+You might see the pop-up window to refresh the web console twice if the second redeployment has not occurred by the time you click *Refresh the web console*.
+====
+
+** *local-cluster* and *All Clusters* is now visible above the perspectives in the navigation section.
+
+. Enable the feature gate by navigating from *Administration* -> *Cluster Settings* -> *Configuration* -> *FeatureGate*, and edit the YAML template as follows:
++
+[source,yaml]
+
+----
+spec:
+    featureSet: TechPreviewNoUpgrade
+----
+
+. Click *Save* to enable the multicluster console for all clusters.
++
+[IMPORTANT]
+====
+After you save, this feature is enabled and cannot be undone.
+====

modules/multi-cluster-about.adoc

@@ -0,0 +1,9 @@
+// Module included in the following assemblies:
+//
+// * assemblies/web-console.adoc
+
+:_content-type: CONCEPT
+[id="multi-cluster-about_{context}"]
+= Multicluster console
+
+The multicluster console provides a single interface with consistent design for the hybrid cloud console. If you enable the feature, you can switch between Advanced Cluster Management (ACM) and the cluster console in the same browser tab. It provides a simplified and consistent design that allows for shared components.

web_console/web-console.adoc

@@ -21,3 +21,9 @@ Platform 4.x Tested Integrations] page before you create the supporting
 infrastructure for your cluster.
 
 include::modules/web-console-overview.adoc[leveloffset=+1]
+include::modules/multi-cluster-about.adoc[leveloffset=+1]
+include::modules/enabling-multi-cluster-console.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../nodes/clusters/nodes-cluster-enabling-features.adoc[Enabling feature sets using the web console]