aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoralextarazanov <alextarazanov@yandex-team.com>2022-12-07 11:18:04 +0300
committeralextarazanov <alextarazanov@yandex-team.com>2022-12-07 11:18:04 +0300
commit8103c2467ceb13f1c39b8524a57189d3f556d0dc (patch)
tree85eea8ebe6022663fc47c40b03d19de02067a39d
parent0c5ef452054ce224e3a5aac9259c9bb00117cb59 (diff)
downloadydb-8103c2467ceb13f1c39b8524a57189d3f556d0dc.tar.gz
[review] [YDB] Check "Added description of YDB upgrade" translate
-rw-r--r--ydb/docs/en/core/administration/upgrade.md23
-rw-r--r--ydb/docs/en/core/cluster/index.md1
-rw-r--r--ydb/docs/en/core/cluster/toc_i.yaml2
3 files changed, 26 insertions, 0 deletions
diff --git a/ydb/docs/en/core/administration/upgrade.md b/ydb/docs/en/core/administration/upgrade.md
new file mode 100644
index 00000000000..a2ab3ef352d
--- /dev/null
+++ b/ydb/docs/en/core/administration/upgrade.md
@@ -0,0 +1,23 @@
+# {{ ydb-short-name }} updating
+
+{{ ydb-short-name }} is a distributed system that supports rolling restart without downtime or performance degradation.
+
+## Update procedure {#upgrade_order}
+
+The basic use case is rolling updates:
+
+1. Updating storage nodes.
+2. Updating dynamic nodes.
+
+The shutdown and startup process is described on the [Safe restart and shutdown of nodes](../maintenance/manual/node_restarting.md) page. You must update {{ ydb-short-name }} nodes one by one and monitor the cluster status after each step in [{{ ydb-short-name }} Monitoring](../maintenance/embedded_monitoring/ydb_monitoring.md).
+
+## Version compatibility {#version-compatability}
+
+All minor versions within a major version are compatible for updates. Major versions are consistently compatible. To update to the next major version, you must first update to the latest minor release of the current major version. For example:
+
+* X.Y.* → X.Y.*: Update is possible, all minor versions within a single major version are compatible.
+* X.Y.Z (the latest available version in X.Y.*) → X.Y+1.* : Update is possible, major versions are consistent.
+* X.Y.* → X.Y+2.*: Update is impossible, major versions are inconsistent.
+* X.Y.* → X.Y-2.*: Update is impossible, major versions are inconsistent.
+
+A list of available versions can be found on the [download page](https://ydb.tech/en/docs/downloads/). \ No newline at end of file
diff --git a/ydb/docs/en/core/cluster/index.md b/ydb/docs/en/core/cluster/index.md
index f23755b38db..e6c43389ff6 100644
--- a/ydb/docs/en/core/cluster/index.md
+++ b/ydb/docs/en/core/cluster/index.md
@@ -7,3 +7,4 @@ This section provides information about deploying, configuring, maintaining, mon
* [{#T}](../maintenance/manual/index.md).
* [{#T}](../troubleshooting/system_views_cluster.md).
* [{#T}](../administration/monitoring.md).
+* [{#T}](../administration/upgrade.md).
diff --git a/ydb/docs/en/core/cluster/toc_i.yaml b/ydb/docs/en/core/cluster/toc_i.yaml
index 0412d293024..01b96cf96d1 100644
--- a/ydb/docs/en/core/cluster/toc_i.yaml
+++ b/ydb/docs/en/core/cluster/toc_i.yaml
@@ -17,3 +17,5 @@ items:
href: ../administration/monitoring.md
- name: Grafana dashboards
href: ../administration/grafana-dashboards.md
+- name: YDB updating
+ href: ../administration/upgrade.md \ No newline at end of file