From c3ddedb128860af07935ae9241c49f44d8913178 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 18 Oct 2023 10:46:53 +0800 Subject: [PATCH] add-lm-deployoment-in-3.5.0 (#3052) * add-lm-deployoment-in-3.5.0 1. add LM configuration step 2. fix broken links 3. change nebula to yueshu for ent version * Update docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-ent.md Co-authored-by: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> * Update upgrade-nebula-ent.md * Update upgrade-nebula-ent.md --------- Co-authored-by: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> --- .../upgrade-nebula-ent.md | 51 +++++++++---------- 1 file changed, 24 insertions(+), 27 deletions(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-ent.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-ent.md index e7c1dfd3958..91678cd7b0a 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-ent.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-ent.md @@ -4,11 +4,11 @@ ## 升级说明 -- 此升级操作仅适用于升级{{nebula.name}} 3.x（x < 4）至 {{nebula.release}}。对于升级 3.4.0 及以上版本至 {{nebula.release}}，可以直接替换二进制文件进行升级。具体操作请参见[升级{{nebula.name}}至 {{nebula.release}}](https://docs.nebula-graph.com.cn/{{nebula.release}}/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-comm/)。 +- 此升级操作仅适用于升级{{nebula.name}} 3.x（x < 4）至 {{nebula.release}}。对于升级 3.4.0 及以上版本至 {{nebula.release}}，可以直接替换二进制文件进行升级。具体操作请参见[升级{{nebula.name}}至 {{nebula.release}}](https://docs.nebula-graph.com.cn/3.5.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-comm/)。 !!! note - 如果您的{{nebula.name}}版本低于 3.0.0，请先升级到 3.1.0 再升级到 {{nebula.release}}。具体操作请参见[升级{{nebula.name}} 2.x 至 3.1.0](https://docs.nebula-graph.com.cn/3.1.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-comm/)。 + 如果您的{{nebula.name}}版本低于 3.0.0，请先升级到 3.1.3 再升级到 {{nebula.release}}。具体操作请参见[升级{{nebula.name}} 2.x 至 3.1.3](https://docs.nebula-graph.com.cn/3.1.3/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest/)。 - 执行升级操作的集群 IP 地址必须与原集群相同。 @@ -22,30 +22,20 @@ ## 升级步骤 - {{ comm.comm_begin }} - -1. [联系我们获取](https://www.nebula-graph.com.cn/contact){{nebula.name}} v{{nebula.release}} 的安装包并安装。 - - {{ comm.comm_end }} - - {{ ent.ent_begin }} - -2. [联系我们获取](https://yueshu.com.cn/contact){{nebula.name}} v{{nebula.release}} 的安装包并安装。 - - {{ ent.ent_end }} +1. [联系我们获取](https://yueshu.com.cn/contact){{nebula.name}} v{{nebula.release}} 的安装包并安装。 !!! note - 不同安装包的升级步骤相同。本文以 RPM 包且安装目录为`/usr/local/nebulagraph-ent-{{nebula.release}}`为例。具体操作请参见[安装 RPM 包](../2.compile-and-install-nebula-graph/2.install-nebula-graph-by-rpm-or-deb.md)。 + 不同安装包的升级步骤相同。本文以 RPM 包且安装目录为`/usr/local/yueshu-{{nebula.release}}`为例。具体操作请参见[安装 RPM 包](../2.compile-and-install-nebula-graph/2.install-nebula-graph-by-rpm-or-deb.md)。 !!! caution 请确保 {{nebula.release}} 集群的 Meta 服务和 Storage 服务的配置文件中的`--data_path`参数设置的存储路径数量与 3.x 集群的配置文件中的`--data_path`参数配置的路径数量相同。否则，升级后的集群无法启动。 -3. 停止{{nebula.name}} v3.x 服务。详情请参见[管理{{nebula.name}}服务](../../2.quick-start/3.quick-start-on-premise/5.start-stop-service.md)。 +2. 停止{{nebula.name}} v3.x 服务。详情请参见[管理{{nebula.name}}服务](../../2.quick-start/3.quick-start-on-premise/5.start-stop-service.md)。 运行命令后可继续运行`nebula.service status all`命令以确认所有服务都已停止。 -4. 在{{nebula.name}} v{{nebula.release}} 的安装目录下，分别执行以下命令以升级 Storage 和 Meta 服务。 +3. 在{{nebula.name}} v{{nebula.release}} 的安装目录下，分别执行以下命令以升级 Storage 和 Meta 服务。 - 升级 Storage 服务： @@ -58,21 +48,21 @@ | 参数 | 说明 | | :-------------- | :--------------------------- | | `--max_concurrent_parts` | 指定同时升级的分片数量，默认值为 `1`。
建议根据磁盘性能适当调大。 | - | `--src_db_path` | 指定源数据目录的绝对路径。下述示例源数据的目录为`/usr/local/nebula-ent-3.1.0/data/storage`。 | - | `--dst_db_path` | 指定目标数据目录的绝对路径。本文示例的目标数据目录为`/usr/local/nebula-ent-{{nebula.release}}/data/storage`。| + | `--src_db_path` | 指定源数据目录的绝对路径。下述示例源数据的目录为`/usr/local/yueshu-3.1.0/data/storage`。 | + | `--dst_db_path` | 指定目标数据目录的绝对路径。本文示例的目标数据目录为`/usr/local/yueshu-{{nebula.release}}/data/storage`。| 示例： ```bash - sudo ./bin/db_upgrader --max_concurrent_parts=20 --src_db_path=/usr/local/nebula-ent-3.1.0/data/storage --dst_db_path=/usr/local/nebula-ent-{{nebula.release}}/data/storage + sudo ./bin/db_upgrader --max_concurrent_parts=20 --src_db_path=/usr/local/yueshu-3.1.0/data/storage --dst_db_path=/usr/local/yueshu-{{nebula.release}}/data/storage ``` - 如果有多个源数据目录，请分别指定不同的源数据目录和目标数据目录并执行命令。例如，有两个源数据目录`/usr/local/nebula-ent-3.1.0/data/storage`和`/usr/local/nebula-ent-3.1.0/data2/storage`，则执行以下命令： + 如果有多个源数据目录，请分别指定不同的源数据目录和目标数据目录并执行命令。例如，有两个源数据目录`/usr/local/yueshu-3.1.0/data/storage`和`/usr/local/yueshu-3.1.0/data2/storage`，则执行以下命令： ```bash - sudo ./bin/db_upgrader --src_db_path=/usr/local/nebula-ent-3.1.0/data/storage --dst_db_path=/usr/local/nebula-ent-{{nebula.release}}/data/storage + sudo ./bin/db_upgrader --src_db_path=/usr/local/yueshu-3.1.0/data/storage --dst_db_path=/usr/local/yueshu-{{nebula.release}}/data/storage - sudo ./bin/db_upgrader --src_db_path=/usr/local/nebula-ent-3.1.0/data2/storage --dst_db_path=/usr/local/nebula-ent-{{nebula.release}}/data2/storage + sudo ./bin/db_upgrader --src_db_path=/usr/local/yueshu-3.1.0/data2/storage --dst_db_path=/usr/local/yueshu-{{nebula.release}}/data2/storage ``` - 升级 Meta 服务： @@ -85,19 +75,26 @@ | 参数 | 说明 | | :-------------- | :--------------------------- | - | `--src_meta_path` | 指定源 Meta 数据目录的绝对路径。下述示例源数据的目录为`/usr/local/nebula-ent-3.1.0/data/meta`。 | - | `--dst_meta_path` | 指定目标 Meta 数据目录的绝对路径。本文示例的目标数据目录为`/usr/local/nebula-ent-{{nebula.release}}/data/meta`。| + | `--src_meta_path` | 指定源 Meta 数据目录的绝对路径。下述示例源数据的目录为`/usr/local/yueshu-3.1.0/data/meta`。 | + | `--dst_meta_path` | 指定目标 Meta 数据目录的绝对路径。本文示例的目标数据目录为`/usr/local/yueshu-{{nebula.release}}/data/meta`。| 示例： ```bash - sudo ./bin/meta_upgrader --src_meta_path=/usr/local/nebula-ent-3.1.0/data/meta --dst_meta_path=/usr/local/nebula-ent-{{nebula.release}}/data/meta + sudo ./bin/meta_upgrader --src_meta_path=/usr/local/yueshu-3.1.0/data/meta --dst_meta_path=/usr/local/yueshu-{{nebula.release}}/data/meta ``` 如果有多个源 Meta 数据目录，请指定不同的源 Meta 数据目录和目标 Meta 数据目录并分别执行命令。 服务升级完成后，会在 v{{nebula.release}} 的安装目录下生成`data`目录，其中包含升级后的数据文件。 +4. 在`/usr/local/yueshu-{{nebula.release}}/etc/nebula-metad.conf`中配置`license_manager_url`参数，指定 LM 的路径。 + + LM 用于校验{{nebula.name}}的授权信息，详情参见[LM 配置](../../9.about-license/2.license-management-suite/3.license-manager.md)。 + + !!! note + 3.5.0 及之后版本，启动{{nebula.name}}会进行 License 校验，需要提前安装和配置 LM。 + 5. 启动和连接{{nebula.name}} v{{nebula.release}} 服务后，验证数据是否正确。参考命令如下： ``` @@ -111,11 +108,11 @@ nebula> MATCH (v) RETURN v LIMIT 5; ``` -## Docker Compose 部署 +## 关于 Docker Compose 部署集群的升级 !!! caution - Docker Compose 部署的{{nebula.name}}建议重新部署新版本后导入数据。 + 通过 Docker Compose 部署的{{nebula.name}}建议重新部署新版本后导入数据。