From 5828140a3527aca9076576ed3e46631020b125b0 Mon Sep 17 00:00:00 2001
From: root <github_service@egonetix.de>
Date: Thu, 25 Sep 2025 11:44:45 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=94=A7=20Add=20GRUB=20boot=20repair=20too?=
 =?UTF-8?q?ls=20for=20LVM=20migration?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- fix_grub_boot.sh: Comprehensive GRUB repair for external M.2
- diagnose_boot_issue.sh: Diagnostics for boot problems
- Fixes reset/reboot issues after LVM migration
- Handles initramfs, GRUB reinstall, and configuration updates
---
 diagnose_boot_issue.sh | 179 +++++++++++++++++++++++++++
 fix_grub_boot.sh       | 274 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 453 insertions(+)
 create mode 100755 diagnose_boot_issue.sh
 create mode 100755 fix_grub_boot.sh

diff --git a/diagnose_boot_issue.sh b/diagnose_boot_issue.sh
new file mode 100755
index 0000000..5dec252
--- /dev/null
+++ b/diagnose_boot_issue.sh
@@ -0,0 +1,179 @@
+#!/bin/bash
+
+# LVM Boot Diagnostics Script
+# Checks the current state of the LVM migration and identifies boot issues
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log() { echo -e "${BLUE}[$(date '+%H:%M:%S')]${NC} $1"; }
+error() { echo -e "${RED}[ERROR]${NC} $1"; }
+success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
+
+echo -e "${GREEN}=== LVM Boot Diagnostics ===${NC}"
+echo
+
+# Check system state
+log "Checking current system state..."
+echo "Currently booted from: $(df / | tail -1 | awk '{print $1}')"
+echo "Running kernel: $(uname -r)"
+echo "System: $(hostname)"
+echo
+
+# Check available drives  
+log "Available block devices:"
+lsblk -f
+
+echo
+
+# Check LVM status
+log "LVM Status:"
+echo "Physical Volumes:"
+sudo pvs 2>/dev/null || echo "No PVs found"
+
+echo "Volume Groups:"
+sudo vgs 2>/dev/null || echo "No VGs found"
+
+echo "Logical Volumes:"
+sudo lvs 2>/dev/null || echo "No LVs found"
+
+echo
+
+# Check for system-vg specifically
+if sudo vgs system-vg >/dev/null 2>&1; then
+    success "Found system-vg volume group"
+    
+    log "system-vg details:"
+    sudo vgs system-vg
+    sudo lvs system-vg
+    
+    # Try to mount and check contents
+    log "Checking external system contents..."
+    
+    if [ ! -d /tmp/check-external ]; then
+        mkdir -p /tmp/check-external
+        
+        if sudo mount /dev/system-vg/root /tmp/check-external >/dev/null 2>&1; then
+            success "External root filesystem is mountable"
+            
+            # Check key system directories
+            for dir in "/etc" "/boot" "/usr" "/var"; do
+                if [ -d "/tmp/check-external$dir" ]; then
+                    success "Found system directory: $dir"
+                else
+                    warning "Missing system directory: $dir"  
+                fi
+            done
+            
+            # Check for GRUB files
+            if [ -d "/tmp/check-external/boot/grub" ]; then
+                success "GRUB directory found"
+                if [ -f "/tmp/check-external/boot/grub/grub.cfg" ]; then
+                    success "GRUB configuration found"
+                else
+                    warning "GRUB configuration missing"
+                fi
+            else
+                warning "GRUB directory missing"
+            fi
+            
+            # Check fstab
+            if [ -f "/tmp/check-external/etc/fstab" ]; then
+                success "fstab found"
+                log "fstab LVM entries:"
+                grep -E "system-vg|UUID=" "/tmp/check-external/etc/fstab" || echo "No LVM entries found"
+            else
+                warning "fstab missing"
+            fi
+            
+            sudo umount /tmp/check-external
+        else
+            error "Cannot mount external root filesystem"
+        fi
+    fi
+    
+else
+    error "system-vg volume group not found"
+    echo "This suggests the LVM migration did not complete successfully"
+fi
+
+echo
+
+# Check EFI partition
+log "Checking for EFI boot partition..."
+if [ -b /dev/sda1 ]; then
+    success "Found EFI partition /dev/sda1"
+    
+    if [ ! -d /tmp/check-efi ]; then
+        mkdir -p /tmp/check-efi
+        
+        if sudo mount /dev/sda1 /tmp/check-efi >/dev/null 2>&1; then
+            success "EFI partition is mountable"
+            
+            if [ -d "/tmp/check-efi/EFI" ]; then
+                success "EFI directory found"
+                log "EFI boot entries:"
+                ls -la "/tmp/check-efi/EFI/" 2>/dev/null || echo "No EFI entries"
+                
+                if [ -f "/tmp/check-efi/EFI/debian/grubx64.efi" ]; then
+                    success "Debian GRUB EFI bootloader found"
+                else
+                    warning "Debian GRUB EFI bootloader missing"
+                fi
+            else
+                warning "EFI directory missing"
+            fi
+            
+            sudo umount /tmp/check-efi
+        else
+            error "Cannot mount EFI partition"
+        fi
+    fi
+else
+    error "EFI partition /dev/sda1 not found"
+fi
+
+echo
+
+# Provide diagnosis and recommendations
+log "=== DIAGNOSIS ==="
+
+if sudo vgs system-vg >/dev/null 2>&1; then
+    success "LVM migration appears to have completed"
+    
+    if [ -b /dev/sda1 ] && sudo mount /dev/sda1 /tmp/check-efi >/dev/null 2>&1; then
+        if [ -f "/tmp/check-efi/EFI/debian/grubx64.efi" ]; then
+            success "GRUB bootloader appears to be installed"
+            echo
+            echo -e "${BLUE}Likely causes of boot reset issue:${NC}"
+            echo "1. GRUB configuration points to wrong device"
+            echo "2. initramfs missing LVM support" 
+            echo "3. BIOS/UEFI boot order incorrect"
+            echo "4. Secure Boot enabled (conflicts with GRUB)"
+            echo
+            echo -e "${GREEN}Recommended action:${NC}"
+            echo "Run: sudo ./fix_grub_boot.sh"
+        else
+            warning "GRUB bootloader missing"
+            echo -e "${GREEN}Recommended action:${NC}"
+            echo "Run: sudo ./fix_grub_boot.sh"
+        fi
+        sudo umount /tmp/check-efi 2>/dev/null || true
+    else
+        error "EFI partition issues detected"
+        echo -e "${GREEN}Recommended action:${NC}"  
+        echo "Run: sudo ./fix_grub_boot.sh"
+    fi
+else
+    error "LVM migration incomplete or failed"
+    echo -e "${GREEN}Recommended action:${NC}"
+    echo "Re-run migration: sudo ./migrate_to_lvm.sh"
+fi
+
+# Cleanup
+rm -rf /tmp/check-external /tmp/check-efi 2>/dev/null || true
\ No newline at end of file
diff --git a/fix_grub_boot.sh b/fix_grub_boot.sh
new file mode 100755
index 0000000..aa49004
--- /dev/null
+++ b/fix_grub_boot.sh
@@ -0,0 +1,274 @@
+#!/bin/bash
+
+# GRUB Boot Repair Script for LVM Migration
+# Fixes GRUB bootloader issues after LVM migration to external M.2 drive
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+VG_NAME="system-vg"
+EXTERNAL_DRIVE="/dev/sda"  # Adjust if needed
+
+log() {
+    local message="[$(date '+%Y-%m-%d %H:%M:%S')] $1"
+    echo -e "${BLUE}$message${NC}"
+}
+
+error() {
+    local message="[ERROR] $1"
+    echo -e "${RED}$message${NC}" >&2
+    exit 1
+}
+
+warning() {
+    local message="[WARNING] $1"
+    echo -e "${YELLOW}$message${NC}"
+}
+
+success() {
+    local message="[SUCCESS] $1"
+    echo -e "${GREEN}$message${NC}"
+}
+
+confirm_action() {
+    echo -e "${YELLOW}$1${NC}"
+    read -p "Do you want to continue? [y/N] " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        error "Operation aborted by user"
+    fi
+}
+
+check_prerequisites() {
+    log "Checking prerequisites for GRUB repair..."
+    
+    # Check if running as root
+    if [ "$EUID" -ne 0 ]; then
+        error "This script must be run as root. Use: sudo $0"
+    fi
+    
+    # Check if running from live system
+    local root_device=$(df / | tail -1 | awk '{print $1}')
+    if [[ "$root_device" != *"loop"* ]] && [[ "$root_device" != *"overlay"* ]] && [[ "$root_device" != *"tmpfs"* ]]; then
+        warning "This should be run from a live USB system for safety"
+        confirm_action "Continue anyway? (Not recommended if booting from the problematic system)"
+    fi
+    
+    # Check required tools
+    for tool in grub-install update-grub mount umount lvm; do
+        if ! command -v $tool >/dev/null 2>&1; then
+            error "$tool not found. Please install required packages."
+        fi
+    done
+    
+    success "Prerequisites check passed"
+}
+
+detect_external_drive() {
+    log "Detecting external M.2 drive with LVM..."
+    
+    # Check if LVM volume group exists
+    if ! vgs "$VG_NAME" >/dev/null 2>&1; then
+        # Try to activate volume groups
+        vgchange -ay || warning "Could not activate volume groups"
+        
+        if ! vgs "$VG_NAME" >/dev/null 2>&1; then
+            error "Volume group '$VG_NAME' not found. Is the external drive connected?"
+        fi
+    fi
+    
+    # Display volume group information
+    log "Found volume group '$VG_NAME':"
+    vgs "$VG_NAME"
+    
+    # Check logical volumes
+    local required_lvs=("root" "home" "boot")
+    for lv in "${required_lvs[@]}"; do
+        if ! lvs "$VG_NAME/$lv" >/dev/null 2>&1; then
+            error "Logical volume '$VG_NAME/$lv' not found"
+        fi
+    done
+    
+    success "External LVM drive detected successfully"
+}
+
+mount_external_system() {
+    log "Mounting external LVM system..."
+    
+    local mount_base="/mnt/external-system"
+    mkdir -p "$mount_base"
+    
+    # Mount in correct order
+    log "Mounting root filesystem..."
+    mount "/dev/$VG_NAME/root" "$mount_base" || error "Failed to mount root"
+    
+    log "Mounting boot filesystem..."
+    mkdir -p "$mount_base/boot"
+    mount "/dev/$VG_NAME/boot" "$mount_base/boot" || error "Failed to mount boot"
+    
+    log "Mounting EFI partition..."
+    mkdir -p "$mount_base/boot/efi"
+    # Find EFI partition (usually first partition on external drive)
+    local efi_partition="${EXTERNAL_DRIVE}1"
+    if [ -b "$efi_partition" ]; then
+        mount "$efi_partition" "$mount_base/boot/efi" || error "Failed to mount EFI partition"
+    else
+        error "EFI partition $efi_partition not found"
+    fi
+    
+    log "Mounting home filesystem..."
+    mkdir -p "$mount_base/home"
+    mount "/dev/$VG_NAME/home" "$mount_base/home" || error "Failed to mount home"
+    
+    success "External system mounted at $mount_base"
+    echo "$mount_base"
+}
+
+repair_grub() {
+    local mount_base="$1"
+    log "Repairing GRUB bootloader..."
+    
+    # Bind mount necessary filesystems for chroot
+    log "Setting up chroot environment..."
+    mount --bind /dev "$mount_base/dev" || error "Failed to bind /dev"
+    mount --bind /proc "$mount_base/proc" || error "Failed to bind /proc"
+    mount --bind /sys "$mount_base/sys" || error "Failed to bind /sys"
+    mount --bind /run "$mount_base/run" || error "Failed to bind /run"
+    
+    # Copy DNS resolution
+    cp /etc/resolv.conf "$mount_base/etc/resolv.conf" 2>/dev/null || warning "Could not copy DNS settings"
+    
+    log "Updating initramfs to include LVM support..."
+    chroot "$mount_base" /bin/bash -c "
+        # Ensure LVM is in initramfs
+        echo 'GRUB_ENABLE_CRYPTODISK=y' >> /etc/default/grub 2>/dev/null || true
+        
+        # Update initramfs with LVM support
+        update-initramfs -u -k all
+        
+        echo 'Initramfs updated successfully'
+    " || warning "Initramfs update had issues"
+    
+    log "Reinstalling GRUB bootloader..."
+    chroot "$mount_base" /bin/bash -c "
+        # Install GRUB to the external drive
+        grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=debian --recheck '$EXTERNAL_DRIVE'
+        
+        echo 'GRUB installed successfully'
+    " || error "GRUB installation failed"
+    
+    log "Updating GRUB configuration..."
+    chroot "$mount_base" /bin/bash -c "
+        # Update GRUB configuration
+        update-grub
+        
+        echo 'GRUB configuration updated successfully'
+    " || error "GRUB configuration update failed"
+    
+    success "GRUB repair completed"
+}
+
+check_grub_files() {
+    local mount_base="$1"
+    log "Checking GRUB installation..."
+    
+    # Check EFI bootloader
+    if [ -f "$mount_base/boot/efi/EFI/debian/grubx64.efi" ]; then
+        success "GRUB EFI bootloader found"
+    else
+        warning "GRUB EFI bootloader missing"
+    fi
+    
+    # Check GRUB configuration
+    if [ -f "$mount_base/boot/grub/grub.cfg" ]; then
+        success "GRUB configuration found"
+        
+        # Check if configuration mentions LVM
+        if grep -q "$VG_NAME" "$mount_base/boot/grub/grub.cfg"; then
+            success "GRUB configuration includes LVM volumes"
+        else
+            warning "GRUB configuration may not include LVM setup"
+        fi
+    else
+        error "GRUB configuration missing"
+    fi
+}
+
+cleanup_mounts() {
+    local mount_base="$1"
+    log "Cleaning up mount points..."
+    
+    # Unmount in reverse order
+    umount "$mount_base/run" 2>/dev/null || true
+    umount "$mount_base/sys" 2>/dev/null || true
+    umount "$mount_base/proc" 2>/dev/null || true
+    umount "$mount_base/dev" 2>/dev/null || true
+    umount "$mount_base/home" 2>/dev/null || true
+    umount "$mount_base/boot/efi" 2>/dev/null || true
+    umount "$mount_base/boot" 2>/dev/null || true
+    umount "$mount_base" 2>/dev/null || true
+    
+    # Remove mount directory
+    rmdir "$mount_base" 2>/dev/null || true
+    
+    success "Mount points cleaned up"
+}
+
+show_next_steps() {
+    echo
+    echo -e "${GREEN}=== GRUB Repair Completed ===${NC}"
+    echo
+    echo -e "${BLUE}Next steps:${NC}"
+    echo "1. Reboot your system"
+    echo "2. Enter BIOS/UEFI settings"
+    echo "3. Ensure boot order prioritizes the external M.2 SSD"
+    echo "4. Look for 'debian' entry in the boot menu"
+    echo "5. Boot from the external drive"
+    echo
+    echo -e "${YELLOW}If boot still fails:${NC}"
+    echo "• Check BIOS/UEFI settings for Secure Boot (disable if necessary)"
+    echo "• Verify UEFI mode is enabled (not Legacy/CSM)"
+    echo "• Try different USB ports if using external enclosure"
+    echo "• Run this script again from live USB if needed"
+    echo
+    echo -e "${GREEN}The system should now boot properly from the external M.2!${NC}"
+}
+
+main() {
+    echo -e "${GREEN}=== GRUB Boot Repair for LVM Migration ===${NC}"
+    echo "This script repairs GRUB bootloader issues after LVM migration"
+    echo
+    
+    check_prerequisites
+    detect_external_drive
+    
+    echo
+    echo -e "${YELLOW}This will repair GRUB on the external M.2 drive${NC}"
+    echo "Drive: $EXTERNAL_DRIVE"
+    echo "Volume Group: $VG_NAME"
+    echo
+    confirm_action "Proceed with GRUB repair?"
+    
+    local mount_base=$(mount_external_system)
+    
+    # Set trap to ensure cleanup
+    trap "cleanup_mounts '$mount_base'" EXIT
+    
+    repair_grub "$mount_base"
+    check_grub_files "$mount_base"
+    cleanup_mounts "$mount_base"
+    
+    # Clear trap since we cleaned up successfully
+    trap - EXIT
+    
+    show_next_steps
+}
+
+main "$@"
\ No newline at end of file