Skip to content

Commit

Permalink
add-lm-deployoment-in-3.5.0 (#3052)
Browse files Browse the repository at this point in the history
* 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 <[email protected]>

* Update upgrade-nebula-ent.md

* Update upgrade-nebula-ent.md

---------

Co-authored-by: cooper-lzy <[email protected]>
  • Loading branch information
abby-cyber and cooper-lzy authored Oct 18, 2023
1 parent 142d96f commit c3ddedb
Showing 1 changed file with 24 additions and 27 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -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.4 中一个分片对应一个 RocksDB 实例不同于 3.4 之前的一个图空间对应一个 RocksDB 实例。因此企业版3.4.0和之前版本数据格式不兼容-->
- 此升级操作仅适用于升级{{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/)<!--因为企业版 {{nebula.name}} 3.4 中一个分片对应一个 RocksDB 实例不同于 3.4 之前的一个图空间对应一个 RocksDB 实例。因此企业版3.4.0和之前版本数据格式不兼容-->

!!! 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 地址必须与原集群相同。

Expand All @@ -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 服务。<!-- 不需要事先创建`data`目录 -->
3. 在{{nebula.name}} v{{nebula.release}} 的安装目录下,分别执行以下命令以升级 Storage 和 Meta 服务。<!-- 不需要事先创建`data`目录 -->

- 升级 Storage 服务:

Expand All @@ -58,21 +48,21 @@
| 参数 | 说明 |
| :-------------- | :--------------------------- |
| `--max_concurrent_parts` | 指定同时升级的分片数量,默认值为 `1`<br/>建议根据磁盘性能适当调大。 |
| `--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 服务:
Expand All @@ -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}} 服务后,验证数据是否正确。参考命令如下:

```
Expand All @@ -111,11 +108,11 @@
nebula> MATCH (v) RETURN v LIMIT 5;
```

## Docker Compose 部署
## 关于 Docker Compose 部署集群的升级

!!! caution

Docker Compose 部署的{{nebula.name}}建议重新部署新版本后导入数据。
通过 Docker Compose 部署的{{nebula.name}}建议重新部署新版本后导入数据。



Expand Down

0 comments on commit c3ddedb

Please sign in to comment.