Skip to content

Commit d76ec38

Browse files
committed
添加安装迁移常见问题
1 parent b9b35e6 commit d76ec38

File tree

14 files changed

+61
-5
lines changed

14 files changed

+61
-5
lines changed

docs/faq/install_configuration.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,3 +48,41 @@
4848
docker rm maxkb
4949
```
5050
执行 `mkctl reload` 重新加载服务配置并启动服务。
51+
52+
## 5 迁移常见问题
53+
### 5.1 无法执行 PowerShell 脚本
54+
![无法执行powershell脚本](../../img/FAQ/error1.png)
55+
!!! Abstract ""
56+
如果无法执行 PowerShell 脚本,可能需要修改执行策略:
57+
58+
- 临时修改(推荐)
59+
```
60+
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
61+
```
62+
- 永久修改(需管理员权限)
63+
```
64+
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
65+
```
66+
67+
### 5.2 执行脚本后出现乱码报错
68+
![执行powershell脚本乱码](../../img/FAQ/error1.png)
69+
!!! Abstract ""
70+
用记事本打开文件,将文件另存为 ANSI 格式的文本。
71+
![解决方法](../../img/FAQ/solution1.png)
72+
!!! Abstract ""
73+
重新执行 PowerShell 即可正常执行迁移命令。
74+
![解决方法](../../img/FAQ/solution2.png)
75+
76+
### 5.3 Docker Desktop 安装的 MaxKB 迁移后目录路径内容为空,但 MaxKB 能正常运行
77+
!!! Abstract ""
78+
Docker Desktop 安装的 MaxKB 迁移后目录路径内容为空,但 MaxKB 能正常运行
79+
![解决方法](../../img/FAQ/Path missing.png)
80+
!!! Abstract ""
81+
安装 MaxKB V2 时,容器数据的挂载目录为 /opt/maxkb,修改挂载目录即可
82+
83+
```
84+
V1:/var/lib/postgresql/data
85+
V2:/opt/maxkb
86+
```
87+
88+
![解决方法](../../img/FAQ/solution3.png)

docs/img/FAQ/Path missing.png

306 KB
Loading

docs/img/FAQ/error1.png

7.79 KB
Loading

docs/img/FAQ/error2.png

111 KB
Loading

docs/img/FAQ/solution.png

104 KB
Loading

docs/img/FAQ/solution1.png

131 KB
Loading

docs/img/FAQ/solution2.png

128 KB
Loading

docs/img/FAQ/solution3.png

52.8 KB
Loading

docs/installation/backup.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# 备份与还原
2+
3+
!!! Abstract ""
4+
MaxKB 安装后,相关文件的分布路径如下:
5+
6+
- /opt/maxkb:默认运行路径,在安装时可设置。主要存放 MaxKB 运行时所需的配置文件及运行时产生的数据,包括日志文件等
7+
- /usr/bin:默认 docker 及 docker-compose 的运行程序被放置在此目录下
8+
- /usr/local/bin/dectl:MaxKB 的命令行工具
9+
- /var/lib/docker:默认 docker 镜像加载在此
10+
11+
!!! Abstract ""
12+
综上所述,备份 MaxKB 主要需要备份运行路径,如 /opt/maxkb 目录即可。还原步骤如下:
13+
14+
- 该方式适用于相同版本 MaxKB 的迁移,请在新环境里安装同一个版本的 MaxKB,安装时请选择相同的配置参数
15+
- 停止 MaxKB 服务,执行命令:
16+
- 把原环境里的运行目录 /opt/maxkb 整个目录覆盖掉新环境里的 /opt/maxkb 目录
17+
- 启动新环境里的 MaxKB 服务:

docs/installation/migrate.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@
8888
- 如果 v1 的数据量较大,导出过程中需要一定的时间,请务必耐心等待。
8989
- 导出完成后,MaxKB-v1-to-v2-migrator-<version\> 中会生成一个migrate.zip。
9090
```
91-
# PowerShell 版本
91+
# PowerShell 脚本
9292
.\export_v1_data.ps1 -ContainerName <v1_container_name>
9393
```
9494

@@ -98,7 +98,7 @@
9898
!!! Abstract ""
9999
在 v2.1.0 机器上,确保 v2.1.0 版本的容器已经启动且没有任何其它数据。
100100
```
101-
#PowerShell 版本
101+
#PowerShell 脚本
102102
.\import_v2_data.ps1 -ContainerName <v2_container_name>
103103
```
104104

0 commit comments

Comments
 (0)