はじめに
Ubuntu ServerのLTS版となるUbuntu Server 26.04をAuto Installでインストールしようとしたところ、Auto Installの設定ファイルを用意していたにも関わらず、言語設定画面が表示されてしまいました。
原因を突き止めるまでかなり時間がかかってしまったため、なぜUbuntu Server 26.04のAuto Installが失敗したのかを紹介したいと思います。
以前のネットワーク環境
私の自宅ネットワーク環境では、サーバや検証用仮想マシン等を動かすことも多いことから、ローカルネットワーク上に内部用DNSサーバを準備し、.localというドメイン名を設定して運用しておりました。
サーバ等にはホスト名でアクセスできるようDNSに登録しており、autoinstall.example.localのような名前でアクセスできるようにしております。
なお、今回の問題を機に、現在は別のドメイン名に変更を行っております。
発生した問題
しばらくAuto Installを行っていませんでしたが、Ubuntu Server 26.04を導入する際にAuto Installで行ってみたところ、Auto Install用のファイルやISOファイルの取得はTFTPサーバやWebサーバから取得できているようですが、以下のように言語設定画面が表示され、先に進みませんでした。
但し、同じAuto Installの設定でバージョン差分の部分のみ変更したファイルでUbuntu Server 24.04.3をインストールした場合は、言語設定の画面は表示されず、問題なくインストール完了まで進んでいたことからUbuntu Server 24.04.3以降のバージョン特有の問題だと判断して、調査を進めました。
「.local」ドメインについて
「.local」は、以前はMicrosoftの公式ドキュメントでもローカルネットワーク上に使うドメインとしてよく紹介されていたドメインとなりますが、RFC6762でmDNS(マルチキャストDNS)用として予約されており、現在では.localドメインをローカルドメインとして使用することは推奨されておりません。
mDNSはMacOSのBonjourでも使用しており、MacOSではデフォルトで有効となっていることから、Bonjourを使われている方には一般的かと思います。
ネットワーク経由のAuto Installの動き
ネットワーク経由でAuto Installを行った場合の動きとしては以下のような流れとなり、OSイメージとなるISOファイルとcloud-initで使用するuser-dataをそれぞれのステップでダウンロードして、設定内容に従ってインストールが行われる動作となります。
Ubuntu Server 24.04で成功したのにUbuntu Server 26.04で失敗した原因
結論から言うと、Ubuntu Server 24.04とUbuntu Server 26.04(以降24.04、26.04)では、systemd-networkdのUseDomainsのデフォルト値が異なることが原因でした。
26.04ではDHCPで配布されたドメイン名が検索ドメインとして使われないため、.localの名前を解決できません。その結果、cloud-initがuser-dataをダウンロードできず、自動インストールが進まないまま言語選択画面で止まっていました。
以下より詳しく説明していきます。
Auto InstallによるISOダウンロード処理について
Auto Installの前半処理となるISOファイルダウンロードはinitramfsの処理で行っており、この処理は24.04、26.04共に変わりません。
initramfsの処理では「.local」を予約ドメインとして扱っていないことから、通常のドメインと同じくDNSの処理が行われるため、24.04でも26.04でも問題は発生しませんでした。
systemd-resolvedについて
ISOファイルダウンロード後、Ubuntuのインストールが開始されると、cloud-initがuser-dataをダウンロードします。
このときの名前解決は以下のフローチャートのような流れとなり、systemd-resolvedというサービスが担当します。
systemd-resolved自体はデフォルトではmDNSの機能が無効化されているため、mDNSの処理は行われませんが、「.local」はmDNS用として予約されていることから、autoinstall.example.local等の「.local」が含まれる問い合わせはDNSサーバに送信されない動きとなります。
但し、検索ドメイン設定で「example.local」のように「.local」を含む設定がされていた場合は、検索ドメインに一致するドメインへの問い合わせのみ、通常のドメインと同じDNS処理が行われます。
検索ドメイン設定が行われている場合の処理は24.04、26.04共に同じになります。
DHCPによるドメイン名の配布が行われている環境での違い
ようやく今回の根本原因の説明となります。
私の環境ではヤマハルータを使用しており、ローカルネットワーク上のドメイン名とDNSサーバアドレスを配布するため、以下のような設定を行っておりました。
dhcp scope option 1 dns=192.168.100.253,192.168.100.254 domain=example.local
UbuntuのDHCPの処理はsystemd-networkdで行っており、UseDomainsという設定で、DHCPで配布されたドメイン名を検索ドメインとして使用するかどうかを制御しております。
このsystemd-networkdのUseDomainsのデフォルト値が24.04ではyes、26.04ではnoと異なっていたことで、26.04では検索ドメインが渡されず、「.local」を含むDNS処理に失敗したことが根本原因となります。
26.04ではsystemd-resolvedに検索ドメインが引き渡されなかったため、「example.local」はmDNSの予約ドメインとして処理され、DNS問い合わせがスキップされたことでuser-dataが取得できずに言語設定画面から進まなかったのが全容となります。
おわりに
どのドキュメントだったかまでは覚えていませんが、色々な書籍やドキュメントに.localと記載されているのを見た覚えがあるため、今まで疑問にも思わず.localを使用していました。
また、今まで.localでも表面上問題ないように見えて運用出来ていたことで発覚が遅くなったのも問題が長引いた原因と感じました。
今回の件はDHCPオプションの配布も絡むため、私のような事象に陥るのは限定的かと思いますが、今回の件でAuto Install時のネットワークフローが大分理解できました。
何事も思い込みに囚われるのはいけないなと思いました。


