Operating System Specific Workarounds/Debian

Debian-Specific Issues and Workarounds

Bullseye

Blank VGA

Cause

The required open-source (libre) video driver module ("ast") is not included in the installer package

Upstream Bug Report

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=990016

Status

Root cause found, solution provided, upstream not responding

Workaround

Debian can be installed via the serial console, then switched to VGA mode after installation (i.e. after the ASpeed driver module is available to the kernel). The following instructions assume you have SSH shell access to the BMC:

• Install

1. With system power off, SSH to the BMC
2. Run 'obmc-console-client' on the BMC to attach the current SSH shell to the serial console
3. Attach the Debian install media
4. Power on the system
5. When the Petitboot screen appears, select the Debian install option you want and press 'e' to edit
6. Highlight the "Boot arguments" field and append "console=hvc0" after "quiet". Ensure there is at least one space between "quiet" and "console=hvc0".
7. Highlight OK and press Enter
8. Ensure the previously-selected Debian install option is still selected, then press Enter
9. Install Debian normally

• Switch from serial to VGA text console

1. Edit /etc/modules and append "ast" to it
2. As root, run update-initramfs -u -k all
3. Edit /etc/default/grub and change the "console=hvc0" string to "console=tty0"
4. As root, run update-grub
5. Reboot