1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-06 15:46:57 +01:00
Files
openshift-docs/modules/enabling-multi-cluster-console.adoc
2023-10-30 10:13:25 -04:00

57 lines
2.4 KiB
Plaintext

// Module included in the following assemblies:
//
// * assemblies/web-console.adoc
:_mod-docs-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/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 plugin 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 plugin 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.
====