====== POP - Diagnóstico e Recuperação de Boot EFI/GRUB no Proxmox VE e Proxmox Backup Server ======

===== Objetivo =====

Este POP tem como objetivo auxiliar administradores na:

* Identificação de falhas de boot
* Descoberta da estrutura de discos do ambiente
* Identificação de partições EFI
* Identificação de RAID/ZFS
* Descoberta do local do sistema operacional
* Recuperação do GRUB/EFI
* Recuperação pós-upgrade
* Recuperação após falhas de boot

Compatível com:

* Proxmox VE
* Proxmox Backup Server
* Debian
* RAID mdadm
* ZFS
* EXT4
* UEFI

===== Cenários Comuns =====

* Sistema não sobe após upgrade
* Kernel panic
* GRUB corrompido
* Loop de boot
* Boot travado
* "No bootable device"
* Erro de EFI
* Sistema inicia apenas em rescue
* Ambiente inacessível após atualização do Proxmox

===== Pré-requisitos =====

* Acesso ao Rescue System ou Live Linux
* Acesso root
* Conhecimento básico Linux
* Backup recomendado

===== 1. Identificando Estrutura do Ambiente =====

===== Listar discos =====

<code bash>
lsblk
</code>

===== Exemplo =====

<code>
NAME         SIZE TYPE
sda          5.5T disk
sdb          5.5T disk
sdc          5.5T disk
sdd          5.5T disk
nvme0n1      476G disk
nvme1n1      476G disk
md2            1G raid1
md3          450G raid1
</code>

===== Como interpretar =====

^ Estrutura ^ Interpretação ^
| HDDs grandes | Geralmente storage ZFS |
| SSD/NVMe menores | Geralmente sistema operacional |
| mdX | RAID mdadm |
| zfs_member | Disco pertencente ao pool ZFS |
| vfat | Partição EFI |
| ext4 | Sistema Linux |

===== Identificar partições =====

<code bash>
blkid
</code>

===== Exemplos Importantes =====

==== EFI =====

<code>
TYPE="vfat"
LABEL="EFI_SYSPART"
</code>

==== RAID =====

<code>
TYPE="linux_raid_member"
</code>

==== ROOT =====

<code>
LABEL="root"
TYPE="ext4"
</code>

==== BOOT =====

<code>
LABEL="boot"
TYPE="ext4"
</code>

==== ZFS =====

<code>
TYPE="zfs_member"
</code>

===== 2. Descobrindo Onde Está o Sistema Operacional =====

===== Estrutura mais comum em RAID1 =====

^ Partição ^ Função ^
| /dev/md3 | Root do sistema |
| /dev/md2 | /boot |
| /dev/nvme0n1p1 | EFI principal |
| /dev/nvme1n1p1 | EFI secundária |

===== Identificando ROOT =====

Normalmente:

<code>
LABEL="root"
TYPE="ext4"
</code>

===== Identificando BOOT =====

Normalmente:

<code>
LABEL="boot"
TYPE="ext4"
</code>

===== Identificando EFI =====

Normalmente:

<code>
TYPE="vfat"
</code>

===== Identificando Storage ZFS =====

Exemplo:

<code>
/dev/sda1
/dev/sdb1
/dev/sdc1
/dev/sdd1
</code>

===== 3. Validando RAID =====

===== Verificar status =====

<code bash>
cat /proc/mdstat
</code>

===== Resultado esperado =====

<code>
md3 : active raid1
md2 : active raid1
</code>

===== Ver detalhes =====

<code bash>
mdadm --detail --scan
</code>

===== Ver array específico =====

<code bash>
mdadm --detail /dev/md3
</code>

===== Se RAID não subir =====

<code bash>
mdadm --assemble --scan
</code>

===== 4. Validando ZFS =====

===== Descobrir pools =====

<code bash>
zpool import
</code>

===== Importar pool =====

<code bash>
zpool import -f NOME_DO_POOL
</code>

===== Verificar status =====

<code bash>
zpool status
</code>

===== Ver datasets =====

<code bash>
zfs list
</code>

===== Interpretação =====

Se o pool aparecer como:

<code>
ONLINE
</code>

Há forte indicativo de integridade do storage.

===== 5. Validando UEFI =====

===== Verificar se sistema usa UEFI =====

<code bash>
ls /sys/firmware/efi
</code>

===== Interpretação =====

Se existir conteúdo:

* Ambiente utiliza UEFI

===== 6. Montando o Ambiente =====

===== Montar ROOT =====

Exemplo:

<code bash>
mount /dev/md3 /mnt
</code>

===== Montar BOOT =====

<code bash>
mkdir -p /mnt/boot
mount /dev/md2 /mnt/boot
</code>

===== Montar EFI =====

<code bash>
mkdir -p /mnt/boot/efi
mount /dev/nvme0n1p1 /mnt/boot/efi
</code>

===== 7. Preparando Chroot =====

===== Montar pseudo-filesystems =====

<code bash>
mount --bind /dev /mnt/dev
mount --bind /proc /mnt/proc
mount --bind /sys /mnt/sys
mount --bind /run /mnt/run
</code>

