Skip to content

Commit b9ecbc6

Browse files
committed
[D&M] Refines host maintenance, scale out installtion.
1 parent d7b964b commit b9ecbc6

File tree

2 files changed

+23
-38
lines changed

2 files changed

+23
-38
lines changed

deploy-manage/maintenance/ece/perform-ece-hosts-maintenance.md

Lines changed: 18 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -20,21 +20,18 @@ You can perform these maintenance actions on the hosts in your ECE installation
2020

2121
Which method you choose depends on how invasive your host maintenance needs to be. If your host maintenance could affect ECE, use the destructive method that first deletes the host from your installation. These methods include a step that moves any hosted Elasticsearch clusters and Kibana instances off the affected hosts and are generally considered safe, provided that your ECE installation still has sufficient resources available to operate after the host has been removed.
2222

23-
24-
## By disabling the Docker daemon [ece-perform-host-maintenance-docker-disable]
23+
## By disabling the Docker daemon [ece-perform-host-maintenance-docker-disable]
2524

2625
This method lets you perform maintenance actions on hosts without first removing the associated host from your Elastic Cloud Enterprise installation. It works by disabling the Docker daemon. The host remains a part of your ECE installation throughout these steps but will be offline and the resources it provides will not be available.
2726

2827
To perform host maintenance:
2928

3029
1. Recommended: If the host holds the allocator role and you have enough spare capacity:
31-
32-
1. [Enable maintenance mode](enable-maintenance-mode.md) on the allocator.
33-
2. [Move all nodes off the allocator](move-nodes-instances-from-allocators.md) and to other allocators in your installation. Moving all nodes lets you retain the same level of redundancy for highly available Elasticsearch clusters and ensures that other clusters without high availability remain available.
34-
35-
::::{important}
36-
Skipping Step 1 will affect the availability of clusters with nodes on the allocator.
37-
::::
30+
1. [Enable maintenance mode](enable-maintenance-mode.md) on the allocator.
31+
2. [Move all nodes off the allocator](move-nodes-instances-from-allocators.md) and to other allocators in your installation. Moving all nodes lets you retain the same level of redundancy for highly available Elasticsearch clusters and ensures that other clusters without high availability remain available.
32+
::::{important}
33+
Skipping Step 1 will affect the availability of clusters with nodes on the allocator.
34+
::::
3835

3936
2. Disable the Docker daemon:
4037

@@ -69,21 +66,18 @@ To perform host maintenance:
6966

7067
After the host shows a green status in the Cloud UI, it is fully functional again and can be used as before.
7168

72-
73-
## By deleting the host (destructive) [ece-perform-host-maintenance-delete-runner]
69+
## By deleting the host (destructive) [ece-perform-host-maintenance-delete-runner]
7470

7571
This method lets you perform potentially destructive maintenance actions on hosts. It works by deleting the associated host, which removes the host from your Elastic Cloud Enterprise installation. To add the host to your ECE installation again after host maintenance is complete, you must reinstall ECE.
7672

7773
To perform host maintenance:
7874

7975
1. If the host holds the allocator role:
80-
81-
1. [Enable maintenance mode](enable-maintenance-mode.md) on the allocator.
82-
2. [Move all nodes off the allocator](move-nodes-instances-from-allocators.md) and to other allocators in your installation. Moving all nodes lets you retain the same level of redundancy for highly available clusters and ensures that other clusters without high availability remain available.
83-
84-
::::{important}
85-
Do not skip this step or you will affect the availability of clusters with nodes on the allocator. You are in the process of removing the host from your installation and whatever ECE artifacts are stored on it will be lost.
86-
::::
76+
1. [Enable maintenance mode](enable-maintenance-mode.md) on the allocator.
77+
2. [Move all nodes off the allocator](move-nodes-instances-from-allocators.md) and to other allocators in your installation. Moving all nodes lets you retain the same level of redundancy for highly available clusters and ensures that other clusters without high availability remain available.
78+
::::{important}
79+
Do not skip this step or you will affect the availability of clusters with nodes on the allocator. You are in the process of removing the host from your installation and whatever ECE artifacts are stored on it will be lost.
80+
::::
8781

