Debian 13 講座 / 起動障害とinitramfs・レスキューを理解する
最後に正常に動作した段階(ファームウェア、ブートローダー、カーネル、初期ファイルシステム、systemd)を特定することで、Debian 13の起動失敗を診断します。SSH接続が失敗しただけで起動失敗と結論付けてはいけません。コンソール、実際のルートおよびbootの配置、インストール済みカーネルを確認する必要があります。この講義では、通常のシステムで別のinitramfsを作成および検査する方法と、実際の障害時にレスキュー手順を適用する際の変更範囲と対象を説明します。
起動段階の特定とSSH障害の区別
UEFI(Unified Extensible Firmware Interface)は、ハードウェアを初期化し、ブートプログラムを見つけるファームウェアです。GNU GRand Unified Bootloader(GRUB)は、カーネルと初期RAMファイルシステム(initramfs)を読み込んで実行するブートローダーです。initramfsの初期ユーザースペースは、ルートデバイスを見つけて実際のルートに切り替えるのを助けます。その後、systemdはサービスとログイン環境を構成します。
| コンソールに表示される状態 | 初期調査 | すぐに行わないタスク |
|---|---|---|
| ブートデバイスが見つからない | ディスク接続、ファームウェアのブート順序、EFIシステムパーティション | ルートファイルシステムを再初期化しないでください。 |
| GRUBメニューまたはコマンドライン | ブートファイルのパス、設定およびデバイスの識別 | UEFIに対してBIOSコマンドを無条件に適用しないでください。 |
| カーネルメッセージまたはinitramfsシェル | 選択されたカーネル、ルートUUID、ストレージモジュールおよび暗号化/LVM | 実行中の環境のカーネルをリカバリ対象バージョンとして想定しないでください。 |
| 緊急モードまたはサービス障害 | fstab、マウント、影響を受けるユニットおよびジャーナル | GRUBの再インストールを万能な修復として扱わないでください。 |
| ログイン画面はありますが、SSHは失敗します。 | アドレス、パス、ファイアウォール、sshd、認証 | SSHの失敗からカーネルのブート失敗を推測しないでください。 |
エラー画面のテキスト、選択されたカーネル、および変更直前の操作と時間を記録してください。VirtualBoxのようなVMでは、VMのコンソールに直接アクセスできるかどうかを確認してください。このテストVMでは、コンソールのログインプロンプトと通常のSSHが確認されたため、システムが起動不能になる状態での操作は行われませんでした。
実行中のカーネルと実際のbootマウントを確認する
正常に起動できるうちに、次の情報を別の記録として残してください。uname -r は現在実行中のカーネルであり、インストールされているすべてのカーネルのリストではありません。dpkg-query の出力で ii はインストール済みの状態を示し、un のようなエントリはインストール済みカーネルとしてカウントされません。
uname -r
dpkg-query -W -f='${binary:Package} ${db:Status-Abbrev} ${Version}\n' 'linux-image*'
ls -l /boot/vmlinuz-* /boot/initrd.img-*
ls /usr/lib/modules
test -d /sys/firmware/efi && echo 'Booted with UEFI'
findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --mountpoint /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /boot /boot/efi /var/tmp
readlink -f /vmlinuz /initrd.img
BIOS 起動の場合、EFI ディレクトリのテストは非ゼロを返すことがあり、専用の EFI マウントが存在しないかもしれません。これらはレイアウトの観察として解釈し、起動失敗の証拠としては扱わないでください。UUID(Universally Unique Identifier)は、ファイルシステムを識別する値です。デバイス名の変化に左右されにくい値ですが、再作成や複製時には実際の値と重複の有無を確認します。ラボから名前をコピーするのではなく、実際のデバイスと照合して確認してください。
テスト用VMはUEFI、GRUB 2.12、カーネル6.12.107+deb13-amd64、initramfs-tools 0.148.4でした。/bootはルートのext4に含まれており、別パーティションではなく、/boot/efiのみが別のvfatパーティションでした。/bootが同じであっても、サーバーによっては別パーティション、LVM、または暗号化がある場合があるため、デバイス名をそのまま使用することはありません。
GRUBメニューでは、次のように通常のシステム上で構文チェックや項目の確認を行うことができます。構文の成功は、ファームウェアの起動、ディスクの読み取り、またはカーネルの実行を保証するものではありません。
sudo grub-script-check /boot/grub/grub.cfg
sudo grep -E "^(menuentry|submenu)|^[[:space:]]+menuentry " /boot/grub/grub.cfg
grub-script-checkマニュアル は構成の構文チェックについて説明しています。grub.cfgは生成された出力です。恒久的な変更を行う場合は、その出力を直接編集するのではなく、元の構成と生成プロセスを確認してください。
コンソールアクセスを準備し、古いカーネルを確認する
新しいカーネルで問題が発生し、以前のカーネルが実際にインストールされている場合は、GRUBコンソールでAdvanced options for Debian GNU/Linux(Debian GNU/Linuxの詳細オプション)を開くことにより、以前のバージョンでの起動方法を確認できます。VMのファームウェアや設定によって、メニュー項目キーや表示時間は異なる場合があるため、通常状態でのアクセス方法を確認してください。
検証用VMには実際にインストールされているカーネルが1つしかなく、GRUBの標準項目と回復項目の両方はバージョン6.12.107で同じでした。回復モードの項目は以前のカーネルではありません。別のバージョンがない場合、以前のカーネルを選択することで問題が解決することを示すものではありません。
前のカーネルで起動した場合は、uname -r、サービス、ネットワーク、およびデータを確認し、問題のあるカーネルとログを保持してください。正常に動作するカーネルを先に削除しないでください。どのカーネルにも起動できない場合は、コンソールアクセスとインストールISOからのレスキューを準備し、バックアップを実施してください。ここでは、通常のブートファイルを置き換えずに、以下の別のイメージ作業を進めます。
起動ファイルを保持し、別のinitramfsを作成する
mkinitramfs は、指定されたカーネル用の初期ファイルシステムイメージを作成します。この演習では、結果を /boot を上書きせずに root のみがアクセスできるバックアップパスに保存します。デフォルトの一時作業領域として /var/tmp を使用できるため、利用可能なスペースと実行権限を確認してください。実際のツールの一時パスに関する条件は mkinitramfs のドキュメント で確認できます。
以下の完全なブロックは、sudo 権限を持つ通常の Debian システムのターミナルから実行されます。同名のパスが存在する場合、実行は停止し、既存のレコードは上書きされません。
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-debian13-32
if test -e "$dest"; then echo "Destination already exists." >&2; exit 1; fi
install -d -m 700 "$dest"
kernel=$(uname -r)
test -f "/boot/vmlinuz-$kernel"
test -f "/boot/initrd.img-$kernel"
test -d "/usr/lib/modules/$kernel"
sha256sum "/boot/vmlinuz-$kernel" "/boot/initrd.img-$kernel" /boot/grub/grub.cfg > "$dest/boot-before.sha256"
cp -a /etc/fstab /etc/default/grub /etc/initramfs-tools/initramfs.conf "$dest/"
mkinitramfs -o "$dest/initrd-lab.img" "$kernel"
lsinitramfs "$dest/initrd-lab.img" > "$dest/initrd-lab-files.txt"
grep -Fx init "$dest/initrd-lab-files.txt"
grep -F "usr/lib/modules/$kernel/" "$dest/initrd-lab-files.txt" > "$dest/kernel-module-files.txt"
test -s "$dest/kernel-module-files.txt"
stat -c 'image bytes=%s' "$dest/initrd-lab.img"
sha256sum -c "$dest/boot-before.sha256"
ROOT
実行結果により、initエントリおよび対応するカーネルモジュールのパスが確認され、分離されたイメージサイズは38,975,420バイトでした。サイズは作成条件やパッケージにより異なる場合があります。元のvmlinuz、initrd.img、およびgrub.cfgのハッシュはすべて問題ありませんでした。分離イメージを作成してリストを検証することは、そのイメージで実際に起動することとは異なります。
リスティングツールの役割と対応範囲は、lsinitramfsドキュメント で詳細に説明されています。目的のストレージデバイスドライバ、ルートUUID、LVM/暗号化設定が正しいことを確認するためには、実際のシステム構成での追加検証が必要です。単に多くのファイルが存在するだけでは、イメージが復旧可能かどうかは判断できません。
実際の障害時にリカバリ環境とターゲットのルートを確認する
このセクションは、実際のブート障害が確認されたときに適用条件を判断するリカバリ手順です。上記のVMでは、通常のブートファイルは変更されておらず、リカバリで実際のファイル置換も行われていません。Debianインストールマニュアルのリカバリセクション に記載されているように、インストールメディアのrescue項目を選択するか、rescue/enable=true を使用してリカバリするルートを選択してください。
- サーバーコンソールおよびバックアップ/リストア手段を確保し、既存ディスクおよびEFIブート方式に合ったインストールメディアで起動してください。
- レスキューモードを選択し、言語とハードウェアのチェックを行い、実際にインストールされているルートファイルシステムを選択します。新しいインストールのパーティション初期化段階に進まないでください。
- 選択したルート内のシェルか、インストーラー自体のシェルかを確認します。選択したルート内のシェルである場合、その環境で既に作業しているので、再び /target に chroot しないでください。
- インストーラーのシェル内では、選択したルートが /target にマウントされていることがあります。そのディレクトリ内の OS と fstab を実際のデバイスと比較し、別個の /boot または EFI がある場合は正しく接続し、その後ターゲット環境で作業してください。
以下のコマンドは、インストーラー環境のルートシェルでターゲットを確認するために実行されます。ルートシェルで行うため、sudoプレフィックスは使用しないでください。これは /target が実際に選択されたルートである場合にのみ意味があります。
lsblk -f
findmnt -R /target
cat /target/etc/os-release
cat /target/etc/fstab
ls /target/usr/lib/modules
ls -l /target/boot
暗号化、RAID、およびLVMは、まず対応するストレージレイヤーを使用できる必要があります。この単純なext4およびUEFIの例を、これらのストレージレイアウトにそのまま適用しないでください。ルート自体が破損により読み取れない場合、まずファイルシステムチェックおよびバックアップ復元の条件を確認し、マウントされたルートに対してe2fsckを実行しないでください。
インストーラーのシェルで手動のchrootが必要な場合、/targetは正しいルートであり、ターゲットシェルを実行できる必要があります。別の/bootがある場合は、まずそれをターゲットの/target/bootにマウントし、EFIシステムパーティションは実際のUUIDを使用して/target/boot/efiにマウントする必要があります。すでに接続されている項目を重複させず、findmntの結果で確認してください。
次のブロックは、正しいブートパーティションを特定してマウントした後に、ランタイムファイルシステムをバインドします。マウントコマンドが失敗した場合は停止し、続行する前にfindmnt -R /targetを確認してください。再帰的なスレーブ伝播により、ターゲット下でのアンマウント操作がリカバリ環境に伝播するのを防ぎます。chrootは見かけ上のファイルシステムのルートを変更します。インストールされたカーネルを起動したり、セキュリティ境界を確立したりするものではありません。
以下は、ランタイムマウントを接続し、ターゲット環境に入る例です。このコマンドはディスクの識別を置き換えるものではありません。/target/dev のようなマウントがすでに準備されている場合は、まずインストーラーが提供するターゲットシェルを使用することをお勧めします。
for p in dev proc sys run; do
mount --rbind "/$p" "/target/$p"
mount --make-rslave "/target/$p"
done
chroot /target /bin/bash
修復前にインストール済みのターゲットカーネルを指定する
chroot 内にいても、uname -r はリカバリメディアから実行されているカーネルを表示します。インストール済みのターゲットカーネルリスト、モジュールディレクトリ、および vmlinuz ファイルを比較してバージョンを指定してください。以下はターゲットルートのルートシェルから実行される確認例です。
cat /etc/os-release
ls /usr/lib/modules
dpkg-query -W -f='${binary:Package} ${db:Status-Abbrev} ${Version}\n' 'linux-image*'
findmnt --target /boot
findmnt --target /boot/efi
df -hT /boot /boot/efi /var/tmp
read -r -p "Installed kernel version to repair: " target_kernel
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"
インストールされている生成ツールも確認してください。このようなVM環境でinitramfs-toolsを使用する場合の次の手順は、dracut環境にはそのまま適用されません。復旧前に、ブートファイル、設定、EFI内容など必要なターゲットをアクセス制限された別の場所に保存してください。バックアップに新しい名前を付け、既存の良好なコピーを上書きしないでください。
上記の原因を修正し、ストレージ容量、ルート/ブートのマウント、ターゲットバージョン、バックアップを確認した後でのみ、実際のinitramfsを更新してください。以下のルートシェルブロックでは、ターゲットカーネル用の既存のイメージがある場合は -u を、ない場合は -c を選択します。この操作は実際に /boot を変更します。
set -e
test -n "$target_kernel"
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"
repair_record=$(mktemp -d /var/backups/lf-boot-repair.XXXXXX)
for path in "/boot/vmlinuz-$target_kernel" "/boot/initrd.img-$target_kernel" /boot/grub/grub.cfg /etc/fstab /etc/default/grub; do
if test -f "$path"; then cp -a -- "$path" "$repair_record/"; fi
done
printf 'backup: %s\n' "$repair_record"
if test -f "/boot/initrd.img-$target_kernel"; then
update-initramfs -u -k "$target_kernel"
else
update-initramfs -c -k "$target_kernel"
fi
listing=$(mktemp /var/tmp/lf-repair-initrd.XXXXXX)
lsinitramfs "/boot/initrd.img-$target_kernel" > "$listing"
grep -Fx init "$listing"
rm -- "$listing"
update-grub
grub-script-check /boot/grub/grub.cfg
update-initramfs マニュアル は、既存のイメージを更新することと新しいイメージを作成することを区別しています。update-grub マニュアル は、GRUB 設定を生成することを説明しており、ブートローダーの再インストールやファームウェアのブートエントリを修復する操作とは異なります。
問題が EFI ファイルやファームウェアの登録自体にある場合、対象アーキテクチャ、UEFI/BIOS、セキュアブート、EFI マウント、およびインストール済みの grub/shim パッケージを確認するための別の回復プロセスが必要です。GRUB がカーネルを読める場合に自動的にブートローダーを再インストールしないでください。また、BIOS の例としてのディスクコマンドを UEFI にコピーしないでください。
復旧を確認し、別途作成した実習イメージを保持する
実際のリカバリーでは、chrootを終了し、接続した従属マウントを逆順にアンマウントし、インストールメディアを取り外してから、ディスクから起動します。アンマウントする際には、他の稼働中のマウントを含む広範なコマンドを使用せず、findmnt -R /target で実際の階層を確認してください。起動に失敗した場合は、コンソールメッセージ、選択したバージョン、変更履歴を保存し、用意されたバックアップおよびリストア手順を使用して対応します。
システムが起動した場合は、uname -r、rootおよびbootマウント、systemctl --failed と必要なサービス、新しいSSH接続、実際の応答、データを確認します。ログイン画面が表示されたという事実と、元々提供されていた機能が復元されたという事実を区別してください。
uname -r
findmnt --target /
findmnt --target /boot
findmnt --mountpoint /boot/efi
sudo systemctl --failed --no-pager
systemctl is-active ssh
ip -brief address
ip route
通常の状態で行われた個別のイメージ演習では、元の /boot は変更されなかったため、ブートファイルを復元する必要はありません。個別のイメージやリスト、ハッシュ、構成のコピーは /var/backups/lf-debian13-32 に保存されています。不必要な演習用イメージのみを削除する場合は、元の /boot/initrd.img とそのパスを混同しないよう注意し、まずリカバリ記録を保持するかどうかを決めてください。