===== Entrar no ambiente =====

<code bash>
chroot /mnt
</code>

===== 8. Validando Estrutura EFI =====

===== Verificar conteúdo =====

<code bash>
ls -R /boot/efi
</code>

===== Estrutura esperada =====

<code>
/boot/efi/EFI/proxmox
</code>

===== Arquivos esperados =====

<code>
grubx64.efi
shimx64.efi
grub.cfg
</code>

===== 9. Corrigindo GRUB EFI =====

===== Reinstalar GRUB =====

<code bash>
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=proxmox
</code>

===== Possível Warning =====

<code>
EFI variables cannot be set on this system
</code>

===== Interpretação =====

Comum em Rescue Systems.
Não impede funcionamento do boot.

===== Atualizar configuração =====

<code bash>
update-grub
</code>

===== Regenerar initramfs =====

<code bash>
update-initramfs -u -k all
</code>

===== Possível Warning =====

<code>
No /etc/kernel/proxmox-boot-uuids found
</code>

===== Interpretação =====

Pode ocorrer em ambientes sem proxmox-boot-tool.

===== 10. Criando Fallback EFI =====

Alguns servidores/provedores não gravam corretamente EFI na NVRAM.

===== Criar estrutura =====

<code bash>
mkdir -p /boot/efi/EFI/BOOT
</code>

===== Criar fallback =====

Recomendado:

<code bash>
cp /boot/efi/EFI/proxmox/shimx64.efi /boot/efi/EFI/BOOT/BOOTX64.EFI
</code>

===== Alternativa =====

<code bash>
cp /boot/efi/EFI/proxmox/grubx64.efi /boot/efi/EFI/BOOT/BOOTX64.EFI
</code>

===== 11. Validando Discos =====

===== Instalar smartmontools =====

<code bash>
apt install smartmontools -y
</code>

===== Verificar disco =====

<code bash>
smartctl -a /dev/sda
</code>

===== Validar =====

* Reallocated_Sector_Ct
* Current_Pending_Sector
* Offline_Uncorrectable
* Erros ATA

===== 12. Validando Espaço =====

===== Verificar utilização =====

<code bash>
df -h
</code>

===== Validar especialmente =====

* /
* /boot
* datastore
* storage ZFS

===== 13. Logs e Diagnóstico =====

===== Ver logs do boot =====

<code bash>
journalctl -xb
</code>

===== Ver mensagens do kernel =====

<code bash>
dmesg
</code>

===== Ver erros críticos =====

<code bash>
journalctl -p 3 -xb
</code>

===== 14. Serviços Proxmox =====

===== Proxmox VE =====

<code bash>
systemctl status pveproxy
systemctl status pvedaemon
systemctl status pvestatd
</code>

===== Proxmox Backup Server =====

<code bash>
systemctl status proxmox-backup
systemctl status proxmox-backup-proxy
</code>

===== 15. Rede =====

===== Interfaces =====

<code bash>
ip a
</code>

===== Rotas =====

<code bash>
ip route
</code>

===== DNS =====

<code bash>
cat /etc/resolv.conf
</code>

===== 16. Finalização =====

===== Sair do chroot =====

<code bash>
exit
</code>

===== Desmontar ambiente =====

<code bash>
umount -R /mnt
</code>

===== Reiniciar =====

<code bash>
reboot
</code>

===== 17. Problemas Comuns =====

===== Sistema continua entrando em Rescue =====

Verificar:

* Rescue mode desabilitado
* ISO virtual removida
* Ordem de boot correta
* Disco correto configurado

===== Pool ZFS não importa =====

Executar:

<code bash>
zpool import -f NOME_DO_POOL
</code>

===== RAID degradado =====

Verificar:

<code bash>
cat /proc/mdstat
</code>

===== Kernel não encontrado =====

Verificar:

<code bash>
ls /boot
</code>

===== EFI vazia =====

Reinstalar GRUB.

===== Sem espaço em /boot =====

Remover kernels antigos.

===== 18. Boas Práticas =====

* Manter múltiplas EFI
* Validar SMART periodicamente
* Validar RAID periodicamente
* Validar boot após upgrades
* Testar recovery
* Manter documentação da estrutura do ambiente
* Possuir backup externo
* Monitorar espaço em /boot

===== 19. Comandos Rápidos =====

===== Discos =====

<code bash>
lsblk
fdisk -l
blkid
</code>

===== RAID =====

<code bash>
cat /proc/mdstat
mdadm --detail --scan
</code>

===== EFI =====

<code bash>
efibootmgr -v
</code>

===== ZFS =====

<code bash>
zpool status
zpool import
zfs list
</code>

===== Espaço =====

<code bash>
df -h
</code>

===== SMART =====

<code bash>
smartctl -a /dev/sda
</code>

===== Logs =====

<code bash>
journalctl -xb
dmesg
</code>

===== Referências =====

* https://pve.proxmox.com/wiki/Host_Bootloader
* https://pbs.proxmox.com/docs/
* https://wiki.debian.org/UEFI