automatic-installation=1 银河麒麟安装卡在引导界面怎么办

Question

在使用银河麒麟操作系统进行自动化安装时，若在引导界面卡住且无后续响应，常见原因为 `automatic-installation=1` 参数未正确加载或配置文件路径错误。系统可能无法读取自动安装配置（如 autoinstall-config 文件），或缺失必要的驱动支持导致初始化失败。此外，UEFI/BIOS 模式与镜像启动方式不匹配、ISO 镜像损坏或写入U盘工具出错也会引发此问题。需检查启动参数是否完整，确认 `autoinstall-distro` 和 `autoinstall-config=` 路径有效，并确保安装介质可正常读取。

Answer 1

一、现象描述与初步排查

在使用银河麒麟操作系统进行无人值守自动化安装时，若系统在引导界面长时间停滞（如停留在 GRUB 菜单或内核加载后无响应），通常表现为屏幕无输出变化、光标不闪烁或未进入图形/文本安装流程。该问题直接影响部署效率，尤其在大规模服务器批量部署场景中尤为关键。

• 检查是否已正确添加启动参数：automatic-installation=1
• 确认 ISO 镜像是否为官方签名版本，并通过 SHA256 校验完整性
• 验证 U 盘写入工具是否支持持久化写入模式（如 Rufus 使用 ISO 模式而非 DD 模式）
• 观察串口输出或 VGA 输出是否有错误日志（如 “Failed to load autoinstall config”）

二、启动参数配置深度解析

银河麒麟的自动安装依赖于内核命令行参数传递机制。以下为核心参数及其作用：

参数名	必填性	示例值	说明
automatic-installation	是	1	启用自动安装模式
autoinstall-distro	是	kylin	指定发行版类型
autoinstall-config	是	/cdrom/autoinstall.yaml	配置文件路径，必须可访问
quiet splash	否	-	静默模式，调试时建议移除

三、配置文件路径有效性验证流程

常见错误源于 autoinstall-config= 指向的路径无法被 initrd 环境挂载读取。需确保：

1. 配置文件位于 ISO 的根目录或指定路径下
2. 文件系统格式为 ISO9660 或 UDF，避免 NTFS/FAT32 兼容性问题
3. 使用 isoinfo -i image.iso -l 命令验证文件结构
4. 在制作定制镜像时，将 autoinstall.yaml 放入 ./ 或 /isolinux/ 目录
5. 测试阶段可通过移除 quiet 参数查看详细加载日志

四、UEFI/BIOS 启动模式兼容性分析

现代服务器平台存在双模式启动需求，若 ISO 仅构建了单一启动链，则易导致卡死。

# 查看 ISO 是否包含双启动支持
isoinfo -d -i kylin-server.iso | grep -E "(El Torito|Platform)"

# 正常输出应包含：
# Platform ID: 0 (80x86)
# Platform ID: EF (EFI), ID String: EFI 
    

若缺失 EFI 条目，则 BIOS 模式无法启动；反之亦然。推荐使用 grub-mkrescue 重新打包支持混合模式的镜像。

五、驱动缺失与初始化失败诊断

部分国产硬件平台（如飞腾、龙芯）需特定模块支持存储控制器或网卡。initramfs 若未集成对应 ko 文件，会导致根文件系统无法挂载。

graph TD A[引导启动] --> B{检测硬件平台} B -->|飞腾FT-2000+| C[加载 hypervisor.ko] B -->|龙芯3A5000| D[加载 loongson-pci.ko] C --> E[挂载 squashfs] D --> E E --> F[读取 autoinstall.yaml] F --> G[执行自动化脚本]

六、介质写入可靠性保障方案

U盘写入过程中的块错位或缓冲区溢出可能导致扇区损坏。推荐采用以下方法：

• 使用 dd if=kylin.iso of=/dev/sdX bs=4M status=progress oflag=sync
• 替代工具：Etcher（支持校验）、UltraISO（需关闭“优化”选项）
• 写入后执行 md5sum /dev/sdX 与原 ISO 对比
• 在目标机器上执行 memtest86+ 排除内存干扰
• 设置 BIOS 中禁用快速启动以保证完整 POST 流程

七、日志捕获与远程调试技巧

对于无显示器环境，可通过串口重定向获取内核启动信息：

linux /vmlinuz automatic-installation=1 autoinstall-distro=kylin \
autoinstall-config=file:///autoinstall.yaml console=ttyS0,115200n8
    

结合 IPMI KVM 或 BMC 远程控制台，实时抓取 early boot 日志，定位 “No such file or directory” 类报错来源。

八、综合排查清单（Checklist）

✅ 参数 automatic-installation=1 已添加	是/否
✅ autoinstall-config 路径存在于 ISO 中	是/否
✅ ISO 经过 SHA256 校验一致	是/否
✅ U盘使用 dd 或 Etcher 写入	是/否
✅ UEFI/BIOS 模式与 ISO 构建一致	是/否
✅ initrd 包含必要驱动模块	是/否
✅ 移除 quiet 参数进行调试	是/否
✅ 使用串口输出捕获异常	是/否
✅ autoinstall.yaml 符合 YAML 语法规范	是/否
✅ 文件系统权限允许 root 读取	是/否