From 1c9a2ce6590f6a26fda2059ba59caff059f9ecfb Mon Sep 17 00:00:00 2001 From: wu-donger Date: Thu, 17 Apr 2025 19:06:46 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=96=87=E4=BB=B6=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/zh/faq/_toc.yaml | 2 +- docs/zh/faq/caselibrary/caselibrary_menu.md | 2 +- .../{huanbiao.md => rebranding.md} | 188 +++++++++--------- ...ent-guide-for-offline-environment-faqs.md} | 0 4 files changed, 96 insertions(+), 96 deletions(-) rename docs/zh/faq/caselibrary/{huanbiao.md => rebranding.md} (96%) rename docs/zh/faq/community_tools/{deployment-guide-for-offlinek-environment-faqs.md => deployment-guide-for-offline-environment-faqs.md} (100%) diff --git a/docs/zh/faq/_toc.yaml b/docs/zh/faq/_toc.yaml index 736160831..1f480d7de 100644 --- a/docs/zh/faq/_toc.yaml +++ b/docs/zh/faq/_toc.yaml @@ -50,7 +50,7 @@ sections: - label: AI href: ./community_tools/deployment-guide-for-network-environment-faqs.md - label: AI（无网络环境） - href: ./community_tools/deployment-guide-for-offlinek-environment-faqs.md + href: ./community_tools/deployment-guide-for-offline-environment-faqs.md - label: isocut href: ./community_tools/isocut_faqs.md - label: DDE diff --git a/docs/zh/faq/caselibrary/caselibrary_menu.md b/docs/zh/faq/caselibrary/caselibrary_menu.md index adcd116db..e8c8378a7 100644 --- a/docs/zh/faq/caselibrary/caselibrary_menu.md +++ b/docs/zh/faq/caselibrary/caselibrary_menu.md @@ -14,6 +14,6 @@ | 10 | 开发者反馈 | 容器 | pvs、vgs | [pvs或vgs出现Unknown问题](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/pvs_vgs.md) | | 11 | 开发者反馈 | 存算 | kdump、kexe-tools，vmcore | [kdump常见问题](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/crash.md) | | 12 | 开发者反馈 | 安装 | efivars | [安装出现efivars报错](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/efivars.md) | -| 13 | 开发者反馈 | 安装 | 换标 | [换标常见问题](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/huanbiao.md) | +| 13 | 开发者反馈 | 安装 | 换标 | [换标常见问题](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/rebranding.md) | | 14 | 开发者反馈 | 安装 | anaconda | [anaconda安装常见磁盘问题](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/anaconda.md) | | 15 | 开发者反馈 | 安装 | 系统文件 | [系统文件恢复问题](https://gitee.com/openeuler/docs/blob/common/docs/zh/faq/caselibrary/sysfile.md) | diff --git a/docs/zh/faq/caselibrary/huanbiao.md b/docs/zh/faq/caselibrary/rebranding.md similarity index 96% rename from docs/zh/faq/caselibrary/huanbiao.md rename to docs/zh/faq/caselibrary/rebranding.md index a3ef42ffb..be5c68a60 100644 --- a/docs/zh/faq/caselibrary/huanbiao.md +++ b/docs/zh/faq/caselibrary/rebranding.md @@ -1,94 +1,94 @@ -# 换标常见问题 - -## 场景1：安装失败，提示无法写入boot loader配置 - -### 问题背景 - -使用openEuler系统软件包，进行对应的换标替换，但在进行安装中出现安装失败。 - -### 现象描述 - -在进行镜像安装时，安装失败，提示无法写入boot loader配置信息。 - -![image](./figures/换标_config.png) - -### 原因分析 - -CTRL+ALT+F2切换后台查看/tmp/anaconda.log日志。 - -![image](./figures/换标_config_日志.png) - -从日志中看到并未找到对应的bootloader配置文件。 -主要原因是安装中会去检查/etc/os-release文件对应的"ID"和"VARIANT_ID"。 - -![image](./figures/换标_config_检查.png) - -### 解决方案 - -修改anaconda中的openEuler.conf的"Profile Detection"下的"os_id"和"variant_id"与换标系统中的os-release文件保持一致。 - ![image](./figures/换标_config_修改.png) - -## 场景2：安装成功，无法正常进入系统 - -### 问题背景 - -换标后能进行正常的镜像安装，但安装后无法正常启动。 - -### 现象描述 - -启动时提示无法正常找到efi启动文件。 - ![image](./figures/换标_未完全.png) - -### 原因分析 - -存在部分软件包未完全换标，grub软件包换标存在遗漏情况。 - -### 解决方案 - -1.查看启动项是否存在不正确的情况。 - ![image](./figures/换标_未完全_配置.png) -2. 参考[系统文件恢复问题](./sysfile.md)文档，可以进入系统后调整对应的启动配置文件。 -3. 完全解决换标问题，需要修改构建工程中的grub.cfg。 - -## 场景3：换标后构建kernel，安装依赖tk组件失败 - -### 问题背景 - -换标使用obs构建openEuler的同源包，出现tk安装出现错误。 - -![image](./figures/换标_构建kernel_报错.png) - -### 现象描述 - -对tk软件包进行安装检查，单独安装同样存在报错现象。错误为组件的%post阶段。 -![image](./figures/换标_tk_安装失败.png) - -### 原因分析 - -spec中的%ldconfig_post、%ldconfig_postun未识别，导致安装软件中带入误认为脚本，并报错。 -![image](./figures/换标_tk_报错.png) - -### 解决方案 - -需要修改换标工程中的rpm-config宏定义。 - -## 场景4：安装中报POSTTRANS scriptlet错误 - -### 问题背景 - -换标或者自构建软件镜像，在安装时出现 POSTTRANS scriptlet错误。 -![image](./figures/换标_script_报错.png) - -### 现象描述 - -1. CTRL+ALT+F2切换后台，进入/mnt/sysroot目录，切根。 -2. 执行dnf history info 1，可以看到post哪边执行出错。 - ![image](./figures/换标_script_post.png) - -### 原因分析 - -软件安装后执行%POSTTRANS出错,未能找到相关的gz文件。 - -### 解决方案 - -分析软件包spec文件的%post脚本，修改后本地安装无问题后可以再次进行安装。 +# 换标常见问题 + +## 场景1：安装失败，提示无法写入boot loader配置 + +### 问题背景 + +使用openEuler系统软件包，进行对应的换标替换，但在进行安装中出现安装失败。 + +### 现象描述 + +在进行镜像安装时，安装失败，提示无法写入boot loader配置信息。 + +![image](./figures/换标_config.png) + +### 原因分析 + +CTRL+ALT+F2切换后台查看/tmp/anaconda.log日志。 + +![image](./figures/换标_config_日志.png) + +从日志中看到并未找到对应的bootloader配置文件。 +主要原因是安装中会去检查/etc/os-release文件对应的"ID"和"VARIANT_ID"。 + +![image](./figures/换标_config_检查.png) + +### 解决方案 + +修改anaconda中的openEuler.conf的"Profile Detection"下的"os_id"和"variant_id"与换标系统中的os-release文件保持一致。 + ![image](./figures/换标_config_修改.png) + +## 场景2：安装成功，无法正常进入系统 + +### 问题背景 + +换标后能进行正常的镜像安装，但安装后无法正常启动。 + +### 现象描述 + +启动时提示无法正常找到efi启动文件。 + ![image](./figures/换标_未完全.png) + +### 原因分析 + +存在部分软件包未完全换标，grub软件包换标存在遗漏情况。 + +### 解决方案 + +1.查看启动项是否存在不正确的情况。 + ![image](./figures/换标_未完全_配置.png) +2. 参考[系统文件恢复问题](./sysfile.md)文档，可以进入系统后调整对应的启动配置文件。 +3. 完全解决换标问题，需要修改构建工程中的grub.cfg。 + +## 场景3：换标后构建kernel，安装依赖tk组件失败 + +### 问题背景 + +换标使用obs构建openEuler的同源包，出现tk安装出现错误。 + +![image](./figures/换标_构建kernel_报错.png) + +### 现象描述 + +对tk软件包进行安装检查，单独安装同样存在报错现象。错误为组件的%post阶段。 +![image](./figures/换标_tk_安装失败.png) + +### 原因分析 + +spec中的%ldconfig_post、%ldconfig_postun未识别，导致安装软件中带入误认为脚本，并报错。 +![image](./figures/换标_tk_报错.png) + +### 解决方案 + +需要修改换标工程中的rpm-config宏定义。 + +## 场景4：安装中报POSTTRANS scriptlet错误 + +### 问题背景 + +换标或者自构建软件镜像，在安装时出现 POSTTRANS scriptlet错误。 +![image](./figures/换标_script_报错.png) + +### 现象描述 + +1. CTRL+ALT+F2切换后台，进入/mnt/sysroot目录，切根。 +2. 执行dnf history info 1，可以看到post哪边执行出错。 + ![image](./figures/换标_script_post.png) + +### 原因分析 + +软件安装后执行%POSTTRANS出错,未能找到相关的gz文件。 + +### 解决方案 + +分析软件包spec文件的%post脚本，修改后本地安装无问题后可以再次进行安装。 diff --git a/docs/zh/faq/community_tools/deployment-guide-for-offlinek-environment-faqs.md b/docs/zh/faq/community_tools/deployment-guide-for-offline-environment-faqs.md similarity index 100% rename from docs/zh/faq/community_tools/deployment-guide-for-offlinek-environment-faqs.md rename to docs/zh/faq/community_tools/deployment-guide-for-offline-environment-faqs.md -- Gitee