From abbf613bffe10172544164406bdebaebadac2538 Mon Sep 17 00:00:00 2001 From: IgGusev Date: Tue, 19 Sep 2023 12:47:47 +0400 Subject: [PATCH] IGNITE-20431 Added basic info on version upgrade (#10937) --- docs/_data/toc.yaml | 2 ++ docs/_docs/installation/upgrades.adoc | 13 +++++++++++++ 2 files changed, 15 insertions(+) create mode 100644 docs/_docs/installation/upgrades.adoc diff --git a/docs/_data/toc.yaml b/docs/_data/toc.yaml index 065de1549e0ff..4fd8289fcdd97 100644 --- a/docs/_data/toc.yaml +++ b/docs/_data/toc.yaml @@ -51,6 +51,8 @@ url: installation/kubernetes/gke-deployment - title: VMWare url: installation/vmware-installation + - title: Version Upgrade + url: installation/upgrades - title: Setting Up items: - title: Understanding Configuration diff --git a/docs/_docs/installation/upgrades.adoc b/docs/_docs/installation/upgrades.adoc new file mode 100644 index 0000000000000..39c88a0a793a3 --- /dev/null +++ b/docs/_docs/installation/upgrades.adoc @@ -0,0 +1,13 @@ += Version Upgrade + +Upgrade is an important part of the lifecycle of any software system. This page covers the basic recommendations for upgrading the Apache Ignite version. + +== Upgrading Nodes + +Updating node version is as simple as replacing the Apache Ignite binaries with a new version. However, there are several things to keep in mind when performing the upgrade: + +- Ignite cluster cannot have nodes that run on different Ignite versions. You need to stop the cluster and start it again on the new Ignite version. +- It is possible to accidentally overwrite your persistent storage or other important data during the upgrade. It is recommended to move this data outside of intallation folder if you are planning upgrades: +* The work directory is used to store application data and all data required for the node to work. You can change its location as described in tge link:setup#configuring-work-directory[Configuring Work Directory] section. +* The persistent storage holds all information stored on the node. You can change its location as described in the link:persistence/native-persistence#configuring-persistent-storage-directory[Configuring Persistent Storage Directory] section. +* WAL Archive os used to store WAL segments for recovery. You can change its location as described in link:persistence/native-persistence#wal-archive[WAL Archive] section. \ No newline at end of file