Essa é uma revisão anterior do documento!
Tabela de conteúdos
POP - Recuperação de Boot EFI/GRUB no Proxmox VE e Proxmox Backup Server
Objetivo
Este procedimento operacional padrão (POP) tem como objetivo auxiliar na identificação e recuperação de falhas relacionadas ao boot EFI/GRUB em ambientes:
* Proxmox VE * Proxmox Backup Server * Debian com EFI * Ambientes RAID1 (mdadm) * Ambientes ZFS
Problemas de boot podem ocorrer após:
* Atualizações de kernel * Atualizações do Proxmox * Falhas de energia * Corrupção de EFI * Falha de discos * Atualizações incompletas * Problemas em initramfs * Inconsistências no GRUB
Sintomas Comuns
* Sistema não inicia após upgrade
* Tela preta após BIOS/UEFI
* Mensagem grub rescue>
* Kernel panic
* Boot loop
* Sistema entra apenas em rescue mode
* Erro de EFI/bootloader
* Falha após atualização do Proxmox
Pré-requisitos
* Acesso via Rescue System / Live Linux * Acesso root * Conhecimento básico de Linux * Backup recomendado
1. Identificando Estrutura do Ambiente
Verificar discos e partições
lsblk
Identificar UUIDs e tipos de partição
blkid
Validar arrays RAID
cat /proc/mdstat
Verificar pools ZFS
zpool import
Estruturas Mais Comuns
Ambiente RAID1 EXT4
Exemplo:
| Partição | Função |
|---|---|
| /dev/md2 | /boot |
| /dev/md3 | / |
| /dev/nvme0n1p1 | EFI |
| /dev/nvme1n1p1 | EFI |
Ambiente ZFS Root
Exemplo:
| Pool | Função |
|---|---|
| rpool | Sistema operacional |
| bpool | Boot |
| EFI | Partição EFI |
2. Validando o Tipo de Boot
Verificar se o ambiente usa UEFI
ls /sys/firmware/efi
Se existir conteúdo:
* Sistema utiliza UEFI
3. Montando o Sistema
Montar Root
Exemplo EXT4 RAID:
mount /dev/md3 /mnt
Montar Boot
mkdir -p /mnt/boot mount /dev/md2 /mnt/boot
Montar EFI
mkdir -p /mnt/boot/efi mount /dev/nvme0n1p1 /mnt/boot/efi
4. Preparando Chroot
Montar pseudo-filesystems
mount --bind /dev /mnt/dev mount --bind /proc /mnt/proc mount --bind /sys /mnt/sys mount --bind /run /mnt/run
Entrar no ambiente
chroot /mnt
5. Reinstalando o GRUB EFI
Reinstalação padrão
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=proxmox
6. Regenerando Configurações
Atualizar configuração do GRUB
update-grub
Regenerar initramfs
update-initramfs -u -k all
7. Validando Estrutura EFI
Verificar arquivos EFI
ls -R /boot/efi
Estrutura esperada:
/boot/efi/EFI/proxmox /boot/efi/EFI/BOOT
8. Criando Fallback EFI
Alguns servidores não gravam corretamente variáveis EFI na NVRAM.
Nestes casos é recomendado criar fallback EFI.
Criar estrutura
mkdir -p /boot/efi/EFI/BOOT
Copiar loader
Recomendado:
cp /boot/efi/EFI/proxmox/shimx64.efi /boot/efi/EFI/BOOT/BOOTX64.EFI
Alternativa:
cp /boot/efi/EFI/proxmox/grubx64.efi /boot/efi/EFI/BOOT/BOOTX64.EFI
9. Ambientes com ZFS
Validar pools
zpool status
Importar pool manualmente
zpool import -f rpool
Validar datasets
zfs list
10. Finalização
Sair do chroot
exit
Desmontar ambiente
umount -R /mnt
Reiniciar
reboot
11. Problemas Comuns
"EFI variables cannot be set on this system"
Normal em ambientes rescue/live Linux.
Não impede funcionamento do boot.
"No /etc/kernel/proxmox-boot-uuids found"
Pode ocorrer em ambientes sem proxmox-boot-tool.
Não necessariamente indica falha.
Sistema continua entrando em rescue
Verificar:
* Modo rescue desabilitado no provedor * Ordem de boot da BIOS/UEFI * Disco correto selecionado * ISO virtual removida
12. Recomendações
* Manter backup atualizado * Validar RAID periodicamente * Validar SMART dos discos * Testar recuperação em ambientes críticos * Manter múltiplas EFI em RAID1 * Validar espaço em /boot * Validar status do ZFS após upgrades
13. Comandos Úteis
Status RAID
cat /proc/mdstat mdadm --detail --scan
Status EFI
efibootmgr -v
Status ZFS
zpool status zfs list
Espaço em disco
df -h
Kernels instalados
ls /boot