From b37d5e77c54b10b0ec7f4692bc4dfbb144208897 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 16 Jul 2025 13:01:28 +0200 Subject: [PATCH 1/5] ece medium and large installation instructions improved --- .../deploy-large-installation.md | 16 +++++++++++++--- .../deploy-medium-installation.md | 16 +++++++++++++--- 2 files changed, 26 insertions(+), 6 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md index 9d4a4aeafe..5a79d615c3 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md @@ -27,6 +27,10 @@ This type of installation is recommended for deployments with significant overal :alt: A large installation with nine to twelve hosts across three availability zones ::: +::::{note} +The host with the allocator role greyed out represents the first host to be installed. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. +:::: + ## Important considerations [ece_before_you_start_3] Note that the large-sized {{ece}} installation separates the allocator and proxy roles from the director and coordinator roles (ECE management services). @@ -100,8 +104,14 @@ Make sure you have completed all prerequisites and environment preparations desc bash <(curl -fsSL https://download.elastic.co/cloud/elastic-cloud-enterprise.sh) install --coordinator-host HOST_IP --roles-token 'MY_TOKEN' --roles "proxy" --availability-zone MY_ZONE-3 --memory-settings '{"runner":{"xms":"1G","xmx":"1G"}}' ``` -6. [Change the deployment configuration](working-with-deployments.md) for the `admin-console-elasticsearch`, `logging-and-metrics`, and `security` clusters to use three availability zones and resize the nodes to use at least 4 GB of RAM. This change makes sure that the clusters used by the administration console are highly available and provisioned sufficiently. +6. [Log into the Cloud UI](log-into-cloud-ui.md). + +7. [Change the deployment configuration](/deploy-manage/deploy/cloud-enterprise/customize-deployment.md) for the `admin-console-elasticsearch`, `logging-and-metrics`, and `security` [system deployments](/deploy-manage/deploy/cloud-enterprise/system-deployments-configuration.md) to use three availability zones and resize the nodes to use at least 4 GB of RAM. This ensures the system clusters are both highly available and sufficiently provisioned. + +8. [Vacate all instances from the initial host](/deploy-manage/maintenance/ece/move-nodes-instances-from-allocators.md#move-nodes-from-allocators). This host runs some {{es}} and {{kib}} instances from system deployments, which must be moved to other allocators before proceeding. + + Wait until all instances have been moved off the initial host before continuing. -7. [Log into the Cloud UI](log-into-cloud-ui.md) to provision your deployment. +9. [Remove the `allocator` role](/deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) from the initial host. You cannot remove the role until all instances have been vacated. -Once the installation is complete, you can continue with [](./post-installation-steps.md). \ No newline at end of file +Once the installation is complete, you can continue with [](./post-installation-steps.md). diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md index 8d34c07983..a94dfef256 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md @@ -21,6 +21,10 @@ This type of installation is recommended for many production setups. You need: :alt: A medium installation with nine to twelve hosts across three availability zones ::: +::::{note} +The host with the allocator role greyed out represents the first host to be installed. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. +:::: + ## Important considerations [ece_before_you_start_2] * Monitor the load on proxies and make sure the volume of user requests routed by the proxies does not affect the resources available to the ECE management services. @@ -85,8 +89,14 @@ Make sure you have completed all prerequisites and environment preparations desc bash <(curl -fsSL https://download.elastic.co/cloud/elastic-cloud-enterprise.sh) install --coordinator-host HOST_IP --roles-token 'ALLOCATOR_TOKEN' --roles "allocator" --availability-zone MY_ZONE-3 --memory-settings '{"runner":{"xms":"1G","xmx":"1G"},"allocator":{"xms":"4G","xmx":"4G"}}' ``` -5. [Change the deployment configuration](working-with-deployments.md) for the `admin-console-elasticsearch`, `logging-and-metrics`, and `security` clusters to use three availability zones and resize the nodes to use at least 4 GB of RAM. This change makes sure that the clusters used by the administration console are highly available and provisioned sufficiently. +5. [Log into the Cloud UI](log-into-cloud-ui.md). + +6. [Change the deployment configuration](/deploy-manage/deploy/cloud-enterprise/customize-deployment.md) for the `admin-console-elasticsearch`, `logging-and-metrics`, and `security` [system deployments](/deploy-manage/deploy/cloud-enterprise/system-deployments-configuration.md) to use three availability zones and resize the nodes to use at least 4 GB of RAM. This ensures the system clusters are both highly available and sufficiently provisioned. + +7. [Vacate all instances from the initial host](/deploy-manage/maintenance/ece/move-nodes-instances-from-allocators.md#move-nodes-from-allocators). This host runs some {{es}} and {{kib}} instances from system deployments, which must be moved to other allocators before proceeding. + + Wait until all instances have been moved off the initial host before continuing. -6. [Log into the Cloud UI](log-into-cloud-ui.md) to provision your deployment. +8. [Remove the `allocator` role](/deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) from the initial host. You cannot remove the role until all instances have been vacated. -Once the installation is complete, you can continue with [](./post-installation-steps.md). \ No newline at end of file +Once the installation is complete, you can continue with [](./post-installation-steps.md). From ca109dbfa2191ac29efad96285e7293ca5c3a19a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 17 Jul 2025 18:38:58 +0200 Subject: [PATCH 2/5] Update deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md Co-authored-by: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com> --- .../deploy/cloud-enterprise/deploy-large-installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md index 5a79d615c3..0585828dd1 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md @@ -28,7 +28,7 @@ This type of installation is recommended for deployments with significant overal ::: ::::{note} -The host with the allocator role greyed out represents the first host to be installed. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. +In the diagram, the Director Coordinator host in Availability zone 1 has the allocator role greyed out. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. :::: ## Important considerations [ece_before_you_start_3] From d64aa427f9060fe140de50acd00234e521f91dc4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:13:44 +0200 Subject: [PATCH 3/5] ece large and medium instructions gaps fixed --- .../deploy-large-installation.md | 22 ++++++++++++++----- .../deploy-medium-installation.md | 2 +- 2 files changed, 17 insertions(+), 7 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md index 0585828dd1..2e9c2b7991 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md @@ -14,11 +14,11 @@ products: This type of installation is recommended for deployments with significant overall search and indexing throughput. You need: * 3 hosts with at least 64 GB RAM each for directors and coordinators (ECE management services) -* 3 hosts for allocators, each with one of the following RAM configurations: +* A minimum of 3 hosts for allocators, using one of the following configurations per availability zone: - * 1 x 256 GB RAM - * 2 x 128 GB RAM - * 4 x 64 GB RAM + * 1 host with 256 GB RAM → 3 hosts total + * 2 hosts with 128 GB RAM each → 6 hosts total + * 4 hosts with 64 GB RAM each → 12 hosts total * 3 hosts with 16 GB RAM each for proxies * 3 availability zones @@ -28,7 +28,7 @@ This type of installation is recommended for deployments with significant overal ::: ::::{note} -In the diagram, the Director Coordinator host in Availability zone 1 has the allocator role greyed out. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. +In the diagram, the Director Coordinator host in Availability zone 1, which represents the first host to be installed, has the allocator and proxy roles greyed out. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator and proxy roles will be removed from this host. :::: ## Important considerations [ece_before_you_start_3] @@ -112,6 +112,16 @@ Make sure you have completed all prerequisites and environment preparations desc Wait until all instances have been moved off the initial host before continuing. -9. [Remove the `allocator` role](/deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) from the initial host. You cannot remove the role until all instances have been vacated. +9. [Remove the `allocator` and `proxy` roles](/deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) from the initial host. You cannot remove the `allocator` role until all instances have been vacated. + + ::::{note} + After removing the proxy role from the first host, the {{es}} and {{kib}} URLs shown in the Cloud UI will stop working. This happens because the **Deployment domain name** in **Platform** > **Settings** is set to the IP address of the first host, in a format like `LOCAL_HOST_IP.ip.es.io`. For more details, refer to [Change endpoint URLs](./change-endpoint-urls.md). + + To resolve this, follow the steps in [Post-installation steps](./post-installation-steps.md) to complete the integration between your load balancer, ECE proxies, TLS certificates, and wildcard DNS record. + :::: + + ::::{tip} + If you don't yet have a load balancer, TLS certificates, or a wildcard DNS record ready, you can [change the endpoint URL](./change-endpoint-urls.md) to the IP address of one of the ECE proxies, using the format `PROXY_IP.ip.es.io`. This will allow you to continue using the deployment endpoint URLs provided by the Cloud UI. + :::: Once the installation is complete, you can continue with [](./post-installation-steps.md). diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md index a94dfef256..9ee18c67ee 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md @@ -22,7 +22,7 @@ This type of installation is recommended for many production setups. You need: ::: ::::{note} -The host with the allocator role greyed out represents the first host to be installed. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. +In the diagram, the Director Coordinator host in Availability zone 1, which represents the first host to be installed, has the allocator role greyed out. This host temporarily holds all roles until the other nodes are added and configured. Eventually, the allocator role will be removed from this host. :::: ## Important considerations [ece_before_you_start_2] From 496f3be8bdd9c121b9ca15e35bfdede6fb960984 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:21:21 +0200 Subject: [PATCH 4/5] ece large and medium instructions gaps fixed --- .../deploy/cloud-enterprise/deploy-large-installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md index 2e9c2b7991..e82d21d215 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md @@ -115,7 +115,7 @@ Make sure you have completed all prerequisites and environment preparations desc 9. [Remove the `allocator` and `proxy` roles](/deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) from the initial host. You cannot remove the `allocator` role until all instances have been vacated. ::::{note} - After removing the proxy role from the first host, the {{es}} and {{kib}} URLs shown in the Cloud UI will stop working. This happens because the **Deployment domain name** in **Platform** > **Settings** is set to the IP address of the first host, in a format like `LOCAL_HOST_IP.ip.es.io`. For more details, refer to [Change endpoint URLs](./change-endpoint-urls.md). + After removing the proxy role from the first host, the {{es}} and {{kib}} URLs shown in the Cloud UI will stop working. This happens because the **Deployment domain name** in **Platform** > **Settings** is set to the IP address of the first host, in a format like `FIRST_HOST_IP.ip.es.io`. For more details, refer to [Change endpoint URLs](./change-endpoint-urls.md). To resolve this, follow the steps in [Post-installation steps](./post-installation-steps.md) to complete the integration between your load balancer, ECE proxies, TLS certificates, and wildcard DNS record. :::: From 71dc97c9f254485f36b52ad8805f716521410ebf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Thu, 24 Jul 2025 09:10:50 +0200 Subject: [PATCH 5/5] Update deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md --- .../deploy/cloud-enterprise/deploy-large-installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md index e82d21d215..8fde07e151 100644 --- a/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md +++ b/deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md @@ -115,7 +115,7 @@ Make sure you have completed all prerequisites and environment preparations desc 9. [Remove the `allocator` and `proxy` roles](/deploy-manage/deploy/cloud-enterprise/assign-roles-to-hosts.md) from the initial host. You cannot remove the `allocator` role until all instances have been vacated. ::::{note} - After removing the proxy role from the first host, the {{es}} and {{kib}} URLs shown in the Cloud UI will stop working. This happens because the **Deployment domain name** in **Platform** > **Settings** is set to the IP address of the first host, in a format like `FIRST_HOST_IP.ip.es.io`. For more details, refer to [Change endpoint URLs](./change-endpoint-urls.md). + After removing the proxy role from the first host, the {{es}} and {{kib}} URLs shown in the Cloud UI will stop working. This happens because the **Deployment domain name** in **Platform** > **Settings** is set to the IP address of the first host, in the format `FIRST_HOST_IP.ip.es.io`. For more details, refer to [Change endpoint URLs](./change-endpoint-urls.md). To resolve this, follow the steps in [Post-installation steps](./post-installation-steps.md) to complete the integration between your load balancer, ECE proxies, TLS certificates, and wildcard DNS record. ::::