From 3446e540ca05347b741af2ba954ddfa137fba415 Mon Sep 17 00:00:00 2001 From: Abby <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 22 Mar 2023 16:10:45 +0800 Subject: [PATCH 1/3] update-upgrade-for-3.3.0 --- .../upgrade-nebula-graph-to-latest.md | 14 +++++++++----- mkdocs.yml | 2 +- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md index b43673f5e21..37456ba9b16 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md @@ -1,10 +1,10 @@ -# Upgrade NebulaGraph from version 2.x to {{nebula.release}} +# Upgrade NebulaGraph to {{nebula.release}} -This topic describes how to upgrade NebulaGraph from version 2.x to {{nebula.release}}, taking upgrading from version 2.6.1 to {{nebula.release}} as an example. +This topic describes how to upgrade NebulaGraph from version 2.x and 3.x to {{nebula.release}}, taking upgrading from version 2.6.1 to {{nebula.release}} as an example. ## Applicable source versions -This topic applies to upgrading NebulaGraph from 2.0.0 and later 2.x versions to {{nebula.release}}. It does not apply to historical versions earlier than 2.0.0, including the 1.x versions. +This topic applies to upgrading NebulaGraph from 2.0.0 and later 2.x and 3.x versions to {{nebula.release}}. It does not apply to historical versions earlier than 2.0.0, including the 1.x versions. To upgrade NebulaGraph from historical versions to {{nebula.release}}: @@ -57,7 +57,7 @@ To upgrade NebulaGraph from historical versions to {{nebula.release}}: ## Preparations before the upgrade -- Download the TAR file of NebulaGraph {{nebula.release}} according to your operating system and system architecture. You need the binary files during the upgrade. Find the TAR file on [the download page](https://nebula-graph.io/download/). +- Download the package of NebulaGraph {{nebula.release}} according to your operating system and system architecture. You need the binary files during the upgrade. Find the package on [the download page](https://nebula-graph.io/download/). !!! note You can also get the new binaries from the source code or the RPM/DEB package. @@ -90,7 +90,11 @@ To upgrade NebulaGraph from historical versions to {{nebula.release}}: If the services are not fully stopped in 20 minutes, stop upgrading and ask for help on [the forum](https://discuss.nebula-graph.io/) or [Github](https://github.com/vesoft-inc/nebula/issues). -2. In the target path where you unpacked the TAR file, use the binaries in the `bin` directory to replace the old binaries in the `bin` directory in the NebulaGraph installation path. + !!! caution + + Starting from version 3.0.0, it is possible to insert vertices without tags. If you need to keep vertices without tags, add `--graph_use_vertex_key=true` in the configuration file (`nebula-graphd.conf`) of all Graph services within the cluster; and add `--use_vertex_key=true` in the configuration file (`nebula-storaged.conf`) of all Storage services." + +1. In the target path where you unpacked the package, use the binaries in the `bin` directory to replace the old binaries in the `bin` directory in the NebulaGraph installation path. !!! note Update the binary of the corresponding service on each NebulaGraph server. diff --git a/mkdocs.yml b/mkdocs.yml index 416d59a1ad6..504b7be3f20 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -454,7 +454,7 @@ nav: # - Manage zone: 4.deployment-and-installation/5.zone.md - Upgrade: - Upgrade NebulaGraph to the latest version: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md - - Upgrade NebulaGraph from v3.x to the current version: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md +# - Upgrade NebulaGraph from v3.x to the current version: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md - Uninstall NebulaGraph: 4.deployment-and-installation/4.uninstall-nebula-graph.md - Configurations and logs: From 937e55e00b05a7dc2af6566413697d9f36abe078 Mon Sep 17 00:00:00 2001 From: Abby <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 22 Mar 2023 16:11:34 +0800 Subject: [PATCH 2/3] Update upgrade-nebula-graph-to-latest.md --- .../3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md index 37456ba9b16..23f20b444fc 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md @@ -94,7 +94,7 @@ To upgrade NebulaGraph from historical versions to {{nebula.release}}: Starting from version 3.0.0, it is possible to insert vertices without tags. If you need to keep vertices without tags, add `--graph_use_vertex_key=true` in the configuration file (`nebula-graphd.conf`) of all Graph services within the cluster; and add `--use_vertex_key=true` in the configuration file (`nebula-storaged.conf`) of all Storage services." -1. In the target path where you unpacked the package, use the binaries in the `bin` directory to replace the old binaries in the `bin` directory in the NebulaGraph installation path. +2. In the target path where you unpacked the package, use the binaries in the `bin` directory to replace the old binaries in the `bin` directory in the NebulaGraph installation path. !!! note Update the binary of the corresponding service on each NebulaGraph server. From 7dec16d3ea99f717d6566c79ac33c3637d7cc820 Mon Sep 17 00:00:00 2001 From: Abby <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 22 Mar 2023 16:14:12 +0800 Subject: [PATCH 3/3] Update upgrade-nebula-graph-to-latest.md --- .../3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md index 23f20b444fc..0f6e1ee2e3e 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md @@ -4,7 +4,7 @@ This topic describes how to upgrade NebulaGraph from version 2.x and 3.x to {{ne ## Applicable source versions -This topic applies to upgrading NebulaGraph from 2.0.0 and later 2.x and 3.x versions to {{nebula.release}}. It does not apply to historical versions earlier than 2.0.0, including the 1.x versions. +This topic applies to upgrading NebulaGraph from 2.0.0 and later 2.x, and 3.x versions to {{nebula.release}}. It does not apply to historical versions earlier than 2.0.0, including the 1.x versions. To upgrade NebulaGraph from historical versions to {{nebula.release}}: