Skip to content

Commit

Permalink
update-upgrade-doc-for-3.3.0,-remove-update-between-3.x (#2670)
Browse files Browse the repository at this point in the history
* update-upgrade-doc-for-3.3.0,-remove-update-between-3.x

Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md
  • Loading branch information
abby-cyber authored Mar 22, 2023
1 parent 3047320 commit 16b4973
Show file tree
Hide file tree
Showing 3 changed files with 20 additions and 8 deletions.
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
# 升级 NebulaGraph 2.x 至 {{nebula.release}} 版本
# 升级 NebulaGraph 至 {{nebula.release}} 版本

本文以 NebulaGraph 2.6.1 版本升级到 {{nebula.release}} 版本为例,介绍 NebulaGraph 2.x 版本升级到 3.x 版本的方法。
本文以 NebulaGraph 2.6.1 版本升级到 {{nebula.release}} 版本为例,介绍 NebulaGraph 2.x、3.x 版本升级到 {{nebula.release}} 版本的方法。


<!--
- 3.0.0版本默认开启无tag点,升级2.x至3.0.0需要升级工具。
- 针对版本间的升级3.0.0到3.2.x,不需要升级工具,此时需要单独的版本间的升级文档。
- 在3.3.0版本默认关闭无tag点,数据结构无变化,此时升级2.x至3.x不要升级工具,也不需要单独的版本间的升级文档。-->

## 适用版本

本文适用于将 NebulaGraph 从 2.0.0 及之后的 2.x 版本升级到 {{nebula.release}} 版本。不适用于 2.0.0 之前的历史版本(含 1.x 版本)。如需升级历史版本,将其根据最新的 2.x 版本文档升级到最新的 2.x 版本,然后根据本文的说明升级到 3.x 版本。
本文适用于将 NebulaGraph 从 2.0.0 及之后的 2.x、3.x 版本升级到 {{nebula.release}} 版本。不适用于 2.0.0 之前的历史版本(含 1.x 版本)。如需升级历史版本,将其根据最新的 2.x 版本文档升级到最新的 2.x 版本,然后根据本文的说明升级到 3.x 版本。

!!! caution

Expand Down Expand Up @@ -52,10 +58,11 @@

## 升级准备

- 根据操作系统和架构下载 NebulaGraph {{nebula.release}} 版本的 TAR 文件并解压,升级过程中需要其中的二进制文件。TAR 包下载地址参见 [Download 页面](https://nebula-graph.io/download/)
- 根据操作系统和架构下载 NebulaGraph {{nebula.release}} 版本的包文件并解压,升级过程中需要其中的二进制文件。下载地址参见 [Download 页面](https://nebula-graph.io/download/)

!!! note
编译源码或者下载RPM/DEB包也可以获取新版二进制文件。

编译源码或者下载 RPM/DEB、TAR 包都可以获取新版二进制文件。

- 根据 Storage 和 Meta 服务配置中`data_path`参数的值找到数据文件的位置,并备份数据。默认路径为`nebula/data/storage``nebula/data/meta`

Expand All @@ -81,16 +88,21 @@

`storaged` 进程 flush 数据要等待约 1 分钟。运行命令后可继续运行`nebula.service status all`命令以确认所有服务都已停止。启动和停止服务的详细说明参见[管理服务](../manage-service.md)

!!! Note
!!! note

如果超过 20 分钟不能停止服务,放弃本次升级,在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。

2.**升级准备**中解压 TAR 包的目的路径下,用此处`bin`目录中的新版二进制文件替换 NebulaGraph 安装路径下`bin`目录中的旧版二进制文件。
!!! caution

从 3.0.0 开始,支持插入无 Tag 的点。如果用户需要保留无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。

2.**升级准备**中下载的包的目的路径下,用此处`bin`目录中的新版二进制文件替换 NebulaGraph 安装路径下`bin`目录中的旧版二进制文件。

!!! note
每台部署了 NebulaGraph 服务的机器上都要更新相应服务的二进制文件。

3. 编辑所有 Graph 服务的配置文件,修改以下参数以适应新版本的取值范围。如参数值已在规定范围内,忽略该步骤。
<!-- 在3.0.0后可忽略该步骤,因为3.0.0及之后配置文件中改了该字段的默认值。 -->

-`session_idle_timeout_secs`参数设置一个在 [1,604800] 区间的值,推荐值为 28800。
-`client_idle_timeout_secs`参数设置一个在 [1,604800] 区间的值,推荐值为 28800。
Expand Down
2 changes: 1 addition & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -458,7 +458,7 @@ nav:

- 升级版本:
- 升级 NebulaGraph 版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md
- 升级 v3.0.x 至当前版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md
# - 升级 v3.0.x 至当前版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md
- 卸载 NebulaGraph: 4.deployment-and-installation/4.uninstall-nebula-graph.md

- 配置与日志:
Expand Down

0 comments on commit 16b4973

Please sign in to comment.