跨版本升级工具操作手册及常见问题

麒麟软件有限公司

终端研发部

2024年4月

适用说明

本操作手册适用于银河麒麟桌面操作系统 V10 升级到 V10SP1 ，及升级成功后可以从V10SP1 还原到V10。

本程序适用于设备中只安装V10系统。

支持的v10系统版本包括0710、2101、2107、2203及其他版本

可以升级到v10SP1的版本包括2107、2203、2303、2403

程序适用于arm64、amd64

对于设置硬盘加密的系统，程序不适用

对于多系统设备，程序不适用

注意事项

一、升级：

1、升级前，请将重要文件进行备份，以防丢失；

2、对于离线升级，请将镜像文件存放到本地磁盘；

3、对于离线升级，请准备授权文件(.kyinfo和LICENSE)；

4、升级前，根分区需要预留大于12G 的空间；

5、由于部分第三方应用与V10SP1不兼容，升级后可能会出现第三方应用无法使用的情况（如打不开应用、应用功能不完整），建议您在软件商店，尝试安装该应用的最新版本；

6、升级后审计功能会默认关闭，打开请通过执行 sudo /usr/share/revisions-manager/RevisionsManager/scripts/open_audit.sh，然后重启即可；

7、升级后，系统会自动激活，激活失败可以手动激活；

8、升级后，不支持使用备份还原功能中的V10系统的备份；需要还原为V10系统，可以通过本程序的还原功能；

9、升级后，原系统（不包括/home/目录下的用户数据）备份于/fs.old/目录下，/home/目录下的用户数据会迁移到新系统中；

10、30天后将自动删除旧系统

二、还原：

可以在升级后30天内，且没有删除旧系统备份的情况下，还原为V10系统。

还原后的/home/目录下的用户数据，将会是当前最新数据

操作步骤

一、升级：

注意：请您在执行本程序前，对重要文件做好备份。在程序运行过程中保持电源连接正常。

升级提供在线升级和离线升级两种方式。以适应用户的不同选择。

升级操作步骤如下：

打开桌面图标，进入跨版本升级应用

选择升级方式，分为在线升级和离线升级。

在线升级需要从连接网络后进行检查更新，成功则提供可升级版本列表，失败则报检查更新异常。

通过设置可以配置远程服务器地址，也可以直接使用默认地址进行更新。

点击下载，会进行升级镜像下载，下载完成后按键文字会变成“升级”，点击后会依次进入注意事项界面以及升级须知界面。

进行确认后就会进入升级流程：

升级检测流程和准备工作完成后（进度显示为60%）会自动重启，进入关机更新界面，此时进度从60%开始。

更新完成后，重启系统，登录新系统界面会提示更新成功，如果有兼容失败的包会在列表中展示。

离线升级则通过选择本地ISO文件进行升级。点击文件小图标选择ISO，找到并选择V10SP1的ISO文件，然后点击下一步。其余步骤同在线升级。

二、还原：

注意：请您在执行本程序前，对重要文件做好备份。 在程序运行过程中保持电源连接正常。

操作步骤如下：

1、打开应用，进入系统还原条目，点击还原

2、进入注意事项界面，点击还原进入还原流程

进入还原流程，等待机器重启进入登录界面完成还原

常见问题

升级后原系统数据存放位置？

答：/fs.old/目录下

升级完成，但是提示部分应用安装失败，怎么处理？

答：对于应用商店中存在的应用，可以通过软件商店重新安装；

新系统使用不方便，怎么还原？

答：打开跨版本升级程序，选择还原。

系统的桌面背景、锁屏背景等发生变化

答：系统升级支持sp1系统中默认图片，自定义情况请用户重新设置

迁移第三方应用选项说明：

勾选，将会在v10sp1系统兼容第三方应用；

不勾选，则不会。

默认勾选。

程序相关说明和异常情况处理（面向麒麟软件技服人员）

一、程序相关说明

日志所在路径：/var/log/RevisionsManager/

其中有RevisionsManager.log.*

可能有RevisionsManagerSupplement.log

postinstall.log, security.log

配置和状态所在路径：/etc/RevisionsManager/

其中有RevisionsManager.state, RevisionsManager.conf ,

可能有RevisionsManager.md5sum, grub.cfg_bak-***

initrd模块日志：/run/initramfs/initramfs.debug

迁移应用的日志路径：/opt/RevisionsManager/

可能有：repkgList, repkgListEx

可能有的文件是在程序运行过程中生成的，产生问题时，可以通过执行sudo bash getlog脚本收集以上脚本。

升级流程说明：

升级流程分两部分，在v10系统中点击升级后，执行第一部分升级流程；完成后重启，执行第二部分升级流程；完成后再重启，即升级成功的SP1。

还原流程说明：

在SP1系统中点击还原后，重启即还原为原V10系统。

二、异常情况处理

问题1：在第一部分升级完成后，重启阻塞

发生条件：

a - 用户使用过程中，用户强制关机或异常断电，导致程序运行异常；

b - 程序存在BUG；

排查方法：处于启动界面，界面不显示升级进度，或是升级进度不变化。（20分钟以上）

处理方法：重启，选择选择”Force back Kylin V10 ****”选项，先恢复到V10系统。重新执行升级。

问题2：升级完成，存在部分应用安装失败

发生条件：

a - v10系统软件包不能在SP1中安装；

b - 自主安装包未在SP1中适配

排查方法：执行 dpkg -l | grep -v ii 查看安装失败的应用包

处理方法：对于软件源中存在的包，重新安装一下；

问题3：第一部分升级流程失败，重试后仍不能成功；

排查方法：执行 ls /fs.new, 目录下文件夹只有cdrom opt;

处理方法：该设备无法升级。记录设备的型号信息和系统版本信息

问题4：执行还原，重启后长时间不能进入系统；

处理方法：重启

问题5：存在安全性警告

处理方法：执行安全体检，然后一键修复

问题6：发现网络无法连接

处理方法：重新安装网络组件

问题7：软件商店无法打开

处理方法：重新安装软件商店