weida_doc/维达迁移手册.md

# 维达后台服务迁移指南

## 1. 迁移准备

迁移前请确保以下资源已准备就绪：

- 源服务器上的全部数据和代码
- 目标服务器满足以下要求：
  - Docker环境已安装
  - 至少20GB可用磁盘空间
  - 至少8GB内存
  - 5103端口可用（或规划使用的其他端口）

## 2. 数据备份

在源服务器上执行以下操作：

1. 备份数据库
```bash
docker exec weida_knowledge mysqldump -u root -p zaq12wsx@weida --all-databases > weida_backup.sql
```

2. 备份向量库数据
```bash
tar -czf qa_content.tar.gz /path/to/qa_content
tar -czf qa_store.tar.gz /path/to/qa_store
```

3. 备份服务代码
```bash
tar -czf gpts.tar.gz /path/to/gpts
```

## 3. 数据迁移

将以下文件传输至目标服务器：

- weida_konwledge_image.tar (Docker镜像)
- weida_backup.sql (数据库备份)
- qa_content.tar.gz (向量库内容)
- qa_store.tar.gz (向量库向量)
- gpts.tar.gz (服务代码)
- GLM-4目录 (AI模型)

## 4. 恢复部署

1. 解压所有文件
```bash
tar -xzf gpts.tar.gz
tar -xzf qa_content.tar.gz -C /path/to/gpts/qa_content
tar -xzf qa_store.tar.gz -C /path/to/gpts/qa_store
```

2. 按照《维达部署手册》中的步骤执行部署：
   - 加载并运行Docker镜像
   - 恢复数据库
   - 启动服务
   - 启动AI模型

## 5. 验证迁移

迁移完成后，请验证以下功能：

1. 检查服务状态
```bash
ps aux | grep mainserver.py
ps aux | grep api.py
```

2. 检查数据库连接
```bash
mysql -u root -p
```

3. 测试问答功能
   - 尝试上传新文档
   - 测试问答交互
   - 验证向量检索

## 6. 回滚方案

如迁移过程中出现问题，准备以下回滚步骤：

1. 停止新部署的服务
```bash
docker stop weida_knowledge
```

2. 恢复原有服务器的运行状态

3. 记录失败原因，分析问题后重新制定迁移计划

## 7. 注意事项

- 迁移前请确保源服务处于稳定状态
- 建议在非业务高峰期进行迁移
- 保留所有备份文件直至新环境稳定运行
- 迁移过程中详细记录每个步骤的执行情况
- 确保新环境的系统时间与源环境一致