历史版本升级至 V2.0
本章适用于需要保留组织、项目、媒体、航线和地图等既有业务数据，并在原服务器上升级到 V2.0 集群版的用户。操作流程为“停机备份 → 清理旧环境 → 全新安装 V2.0 → 数据导入 → 业务验证”。请先完成备份并确认备份可用，再清理旧环境，为在原服务器上安装 V2.0 做准备。请提前规划迁移维护窗口，并在迁移后验证数据完整性。
升级前准备
了解部署变化：V2.0 与历史版本差异较大，请先阅读《关于司空 2 集群》和《快速上手》。
统一授权服务器：从 V2.0 起，司空、Terra、4G 等服务的许可证须绑定同一台服务器。
若历史版本的许可证分别安装在不同服务器上，升级前请联系售后迁移许可证。
- 建议先使用试用许可证验证迁移后的业务稳定性，确认迁移成功且运行稳定后，再迁移正式许可证。
保留原始备份：请备份历史版本数据并妥善保管，以便必要时重装历史版本并恢复数据。
流程概览
图示与下方步骤均适用于复用原服务器的场景：先完成备份并确认备份可用，再清理旧环境并安装 V2.0。
操作流程
迁移使用 V2.0 物料包提供的 fh2-backup.sh、fh2-restore.sh 和 environment-clean.sh。请以 root 身份在对应服务器的脚本所在目录执行操作。备份期间会停止相关业务服务；备份脚本结束后会恢复旧服务。请在迁移维护窗口内操作，并在备份完成后暂停业务使用和数据写入，直至迁移完成。
步骤一：迁移前评估。确认目标服务器满足 V2.0 硬件和系统要求，盘点数据量、估算迁移时间，并提前通知相关人员安排维护窗口。
步骤二：数据备份（在旧版单机司空服务器上执行，期间停服）。备份配置、数据库、对象存储和静态文件等数据，并准备集群版迁移数据。以下提供包含或跳过 data 目录归档的两种方式，请按需选择一种执行。完成后，请校验并妥善保存备份：
# 转换旧版司空格式数据为集群格式数据，同时备份原格式司空数据 ./fh2-backup.sh -f ＜备份目录位置＞ # 转换旧版司空数据为集群格式数据 ./fh2-backup.sh -f ＜备份目录位置＞ --skip-data-path参数说明：
-f（--force）会先清空已有备份目录再写入，请将＜备份目录位置＞替换为专用备份目录，勿指向存有其他数据的目录。--skip-data-path表示跳过 data 目录的整体归档；其他迁移数据仍按脚本规则备份。步骤三：环境清理（在旧版单机司空服务器上执行）。完成备份并确认备份可用后，清理旧版运行环境，为在原服务器上安装 V2.0 集群做准备：
# 清理旧版司空的运行环境 ./environment-clean.sh执行说明：清理脚本默认无交互执行，会按固定顺序卸载旧版服务。执行前须先完成备份并确认备份可用；清理完成后再执行步骤四的安装操作。
步骤四：全新安装 V2.0 集群。完成步骤三的旧环境清理后，按《快速上手》在原服务器上完成 V2.0 集群的全新安装。
步骤五：数据导入（在新版司空集群上执行）。使用迁移导入工具将备份导入集群。工具会处理单机版与集群版的数据结构差异，例如合并同名数据库、导入地图瓦片并重建索引：
# 将备份数据导入到新版司空 ./fh2-restore.sh -f ＜备份目录位置＞参数说明：
-f（--force）会跳过覆盖确认并直接导入。请将＜备份目录位置＞替换为实际备份目录，并确保执行导入的集群节点能够访问该目录。步骤六：业务验证。登录平台，核对组织、项目、设备、媒体库、航线和地图数据是否完整，确认机场、飞行器等设备已重新连接，并按实际业务场景抽查功能。