Skip to content

Commit 395c5ee

Browse files
Merge branch 'main' into issue-5061-import-export-modify-9.0-serv
2 parents d3196e4 + 9a08b6e commit 395c5ee

29 files changed

+517
-91
lines changed
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
name: "Docs issue"
2+
description: Report documentation issues such as inaccuracies, broken links, typos, or missing information.
3+
title: "[Issue]: "
4+
labels: ["triage"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Hi 👋. Thanks for taking the time to fill out this issue report!
10+
This form will create an issue that Elastic's docs team will triage and prioritize.
11+
You can also open a PR instead.
12+
- type: dropdown
13+
attributes:
14+
label: Type of issue
15+
description: What type of issue are you reporting?
16+
multiple: false
17+
options:
18+
- Inaccurate
19+
- Missing information
20+
- I can't find what I'm looking for
21+
- Other
22+
- Other
23+
- type: input
24+
id: link
25+
attributes:
26+
label: What documentation page is affected
27+
description: Include a link to the page where you're seeing the problem.
28+
validations:
29+
required: true
30+
- type: textarea
31+
id: related
32+
attributes:
33+
label: What happened?
34+
description: Describe the issue you're experiencing. Screenshots are valuable too!
35+
validations:
36+
required: true
37+
- type: textarea
38+
id: moreinfo
39+
attributes:
40+
label: Additional info
41+
description: Anything else we should know?
42+
validations:
43+
required: false

deploy-manage/deploy/cloud-enterprise/ece-ha.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -63,12 +63,12 @@ Refer to [](../../reference-architectures.md) for information about {{es}} archi
6363

6464
You should configure and use [{{es}} snapshots](/deploy-manage/tools/snapshot-and-restore.md). Snapshots provide a way to backup and restore your {{es}} indices. They can be used to copy indices for testing, to recover from failures or accidental deletions, or to migrate data to other deployments. We recommend configuring an [{{ece}}-level repository](../../tools/snapshot-and-restore/cloud-enterprise.md) to apply across all deployments. See [Work with snapshots](../../tools/snapshot-and-restore.md) for more guidance.
6565

66-
## Furthermore considerations [ece-ece-ha-5-other]
66+
## Further considerations [ece-ece-ha-5-other]
6767

68-
* Make sure you have three Zookeepers - by default, on the Director host - for your ECE installation. Similar to three Elasticsearch master nodes can form a quorum, three Zookeepers can forum the quorum for high availability purposes. Backing up Zookeeper data directory is also recommended, read [this doc](../../../troubleshoot/deployments/cloud-enterprise/rebuilding-broken-zookeeper-quorum.md) for more guidance.
68+
* Make sure you have three Zookeepers - by default, on the Director host - for your ECE installation. Similar to three Elasticsearch master nodes can form a quorum, three Zookeepers can forum the quorum for high availability purposes. Backing up the Zookeeper data directory is also recommended: refer to [](/troubleshoot/deployments/cloud-enterprise/rebuilding-broken-zookeeper-quorum.md) for more guidance.
6969

7070
* Make sure that if you’re using a [private Docker registry server](ece-install-offline-with-registry.md) or are using any [custom bundles and plugins](../../../solutions/search/full-text/search-with-synonyms.md) hosted on a web server, that these are available to all ECE allocators, so that they can continue to be accessed in the event of a network partition or zone outage.
7171

72-
* Don’t delete containers unless guided by Elastic Support or there’s public documentation explicitly describing this as required action. Otherwise, it can cause issues and you may lose access or functionality of your {{ece}} platform. See [Troubleshooting container engines](../../../troubleshoot/deployments/cloud-enterprise/troubleshooting-container-engines.md) for more information.
72+
* Don’t delete containers unless guided by Elastic Support or there’s public documentation explicitly describing this as required action. Otherwise, it can cause issues and you may lose access or functionality of your {{ece}} platform. See [](/troubleshoot/deployments/cloud-enterprise/troubleshooting-container-engines.md) for more information.
7373

74-
If in doubt, please [contact support for help](../../../troubleshoot/deployments/cloud-enterprise/ask-for-help.md).
74+
If in doubt, please [contact support for help](/troubleshoot/index.md#contact-us).

deploy-manage/deploy/cloud-enterprise/ece-networking-prereq.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ When there are multiple hosts for each role, the inbound networking and ports ca
2323

2424
![ECE networking and ports](/deploy-manage/images/cloud-enterprise-ece-networking-ports.png "")
2525

26+
**Inbound traffic from any source**
27+
2628
| **Number** | **Host role** | **Inbound ports** | *Purpose* |
2729
| --- | --- | --- | --- |
2830
| | All | 22 | Installation and troubleshooting SSH access only (TCP)<br> |
@@ -32,11 +34,12 @@ When there are multiple hosts for each role, the inbound networking and ports ca
3234
| 3 | Proxy | 9400, 9443 | Elasticsearch Cross Cluster Search and Cross Cluster Replication with TLS authentication (9400) or API key authentication (9443), also required by load balancers. Can be blocked if [CCR/CCS](../../remote-clusters/ece-enable-ccs.md) is not used.<br> |
3335
| 7 | Coordinator | 12400/12443 | Cloud UI console to API (HTTP/HTTPS)<br> |
3436

35-
In addition to the following list, you should open 12898-12908 and 13898-13908 on the director host for ZooKeeper leader and election activity.
37+
**Inbound traffic from other ECE hosts**
3638

3739
| **Number** | **Host role** | **Inbound ports** | *Purpose* |
3840
| --- | --- | --- | --- |
3941
| 1 | Director | 2112 | ZooKeeper ensemble discovery/joining (TCP)<br> |
42+
| 1 | Director | 12898-12908, 13898-13908 | ZooKeeper leader and election activity |
4043
| 4 | Director | 12191-12201 | Client forwarder to ZooKeeper, one port per director (TLS tunnels)<br> |
4144
| 5 | Allocator | 19000-19999 | Elasticsearch node to node and Proxy to Elasticsearch for CCR/CCS (Node Transport 6.x+/TLS 6.x+)<br> |
4245
| 7 | Coordinator | 22191-22195 | Connections to initial coordinator from allocators and proxies, one port per coordinator, up to five (TCP)<br> |

deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Periodically, you might need to upgrade an Elastic Cloud Enterprise installation
1313
Before initiating the ECE upgrade process, consult the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) to make sure that the Operating System (OS) and Docker or Podman versions you run are compatible with the ECE version you’re about to upgrade to. We recommend that Docker, Podman, and the operating system be at the target version before starting the ECE upgrade procedure.
1414

1515
:::{note}
16-
During the upgrade window, there might be a short period of time during which you run a combination of versions which is not explicitly supported. For example, if you are on ECE 3.5 with Docker version 20.10 on Ubuntu 20.04, and plan to upgrade to ECE 3.7 on the same OS, you will need to upgrade Docker to version 24.0 first. In this case, and only during your upgrade window, we support the mixed OS/Docker versions. In general, this won’t be a problem. However, should anything become a blocker for the upgrade, [reach out to support for help](/troubleshoot/deployments/cloud-enterprise/ask-for-help.md).
16+
During the upgrade window, there might be a short period of time during which you run a combination of versions which is not explicitly supported. For example, if you are on ECE 3.5 with Docker version 20.10 on Ubuntu 20.04, and plan to upgrade to ECE 3.7 on the same OS, you will need to upgrade Docker to version 24.0 first. In this case, and only during your upgrade window, we support the mixed OS/Docker versions. In general, this won’t be a problem. However, should anything become a blocker for the upgrade, [reach out to support for help](/troubleshoot/index.md#contact-us).
1717
:::
1818

1919
## The upgrade version matrix [ece-upgrade-version-matrix]
@@ -43,7 +43,7 @@ The upgrade process creates a `frc-upgraders-monitor` container on the host wher
4343
* Monitor the upgrade process to ensure that all `frc-upgraders-upgrader` containers perform their part of the upgrade as expected and report their status.
4444
* After all hosts have been upgraded successfully, clean up temporary artifacts created during the upgrade process, and remove the old containers.
4545

46-
The entire process is designed to be failsafe. Containers get upgraded sequentially and the upgrade status of each container is tracked. The upgrade process also monitors that each new container is viable and continues to run as expected. If there is an issue with any part of the upgrade, [the entire process is rolled back](../../../troubleshoot/deployments/cloud-enterprise/common-issues.md#ece-troubleshooting-upgrade).
46+
The entire process is designed to be failsafe. Containers get upgraded sequentially and the upgrade status of each container is tracked. The upgrade process also monitors that each new container is viable and continues to run as expected. If there is an issue with any part of the upgrade, [the entire process is rolled back](/troubleshoot/deployments/cloud-enterprise/common-issues.md#ece-troubleshooting-upgrade).
4747

4848
## Recommendations [ece-upgrade-recommendations]
4949

@@ -101,7 +101,7 @@ If your ECE installation is still using the default, auto-generated certificates
101101
}
102102
```
103103

104-
If the license version is not 4 or higher, you must request an updated license from [Elastic Support](../../../troubleshoot/deployments/cloud-enterprise/ask-for-help.md). Once you receive your new license, make sure Elastic Cloud Enterprise is upgraded to at least version 2.5.0, and then upload the new license in the Settings page under the Platform menu.
104+
If the license version is not 4 or higher, you must request an updated license from [Elastic Support](/troubleshoot/index.md#contact-us). Once you receive your new license, make sure Elastic Cloud Enterprise is upgraded to at least version 2.5.0, and then upload the new license in the Settings page under the Platform menu.
105105

106106
In versions from 2.6 to 2.10 included, some or all platform certificates are generated with a 398-day expiration. Installations that ran on these versions, even temporarily, must have their certificates rotated manually before expiry. For details, check our [KB article](https://support.elastic.co/knowledge/ECE-Certificate-Rotation).
107107

0 commit comments

Comments
 (0)