如何使用Cobbler进行Ubuntu系统的故障排查

Cobbler部署Ubuntu的故障排查流程

一 快速定位流程

• 检查核心服务与端口：确认 cobblerd 与 httpd 处于运行状态，确保 TFTP 69/UDP 与 HTTP 80/TCP 可达；必要时查看端口占用与防火墙策略。
• 校验配置与同步：运行 cobbler check 修复配置问题，执行 cobbler sync 使 DHCP/TFTP/引导文件生效。
• 查看日志：优先检查 /var/log/cobbler/cobbler.log 与 /var/log/cobbler/http.log，从报错时间点回溯关键线索。
• 引导文件与签名：确认 /var/lib/cobbler/loaders 具备必要引导文件（如 pxelinux.0、menu.c32、grub.efi），缺失时执行 cobbler get-loaders；导入镜像后执行 cobbler signature update 提升识别度。
• 网络引导参数：在 DHCP 模板中确保 next-server 指向 Cobbler 服务器地址，filename 为 /pxelinux.0（或相应的 UEFI 启动文件）。

二 常见故障与修复要点

• 服务未运行或端口被占用：使用 systemctl 启动 cobblerd/httpd，用 netstat 检查 80 端口占用；必要时调整配置或释放端口后重启服务。
• Web 界面 500 错误：查看 /var/log/cobbler/http.log 与 cobbler.log 定位；常见为模块缺失、配置语法错误或权限问题，修正后重启 httpd/cobblerd。
• DHCP/TFTP 未就绪：确认 TFTP 已启用（如修改 /etc/xinetd.d/tftp 的 disable=no 并启动服务），DHCP 模板中 next-server/filename 正确；外部 DHCP 场景下不要与 Cobbler 管理的 DHCP 冲突。
• 引导文件缺失：执行 cobbler get-loaders 补齐 pxelinux.0、menu.c32、grub.efi 等文件。
• cobbler check 报错或 login failed：重启 cobblerd 后执行 cobbler get-loaders；必要时复核配置与依赖。
• 导入镜像失败或不完整：执行 cobbler signature update 后重新导入；空间不足时清理无用镜像与仓库。
• 安装速度极慢：默认的 Ubuntu 种子文件可能从 security.ubuntu.com 拉取软件包，将种子中的源地址改为本地镜像（如 http://<cobbler_ip>/cobbler/ks_mirror//）以提速。

三 Ubuntu场景的专项检查

• 种子文件与软件源：确保使用或自定义 Ubuntu seed（preseed），将 d-i mirror/http/hostname 与 d-i mirror/http/directory 指向本地 cobbler/ks_mirror 路径，避免安装阶段访问外网导致慢速或失败。
• 发行版与架构识别：导入时使用 –breed=ubuntu 与正确的 –os-version，必要时运行 cobbler signature update 后重试导入。
• 引导方式匹配：在 /var/lib/tftpboot/pxelinux.cfg/ 或 grub/grub.cfg 中确认 pxelinux.0/menu.c32 或 grub.efi 与客户端 BIOS/UEFI 一致；必要时为 UEFI 客户端单独配置引导项。
• 仓库与同步：若使用 cobbler reposync 提供本地 APT 仓库，确认 debmirror 已安装且网络可达；同步完成后在 profile 中正确关联并重新 cobbler sync。

四 最小复现与验证步骤

• 导入镜像：挂载 Ubuntu ISO 后执行
  sudo mount -o loop /path/to/ubuntu.iso /mnt/ubuntu
  sudo cobbler import --path=/mnt/ubuntu --name=Ubuntu-20.04 --breed=ubuntu --os-version=focal
  若失败，执行 cobbler signature update 再导入。
• 校验与同步：
  cobbler check
  cobbler sync
• 服务与端口：
  sudo systemctl restart cobblerd httpd
  sudo systemctl enable --now tftp
  sudo firewall-cmd --permanent --add-service={http,tftp} && sudo firewall-cmd --reload
  ss -lunpt | egrep ':(69|80) ’
• 客户端验证：在目标主机设置 PXE 启动，观察屏幕输出是否获取到 next-server 与正确的启动文件，安装阶段是否能从本地源拉取软件包。

五 日志与关键文件速查表