Skip to content

ece medium and large installation instructions improved #2146

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jul 24, 2025
Merged

ece medium and large installation instructions improved #2146

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
b37d5e7
ece medium and large installation instructions improved
eedugon Jul 16, 2025
ca109db
Update deploy-manage/deploy/cloud-enterprise/deploy-large-installatio…
eedugon Jul 17, 2025
d64aa42
ece large and medium instructions gaps fixed
eedugon Jul 17, 2025
496f3be
ece large and medium instructions gaps fixed
eedugon Jul 17, 2025
ce8fded
Merge branch 'main' into ece_install_remove_role
eedugon Jul 18, 2025
71dc97c
Update deploy-manage/deploy/cloud-enterprise/deploy-large-installatio…
eedugon Jul 24, 2025
a6d8c51
Merge branch 'main' into ece_install_remove_role
eedugon Jul 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 13 additions & 3 deletions deploy-manage/deploy/cloud-enterprise/deploy-large-installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand Down Expand Up @@ -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).
Once the installation is complete, you can continue with [](./post-installation-steps.md).
16 changes: 13 additions & 3 deletions deploy-manage/deploy/cloud-enterprise/deploy-medium-installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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).
Once the installation is complete, you can continue with [](./post-installation-steps.md).
Loading