8882
2. [Delete the host from your ECE installation](delete-ece-hosts.md).
8983
3. Perform the maintenance on your host, such as enabling encryption of data at rest.
@@ -92,22 +86,19 @@ To perform host maintenance:
9286

9387
After the host shows a green status in the Cloud UI, the host is part of your ECE installation again and can be used as before.
9488

95-
96-
## By shutting down the host (less destructive) [ece-perform-host-maintenance-shutdown-host]
89+
## By shutting down the host (less destructive) [ece-perform-host-maintenance-shutdown-host]
9790

9891
This method lets you perform potentially destructive maintenance actions on hosts. It works by temporarily shutting down an ECE host, e.g. for data center moves or planned power outages. It is offered as an non-guaranteed and less destructive alternative to fully [deleting a host](#ece-perform-host-maintenance-delete-runner) from your ECE installation.
9992

10093
To shut down the host:
10194

10295
1. Disable traffic from load balancers.
10396
2. Shut down all allocators:
104-
105-
1. [Enable maintenance mode](enable-maintenance-mode.md) on the allocator.
106-
2. [Move all nodes off the allocator](move-nodes-instances-from-allocators.md) and to other allocators in your installation. Moving all nodes lets you retain the same level of redundancy for highly available clusters and ensures that other clusters without high availability remain available.
107-
108-
::::{important}
109-
Do not skip this step or you will affect the availability of clusters with nodes on the allocator. You are in the process of removing the host from your installation and whatever ECE artifacts are stored on it will be lost.
110-
::::
97+
1. [Enable maintenance mode](enable-maintenance-mode.md) on the allocator.
98+
2. [Move all nodes off the allocator](move-nodes-instances-from-allocators.md) and to other allocators in your installation. Moving all nodes lets you retain the same level of redundancy for highly available clusters and ensures that other clusters without high availability remain available.
99+
::::{important}
100+
Do not skip this step or you will affect the availability of clusters with nodes on the allocator. You are in the process of removing the host from your installation and whatever ECE artifacts are stored on it will be lost.
101+
::::
111102

112103
3. Shut down all non-director hosts.
113104
4. Shut down directors.
@@ -123,4 +114,3 @@ After performing maintenance, start up the host:
123114

124115
3. Start all remaining hosts.
125116
4. Re-enable traffic from load balancers.
126-

deploy-manage/maintenance/ece/scale-out-installation.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,11 @@ Check the available capacity:
1111

1212
1. [Log into the Cloud UI](../../deploy/cloud-enterprise/log-into-cloud-ui.md).
1313
2. From the **Platform** menu, select **Allocators** to view the available capacity.
14-
15-
Narrow the list by name, ID, or choose from several other filters. To further define the list, use a combination of filters.
16-
17-
In this case 3 GB and 6 GB on two different allocators:
18-
19-
:::{image} ../../../images/cloud-enterprise-ece-available-capacity.png
20-
:alt: The available capacity in an installation
21-
:::
22-
14+
Narrow the list by name, ID, or choose from several other filters. To further define the list, use a combination of filters.
15+
In this case 3 GB and 6 GB on two different allocators:
16+
:::{image} ../../../images/cloud-enterprise-ece-available-capacity.png
17+
:alt: The available capacity in an installation
18+
:::
2319

2420
If this is not sufficient, add more capacity to your installation:
2521

@@ -28,4 +24,3 @@ If this is not sufficient, add more capacity to your installation:
2824
* [Assign roles](../../deploy/cloud-enterprise/assign-roles-to-hosts.md) to the additional hosts. If you need to handle a larger search or logging workload, assign the new hosts the allocator role.
2925
* (Optional) [Tag allocators](../../deploy/cloud-enterprise/ece-configuring-ece-tag-allocators.md) to the new host to indicate what kind of hardware you have available.
3026
* [Resize your deployment](../../deploy/cloud-enterprise/resize-deployment.md) to handle a larger workload.
31-

0 commit comments

Comments
 (0)