Reconstruir um initramfs: dracut -f versus update-initramfs -u e como verificar o resultado

Objetivo

Regenerar o initramfs do kernel em execução (ou de um kernel específico) depois de uma alteração que afete o início do boot — um novo driver de armazenamento, uma mudança na configuração do LUKS, uma mudança num array mdadm ou uma edição em /etc/fstab//etc/crypttab que o userspace inicial precise conhecer — e confirmar que a nova imagem realmente contém o que mudou.

Pré-requisitos

Acesso root; espaço livre suficiente em /boot para uma nova imagem ao lado da antiga; o kernel atualmente em uso ainda funcionando (faça isto antes de reiniciar, e não ao diagnosticar um boot que já está quebrado, a menos que trabalhe a partir de um chroot).

Passos

1. Copie primeiro a imagem atual (cp -p /boot/initramfs-<version>.img /root/; no Debian/Ubuntu, /boot/initrd.img-<version>), para poder restaurá-la se a nova falhar. No RHEL, Fedora e SUSE (sistemas baseados em dracut), reconstrua a imagem do kernel em execução com dracut -f (-f/--force sobrescreve o arquivo initramfs existente); para qualquer outro kernel, indique explicitamente o nome da imagem e a versão, por exemplo dracut -f /boot/initramfs-<version>.img <version> (no SUSE o arquivo se chama /boot/initrd-<version>). Dentro de um chroot, uname -r informa o kernel de resgate, portanto passe sempre a versão nesse caso.
2. No Debian, Ubuntu e derivados (initramfs-tools), reconstrua a imagem existente com update-initramfs -u -k <version> (-u "atualiza um initramfs existente"; sem -k, o alvo é o kernel mais recente instalado, não necessariamente o que está em execução; use -k all para reconstruir para todos os kernels instalados depois de uma mudança que afete todos eles, como adicionar um módulo de sistema de arquivos ou alterar /etc/crypttab).
3. Saiba quando é necessário reconstruir e quando basta um update-grub: ao adicionar/remover um driver de armazenamento fora da árvore do kernel, ao mudar quais módulos o dracut.conf/initramfs-tools inclui, ao mudar um keyfile LUKS ou uma entrada do crypttab, ou ao mudar o layout RAID que o mdadm deve montar no boot. Uma atualização do pacote do kernel normalmente dispara isso automaticamente por meio dos hooks do gerenciador de pacotes; uma mudança manual de configuração geralmente não.
4. Verifique o conteúdo antes de reiniciar: lsinitrd lista o conteúdo de uma imagem initramfs criada com dracut (por padrão a do kernel atual, ou a de um caminho de imagem indicado); nos sistemas da família Debian, lsinitramfs /boot/initrd.img-<version> lista os arquivos contidos no archive. Use grep na listagem para procurar o módulo ou arquivo esperado (um driver .ko, uma entrada do crypttab, um mdadm.conf) e confirmar que está presente.
5. Mantenha pelo menos um kernel mais antigo, com o initramfs correspondente, instalado como entrada de fallback no menu de boot; não remova o pacote do kernel anterior enquanto o novo initramfs não tiver feito boot com sucesso pelo menos uma vez.
6. Reinicie para testar. Se o sistema não iniciar, selecione a entrada do kernel de fallback no menu de boot — é por isso que o passo 5 importa — e reconstrua de novo depois de diagnosticar o problema a partir de uma sessão funcional.

Resultado esperado

A listagem da nova imagem (lsinitrd / lsinitramfs) mostra o driver, a entrada do crypttab ou a configuração do mdadm que motivou a reconstrução; o boot seguinte chega ao sistema de arquivos raiz sem cair num shell do initramfs.

Limites e base de verificação

Nem dracut -f nem update-initramfs -u têm um comando para desfazer; as redes de segurança são a imagem copiada (copie-a de volta a partir do kernel de fallback ou de um boot de resgate) e a entrada do kernel de fallback. Regenerar para a versão errada do kernel (um erro comum quando há vários instalados) deixa, sem nenhum aviso, a imagem do kernel em execução inalterada.