openEuler 24.03 LTS SP3 跨版本升级安装源设置全指南

一、背景认知1.1 版本与升级基础openEuler 24.03 LTS SP32025 年 12 月 30 日正式发布基于 Linux 6.6 内核提供 4 年社区长期支持修复了前期版本的已知问题大幅优化了 AI、数据库和异构计算性能是目前最稳定的企业级版本之一跨版本升级指从旧的 LTS 版本如 22.03 LTS 系列、24.03 LTS/SP1/SP2直接升级到 24.03 LTS SP3无需重新安装系统保留所有数据和配置安装源的核心作用提供系统升级所需的所有软件包、依赖库和签名密钥是跨版本升级成功的前提1.2 适用与不适用场景✅适用场景从 openEuler 22.03 LTS SP3/SP4 升级到 24.03 LTS SP3从 openEuler 24.03 LTS/SP1/SP2 升级到 SP3服务器、虚拟机和云环境的系统升级❌不适用场景从非 LTS 版本如 23.09、25.03升级从其他 Linux 发行版如 CentOS、Ubuntu升级系统已被严重破坏或存在大量第三方软件的情况1.3 最低硬件要求资源最低要求推荐要求CPU2 核4 核及以上内存4GB8GB 及以上避免内存溢出系统盘剩余空间10GB20GB 及以上/ 分区必须≥5GB网络可访问公网带宽≥10Mbps需下载 2-5GB 安装包权限root 用户权限root 用户权限二、核心配置2.1 软件源基本概念软件源Repository存放 RPM 软件包的服务器openEuler 官方源地址为https://repo.openeuler.org/.repo 文件位于/etc/yum.repos.d/目录下是软件源的配置文件后缀必须为.repo跨版本升级专用源必须包含OS基础系统、everything完整软件包和update更新包三个仓库2.2 .repo 文件核心参数详解[仓库名称] # 唯一标识不能与其他仓库重复 name仓库描述 # 人类可读的描述信息 baseurl仓库地址 # 软件包的下载地址支持http/https/file协议 enabled1 # 是否启用该仓库1启用0禁用 gpgcheck1 # 是否验证软件包签名1验证0不验证建议开启 gpgkey公钥地址 # 用于验证签名的GPG公钥文件地址 priority99 # 仓库优先级1最高99最低默认99 metadata_expire1h # 元数据过期时间默认6小时2.3 跨版本升级核心软件包openEuler-release系统版本标识包openEuler-repos官方软件源配置包openEuler-gpg-keys软件包签名密钥包dnf-plugin-system-upgradeDNF 系统升级插件部分旧版本需要手动安装三、基础实操初学者必看步骤不省略3.1 升级前准备至关重要备份系统和数据虚拟机创建完整快照升级失败唯一可靠的兜底方案物理机备份/etc、/home、/var等关键目录和业务数据命令行备份示例# 备份系统配置目录 tar -zcvf /root/etc_backup_$(date %Y%m%d).tar.gz /etc # 备份所有repo源文件 tar -zcvf /root/yum_repos_backup_$(date %Y%m%d).tar.gz /etc/yum.repos.d检查当前系统版本cat /etc/openEuler-latest cat /etc/os-release确认当前版本为 22.03 LTS 系列或 24.03 LTS 系列禁用所有第三方源# 查看所有启用的源 dnf repolist enabled # 禁用非官方源将enabled1改为enabled0 vi /etc/yum.repos.d/第三方源文件名.repo⚠️ 警告第三方源和自行编译的软件是导致升级失败的最主要原因建议提前卸载更新当前系统到最新状态dnf clean all dnf update -y重启系统reboot3.2 配置 24.03 LTS SP3 官方安装源备份所有旧的 repo 文件# 创建备份目录 mkdir -p /etc/yum.repos.d/backup # 移动所有旧repo文件到备份目录 mv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup/创建新的官方源配置文件vi /etc/yum.repos.d/openEuler-24.03-LTS-SP3.repo写入以下内容根据架构自动适配[OS] nameopenEuler-24.03-LTS-SP3 OS baseurlhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/OS/$basearch/ enabled1 gpgcheck1 gpgkeyhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/OS/$basearch/RPM-GPG-KEY-openEuler priority1 [everything] nameopenEuler-24.03-LTS-SP3 everything baseurlhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/everything/$basearch/ enabled1 gpgcheck1 gpgkeyhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/everything/$basearch/RPM-GPG-KEY-openEuler priority1 [update] nameopenEuler-24.03-LTS-SP3 update baseurlhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/update/$basearch/ enabled1 gpgcheck1 gpgkeyhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/update/$basearch/RPM-GPG-KEY-openEuler priority1 [EPOL] nameopenEuler-24.03-LTS-SP3 EPOL baseurlhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/EPOL/main/$basearch/ enabled1 gpgcheck1 gpgkeyhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/EPOL/main/$basearch/RPM-GPG-KEY-openEuler priority1 说明$basearch会自动识别系统架构x86_64 或 aarch64无需手动修改保存并退出按Esc键输入:wq按Enter键3.3 验证安装源配置清理旧缓存dnf clean all重建新缓存dnf makecache✅ 成功标志无报错显示 Metadata cache created查看可用的软件源dnf repolist应该能看到刚才配置的 4 个仓库OS、everything、update、EPOL3.4 执行跨版本升级升级系统核心包dnf update -y openEuler-release openEuler-repos openEuler-gpg-keys这一步非常重要会更新系统版本标识、源配置和签名密钥避免后续升级出现签名错误执行全系统跨版本升级dnf distro-sync -y⚠️ 关键说明distro-sync是 DNF 专门用于跨版本升级的命令会自动匹配目标版本的所有软件包处理依赖、升级、降级和删除冲突包比普通的dnf upgrade更适合跨版本场景遇到配置文件替换提示初学者输入 N 保留原有配置高级用户可输入 D 查看差异后决定执行过程中绝对不要中断断电、断网、关闭终端、强制终止命令否则系统会直接变砖全程耗时取决于网络和硬件配置通常需要 30 分钟到 2 小时安装最小系统组可选但推荐dnf group install Minimal Install -y确保系统基础组件完整重建 RPM 数据库rpm --rebuilddb3.5 升级后处理清理冗余包和旧内核# 安装清理工具 dnf install -y dnf-utils # 清理无用的旧内核保留最新的2个 package-cleanup --oldkernels --count2 -y # 清理所有未使用的依赖包 package-cleanup --leaves -y package-cleanup --orphans -y # 清理DNF缓存 dnf clean all重启系统reboot验证升级结果bash运行cat /etc/openEuler-latest cat /etc/os-release uname -r确认系统版本为openEuler 24.03 LTS SP3内核版本为 6.6 系列四、高阶用法4.1 配置国内镜像源提升下载速度官方源在国内访问速度较慢建议替换为国内镜像源。以下是几个常用的国内镜像华为云镜像源baseurlhttps://mirrors.huaweicloud.com/openeuler/openEuler-24.03-LTS-SP3/OS/$basearch/网易镜像源baseurlhttps://mirrors.163.com/openeuler/openEuler-24.03-LTS-SP3/OS/$basearch/清华大学镜像源baseurlhttps://mirrors.tuna.tsinghua.edu.cn/openeuler/openEuler-24.03-LTS-SP3/OS/$basearch/只需将上述地址替换到openEuler-24.03-LTS-SP3.repo文件中的所有baseurl即可4.2 配置本地 ISO 源离线升级如果服务器无法访问公网可以使用本地 ISO 镜像作为安装源下载 24.03 LTS SP3 完整 ISO 镜像下载地址https://repo.openeuler.org/openEuler-24.03-LTS-SP3/ISO/选择对应架构的Everything ISO上传 ISO 文件到服务器上传到/root/目录下创建挂载点并挂载 ISOmkdir -p /mnt/iso mount -o loop /root/openEuler-24.03-LTS-SP3-x86_64-dvd.iso /mnt/iso创建本地源配置文件vi /etc/yum.repos.d/openEuler-local.repo写入以下内容[local_OS] nameopenEuler-24.03-LTS-SP3 Local OS baseurlfile:///mnt/iso/ enabled1 gpgcheck1 gpgkeyfile:///mnt/iso/RPM-GPG-KEY-openEuler priority1验证本地源dnf clean all dnf makecache执行升级升级步骤与在线升级相同设置开机自动挂载 ISO可选echo /root/openEuler-24.03-LTS-SP3-x86_64-dvd.iso /mnt/iso iso9660 loop 0 0 /etc/fstab4.3 多源优先级设置如果同时配置了多个源可以通过priority参数设置优先级数值越小优先级越高# 本地源优先级最高 [local_OS] nameLocal OS baseurlfile:///mnt/iso/ enabled1 gpgcheck1 priority1 # 华为云镜像源次之 [huawei_OS] nameHuawei Cloud OS baseurlhttps://mirrors.huaweicloud.com/openeuler/openEuler-24.03-LTS-SP3/OS/$basearch/ enabled1 gpgcheck1 priority2 # 官方源优先级最低 [official_OS] nameOfficial OS baseurlhttps://repo.openeuler.org/openEuler-24.03-LTS-SP3/OS/$basearch/ enabled1 gpgcheck1 priority994.4 使用官方升级脚本openEuler 社区提供了官方升级脚本可以简化升级过程下载升级脚本git clone https://gitee.com/openeuler/openeuler-upgrader.git cd openeuler-upgrader chmod x openeuler-upgrader执行升级sudo ./openeuler-upgrader 24.03LTS_SP3脚本会自动完成以下操作备份现有仓库配置配置目标版本源执行系统升级记录升级日志到/var/log/openeuler-upgrader/目录五、拓展建议5.1 常见问题排查源配置错误导致 makecache 失败检查baseurl地址是否正确检查网络是否能访问镜像源尝试使用ping和curl测试镜像源连通性ping mirrors.huaweicloud.com curl https://mirrors.huaweicloud.com/openeuler/openEuler-24.03-LTS-SP3/OS/x86_64/repodata/repomd.xmlGPG 签名验证失败确认gpgkey地址正确手动导入 GPG 密钥rpm --import https://repo.openeuler.org/openEuler-24.03-LTS-SP3/OS/$basearch/RPM-GPG-KEY-openEuler临时禁用 GPG 检查不推荐仅用于测试dnf distro-sync -y --nogpgcheck依赖冲突导致升级失败禁用所有第三方源卸载冲突的软件包使用--allowerasing参数允许删除冲突包dnf distro-sync -y --allowerasing升级后系统无法启动进入救援模式检查/etc/fstab文件是否正确重新安装 GRUB 引导恢复之前的系统快照或备份5.2 安全注意事项始终使用官方或可信的镜像源避免使用未知来源的源开启 GPG 签名验证防止下载被篡改的软件包升级前关闭所有业务服务避免数据丢失升级后立即检查系统安全设置和防火墙规则及时安装安全更新5.3 生产环境升级建议必须先在 1:1 测试环境完整走通升级流程验证业务兼容性选择业务低峰期进行升级升级前通知所有用户准备好回滚方案系统快照、备份升级后进行全面的功能测试和性能测试建议分批升级避免一次性升级所有服务器5.4 后续维护定期更新系统dnf update -y定期清理系统缓存和冗余包监控系统运行状态和日志关注 openEuler 社区的安全公告和版本更新及时备份系统和数据