Skip to content

Commit 38417fd

Browse files
committed
Incorporates feedback
1 parent 73b3c58 commit 38417fd

File tree

2 files changed

+17
-5
lines changed

2 files changed

+17
-5
lines changed

deploy-manage/upgrade/deployment-or-cluster/elasticsearch.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
applies_to:
3+
deployment:
4+
self: all
5+
---
6+
17
# Upgrade {{es}} [upgrading-elasticsearch]
28

39
An {{es}} cluster can be upgraded one node at a time so upgrading does not interrupt service. Running multiple versions of {{es}} in the same cluster beyond the duration of an upgrade is not supported, as shards cannot be replicated from upgraded nodes to nodes running the older version.
@@ -14,7 +20,7 @@ To upgrade a cluster:
1420

1521
1. **Disable shard allocation**.
1622

17-
When you shut down a data node, the allocation process waits for `index.unassigned.node_left.delayed_timeout` (by default, one minute) before starting to replicate the shards on that node to other nodes in the cluster, which can involve a lot of I/O. Since the node is shortly going to be restarted, this I/O is unnecessary. You can avoid racing the clock by [disabling allocation](asciidocalypse://docs/elasticsearch/docs/reference/elasticsearch/configuration-reference/cluster-level-shard-allocation-routing-settings.md#cluster-routing-allocation-enable) of replicas before shutting down [data nodes](asciidocalypse://docs/elasticsearch/docs/reference/elasticsearch/configuration-reference/node-settings.md#data-node):
23+
When you shut down a data node, the allocation process waits for `index.unassigned.node_left.delayed_timeout` (by default, one minute) before starting to replicate the shards on that node to other nodes in the cluster, which can involve a lot of I/O. Since the node is shortly going to be restarted, this I/O is unnecessary. You can avoid racing the clock by [disabling allocation](elasticsearch://reference/elasticsearch/configuration-reference/cluster-level-shard-allocation-routing-settings.md#cluster-routing-allocation-enable) of replicas before shutting down [data nodes](elasticsearch://reference/elasticsearch/configuration-reference/node-settings.md#data-node):
1824

1925
```console
2026
PUT _cluster/settings
@@ -38,7 +44,7 @@ To upgrade a cluster:
3844
It is possible to leave your {{ml}} jobs running during the upgrade, but it puts increased load on the cluster. When you shut down a {{ml}} node, its jobs automatically move to another node and restore the model states.
3945

4046
::::{note}
41-
Any {{ml}} indices created before 8.x must be reindexed before upgrading, which you can initiate from the **Upgrade Assistant** in 8.18.
47+
Any {{ml}} indices created before 8.x must be reindexed before upgrading, which you can initiate from the **Upgrade Assistant** in 8.18. For more information, refer to [Anomaly detection results migration]
4248
::::
4349

4450

deploy-manage/upgrade/deployment-or-cluster/kibana.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
applies_to:
3+
deployment:
4+
self: all
5+
---
6+
17
# Upgrade {{kib}} [upgrade-kibana]
28

39
When you upgrade {{kib}}, you also upgrade the {{observability}} and {{elastic-sec}} solutions, which use {{kib}} as their main interface.
@@ -48,7 +54,7 @@ To upgrade {{kib}}:
4854
2. To install the `deb` or `rpm` package:
4955

5056
a. Use `rpm` or `dpkg`. This installs all files in their proper locations and will not overwrite the config files.
51-
b. Upgrade any plugins by removing the existing plugin and reinstalling the appropriate version using the `kibana-plugin` script. For more information, see [{{kib}} plugins](asciidocalypse://docs/kibana/docs/reference/kibana-plugins.md).
57+
b. Upgrade any plugins by removing the existing plugin and reinstalling the appropriate version using the `kibana-plugin` script. For more information, see [{{kib}} plugins](kibana://reference/kibana-plugins.md).
5258

5359
3. To install from a `zip` or `tar.gz` archive:
5460

@@ -60,10 +66,10 @@ To upgrade {{kib}}:
6066
If you use {{monitor-features}}, you must re-use the data directory when you upgrade {{kib}}. Otherwise, the {{kib}} instance is assigned a new persistent UUID and becomes a new instance in the monitoring data.
6167
::::
6268

63-
d. Install the appropriate versions of all your plugins for your new installation using the `kibana-plugin` script. For more information, see [{{kib}} plugins](asciidocalypse://docs/kibana/docs/reference/kibana-plugins.md).
69+
d. Install the appropriate versions of all your plugins for your new installation using the `kibana-plugin` script. For more information, see [{{kib}} plugins](kibana://reference/kibana-plugins.md).
6470

6571
4. Start {{kib}}.
6672

6773
::::{note}
68-
{{kib}} 8.0.0 and later uses a new logging system, so the log formats have changed. For additional information, see [Logging configuration changes](asciidocalypse://docs/kibana/docs/extend/logging-config-changes.md).
74+
{{kib}} 8.0.0 and later uses a new logging system, so the log formats have changed. For additional information, see [Logging configuration changes](kibana://extend/logging-config-changes.md).
6975
::::

0 commit comments

Comments
 (0)