Cobbler在Ubuntu中的故障排查技巧

Cobbler在Ubuntu中的故障排查技巧

一、快速自检与最小修复清单

• 执行自检并逐项修复：运行cobbler check，优先处理以下高频项：
  • 将**/etc/cobbler/settings中的server与next_server改为PXE网段的可达IP**（不能是127.0.0.1或localhost）。
  • 启用TFTP：编辑**/etc/xinetd.d/tftp**，把disable = yes改为disable = no，并执行systemctl enable --now tftp。
  • 启动必要服务：systemctl enable --now cobblerd httpd（Ubuntu 上通常使用Apache作为前端）。
  • 下载引导文件：执行cobbler get-loaders，若失败，安装syslinux并手动拷贝关键文件到**/var/lib/cobbler/loaders**（如pxelinux.0、menu.c32）。
  • 同步配置：每次修改后执行cobbler sync使变更生效。
  • 导入镜像后校验：cobbler distro list、cobbler profile list、cobbler report核对架构、内核与initrd路径是否正确。

二、网络引导链路排查

• DHCP关键项：确保DHCP包含next-server <Cobbler_IP>与filename “/pxelinux.0”；若由Cobbler管理DHCP，在**/etc/cobbler/dhcp.template中设置并cobbler sync**；若由外部DHCP提供，手动写入上述两项并重启DHCP。
• TFTP连通与内容：
  • 抓包确认客户端能收到DHCP OFFER/ACK与TFTP RRQ：例如tcpdump -ni <PXE网口> port 67 or port 68 or port 69 -vv。
  • 本机验证读取：例如tftp <Cobbler_IP> -c get pxelinux.0；若失败，检查**/var/lib/tftpboot**是否由Cobbler生成、权限与SELinux/AppArmor是否拦截。
• 防火墙与端口：放行DHCP(67/68 UDP)、TFTP(69 UDP)、HTTP(80/TCP)以及Cobbler API端口（默认25150–25151/TCP）。示例（UFW）：ufw allow 67,68,69,80,25150:25151/tcp。
• 服务状态复核：systemctl status cobblerd httpd tftp，必要时journalctl -xeu cobblerd查看启动期报错。

三、Ubuntu镜像与Preseed专项

• 导入镜像与签名：挂载ISO后执行cobbler import --path=<挂载点> --name=<名称> --breed=ubuntu --os-version=<版本>；若导入失败，先cobbler signature update再重试；管理Debian系仓库需安装debmirror并执行cobbler reposync。
• 校验导入结果：cobbler distro list与cobbler profile list应能看到对应breed=ubuntu的条目；cobbler report核对Architecture、Kernel、Initrd路径是否准确。
• Preseed与网络配置要点：
  • 在**/var/lib/cobbler/kickstarts/放置或编辑Ubuntu preseed，确保url --url=$tree可访问到/var/www/cobbler/**下的镜像内容。
  • 避免**/etc/network/interfaces被覆盖（Ubuntu 14.04等早期版本常见）：在preseed的late_command中先备份再恢复，或设置d-i netcfg/target_network_config select ifupdown以使用ifupdown**避免覆盖。
  • 示例思路（late_command片段）：备份**/etc/network/interfaces**、恢复、重启网络，并将恢复脚本加入rc.local以确保生效。

四、Web界面与认证问题

• 访问方式：Cobbler Web仅支持HTTPS，请使用https://<服务器IP>/cobbler_web；若访问异常，查看**/var/log/apache2/error.log与/var/log/cobbler/**相关日志。
• 常见报错与处置：
  • 403 Forbidden：多因未启用或限制访问策略不当，核对Apache虚拟主机配置与目录权限。
  • Internal Server Error：常见于Python/Django版本不匹配或模块缺失，按日志升级相关组件并重启Apache。
  • 登录失败（login failed）：重启cobblerd后执行cobbler get-loaders，再尝试登录。

五、高频错误速查表