如何把老产品迁移到 vDisk（迁移工具）
老产品（联想 IDV3 / 云常 3 / newvhd 系列 boot 服务器）升级到 vDisk 时，不必整库原样升级、也不必手工重建。迁移工具是一个独立的运维工具，带网页向导，可以把计算机、分组、配置、镜像有选择地迁进新环境，差分镜像自动合并。
老环境零改动
整个过程对老服务器只读，一个文件都不改。随时可以放弃回到老环境。
一、先选迁移方式
打开工具第一步就是选：
| 模式 | 适用场景 |
|---|---|
| 远程迁移 | 老服务器与新 vDisk 服务器是两台机器，从老机迁到新机 |
| 本地迁移（就地升级） | 老产品与新 vDisk 装在同一台机器上，原地升级 |
工具界面只监听本机回环地址，同一网络里的其他人打不开；填的数据库凭据仅当次使用，不落盘。
二、远程迁移：四步向导
第一步 选数据源与目标
数据源支持两种：
1，直连老 boot 服务器数据库（只读）。
2，选老产品导出的 SQL 备份文件：自动导进目标数据库服务的临时库后走同一套流程。兼容老版本数据库的建表写法，自动跳过迁移用不到的大流水表数据，可重复导入。
目标是本机的 vDisk 数据库，双向连通校验通过才放行。跨机镜像支持路径映射（UNC）。目标 IO 服务器与镜像存放目录可选，存放目录会按目标库现状自动建议。
第二步 选要导入的计算机、分组与配置
| 对象 | 判重与处理 |
|---|---|
| 计算机 | 按 MAC 判重，已有的跳过 |
| 分组 | 按名称 + 父级复用，自动补齐父级链 |
| 可选项 | IP 池、全局配置、批处理模板、域、模板菜单、计算机 / 分组菜单（均含与磁盘的绑定关系） |
第三步 选要转换的镜像
工具会自动探测每个镜像的差分链层级、文件可访问性、链有没有分叉。目标库里已经存在同标识镜像的，标成「无需迁移」。
第四步 转换
1，差分链两级及以上，自动逐扇区合并成单一主磁盘（写成标准动态 VHD）；单文件镜像原样拷贝。老服务器源文件全程只读。
2，入库时所有关联（分组、磁盘、菜单、模板等）自动重映射，计算机默认菜单自动回填。
3，实时进度与日志；单个失败不影响后续；结束时生成新旧对照迁移报告。
迁进来的是「当前内容」
合并之后是一块单一主磁盘，老差分历史（恢复点）不保留。迁入镜像保留原有标识与版本属性。
三、本地迁移（就地升级）：四步
1）连接本地老版本
填控制台密码（后续备用）+ 老库连接（默认本机 9036 / root / vdcloud），测试确认确实是老产品库。
2）停掉老版本
1，先用 mysqldump 把整个老库导出成 SQL 文件——删服务之前必做，导出失败就中止，不删任何东西。
2，记录老服务配置，生成一键恢复用的维护文件。
3，再停止并删除老服务（vDiskService / IOS / Tftp / websrv / netcopy / Cloud / Sub2API / Tomcat9 / MySQL）——它们与新包同名，不删装不上。
只删服务，不删数据
这一步不删镜像数据文件，也不删 MySQL 数据目录。导出的 SQL、老配置信息、恢复文件都放在工具目录的 backup\ 下。
这一步可以跳过
已经手动停掉老版本、装好新版服务端的现场，可以直接进下一步。这一步失败也不会锁死导航，看日志自行决定即可。
3）安装新版本安装包
由你手动安装。
4）连接新版本并迁移
把老 SQL 导进临时库，再从中迁移镜像（本机原路径直接合并 / 复制）、计算机（全字段，含维护通道设置）、分组、维护通道到新库。可选替换驱动 / 客户端文件。
四、出错时会怎样：系统盘失败整批急停
工具是按盘逐个「转换镜像 + 替换镜像内驱动 / 客户端文件」的。
系统盘替换出问题会立即停住整批：后面的盘、分组、计算机一概不再处理。问题、处理办法、以及「停住前已处理的盘清单」会一次性打全（界面 + 落盘日志）。
处理完重新发起即可——已成功入库的盘按同标识自动复用，不会重转。
判定口径：
- 系统盘 / 数据盘按数据库里的磁盘元数据判定；元数据缺失时从严按系统盘对待。
- 数据库标为系统盘、镜像里却找不到 Windows 系统卷的，会按「库与镜像对不上」停住报出，不会当数据盘滑过去。
- 数据盘替换失败只记该盘失败，不影响其它盘继续。
为什么要这么设计
以前系统盘出错只记一条「失败」就继续跑，收尾报表容易被当成「整体成功」——现场「有的盘什么都没换」却以为迁移完成，根源就在这里。
五、重复执行安全吗
安全。计算机按 MAC 判重、镜像按标识判重，重复执行不会翻倍导入。目标侧逐条日志留痕并生成新旧 ID 对照报告，需要重来时可以按报告清理。
六、迁移前后要预留什么
| 项目 | 说明 |
|---|---|
| 磁盘空间 | 镜像转换要在目标侧落新文件，差分链合并后的体积按主盘算，请预留足够空间 |
| 运行位置 | 在目标 vDisk 服务器上运行 |
| 配置项 | 无，随用随建，不进安装包 |