Skip to content

Commit 54728af

Browse files
committed
更新迁移工具说明
1 parent 90dea18 commit 54728af

File tree

1 file changed

+17
-14
lines changed

1 file changed

+17
-14
lines changed

docs/installation/migrate.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@
1313

1414
- **此工具是迁移工具,用以将 v1.10.10-lts 的数据迁移到 v2.1.0,并不是直接的升级工具;**
1515
- **此工具只支持 v1.10.10-lts 的数据迁移到 v2.1.0;**
16-
- **数据迁移的目标环境 必须是v2.1.0,且没有任何数据(license 除外);**
17-
- **迁移前,停止在 v1.10.10 环境进行操作,避免数据迁移不完整;**
16+
- **数据迁移的目标环境必须是v2.1.0,且没有任何数据(license 除外);**
17+
- **迁移前,停止在 v1.10.10-lts 环境进行操作,避免数据迁移不完整;**
1818
- **迁移前,请务必检查磁盘空间,并确保数据导出和导入前后有足够的存储空间。**
1919

2020
## 2 迁移工具下载
@@ -25,10 +25,10 @@
2525
### 3.1 Linux/macOS 系统
2626
#### 3.1.1 导出数据
2727
!!! Abstract ""
28-
在 v1.10.10 机器上下载 MaxKB-v1-to-v2-migrator-<version\>.zip,解压后进入目录,执行命令导出 v1 数据。
28+
在 v1.10.10-lts 机器上下载 MaxKB-v1-to-v2-migrator-<version\>.zip,解压后进入目录,执行以下命令导出 v1 数据。
2929

30-
- 如果迁移数据量较大,导出过程中需要一定的时间,请务必耐心等待。
31-
- 导出完成后,MaxKB-v1-to-v2-migrator-<version\> 中会生成一个migrate.zip。
30+
- 如果 v1 的数据量较大,导出过程中需要一定的时间,请务必耐心等待。
31+
- 导出完成后,MaxKB-v1-to-v2-migrator-<version\> 中会生成一个 migrate.zip。
3232
- 将 MaxKB-v1-to-v2-migrator-<version\> 复制到 v2.1.0 所在的机器上。
3333
```
3434
unzip MaxKB-v1-to-v2-migrator-<version>.zip
@@ -43,7 +43,8 @@
4343

4444
#### 3.1.2 导入数据
4545
!!! Abstract ""
46-
在 v2.1.0 机器上,确保 v2.1.0 版本的容器已经启动且没有任何其它数据, 专业版和企业版需要在导入 license 再进行数据的导入。
46+
在 v2.1.0 机器上,确保 v2.1.0 版本的容器已经启动且没有任何其它数据, 专业版和企业版需导入 license 后再进行数据的导入。
47+
4748
进入迁移工具目录,执行以下命令将数据导入 v2.1.0。
4849
```
4950
cd MaxKB-v1-to-v2-migrator-<version>
@@ -78,9 +79,9 @@
7879

7980
#### 3.2.2 导出数据
8081
!!! Abstract ""
81-
对于 Windows 系统,MaxKB 提供了 PowerShell 脚本(.ps1)来导出 v1.10.10 数据。下载迁移工具并解压,使用终端管理员进入迁移目录,执行命令导出 v1 数据。
82+
对于 Windows 系统,MaxKB 提供了 PowerShell 脚本.ps1来导出 v1.10.10-lts 数据。下载迁移工具并解压,使用终端管理员进入迁移目录,执行命令导出 v1 数据。
8283

83-
- 如果迁移数据量较大,导出过程中需要一定的时间,请务必耐心等待。
84+
- 如果 v1 的数据量较大,导出过程中需要一定的时间,请务必耐心等待。
8485
- 导出完成后,MaxKB-v1-to-v2-migrator-<version\> 中会生成一个migrate.zip。
8586
```
8687
# PowerShell 版本
@@ -91,7 +92,7 @@
9192

9293
#### 3.2.3 导入数据
9394
!!! Abstract ""
94-
在 v2.1.0 机器上,确保 v2.1.0 版本的容器已经启动且没有任何其它数据, 专业版和企业版需要在导入 license 再进行数据的导入。
95+
在 v2.1.0 机器上,确保 v2.1.0 版本的容器已经启动且没有任何其它数据专业版和企业版需要在导入 license 再进行数据的导入。
9596
```
9697
#PowerShell 版本
9798
.\import_v2_data.ps1 -ContainerName <v2_container_name>
@@ -103,17 +104,17 @@
103104
### 4.1 用户
104105
!!! Abstract ""
105106

106-
- 如果用户的【姓名】为空,迁移后,自动将【用户名】作为【姓名】;
107+
- 如果 v1 中用户的【姓名】为空,迁移后,自动将【用户名】作为【姓名】;
107108
- 工作空间内的资源查询依照【姓名】查询;
108-
- admin 账户默认授予系统管理员、工作空间管理员、普通用户权限(X-Pack)
109-
- 除 admin 外,系统用户或其他用户类型迁移后,默认角色为普通用户(X-Pack)
109+
- admin 账户默认授予系统管理员、工作空间管理员、普通用户权限(X-Pack
110+
- 除 admin 外,系统用户或其他用户类型迁移后,默认角色为普通用户(X-Pack
110111

111112
### 4.2 资源
112113
!!! Abstract ""
113114

114115
- v1 授权给其他成员的应用/知识库,迁移后授予相应的权限;
115116
- 资源创建者拥有管理资源的权限;
116-
- v1 函数库迁移后,在工具中,创建者有管理权限,其他用户默认都是不授权状态
117+
- v1 函数库迁移后,在工具中,创建者有管理权限,其他用户默认是不授权状态
117118
- 公有模型迁移后,默认资源授权所有普通用户为查看权限,创建者为管理权限。
118119

119120

@@ -123,5 +124,7 @@
123124
- v1 与 v2 的接口文档不一致,如有接口调用,需重新配置;
124125

125126
### 4.4 应用接入
127+
!!! Abstract ""
128+
126129

127-
- 应用接入到企业微信等的回调地址会发生变化,应用接入、登录认证(扫码登录)需重新配置(X-Pack)
130+
- 应用接入到企业微信等的回调地址会发生变化,应用接入、登录认证(扫码登录)需重新配置(X-Pack

0 commit comments

Comments
 (0)