ドキュメント · 1.0

構成：問題と詳細

構成 メニューの最後の 3 つのタブを説明します。問題（keel 自身が検出した壊れた設定と修正方法）、パーティション（ホスト上のリソース分割。画面の表示どおりに説明します）、詳細（ハイパーバイザーの起動設定 hyp.conf）です。前のタブについてはストレージ、ネットワーク、デバイスパススルーとハードウェアを参照してください。

注意：変更するにはホストの書き込み権限があるアカウントが必要です。読み取り専用アカウントでは表示だけでき、修正…、無視、保存ボタンは表示されません。

1. 問題

構成 → 問題 は、ホスト上の壊れた設定や古くなった設定を一覧表にしたものです。keel が数秒おきに自動でチェックするので、自分で探す必要はありません。同じ内容は 概要 や、関連する仮想マシン・ネットワーク・ストレージのページにも表示され、それぞれに 修正… が付きます。クリックするとここの修正ダイアログが直接開きます。

1.1 表の内容

上の行は件数です。エラー N 件、警告 N 件、問題がなければ 正常に稼働中 と表示され、表が空のときは すべてのチェックに合格しました。修正するものはありません。 と表示されます。右側の 再チェック で、すぐにもう一度チェックします。

keel が検出できる問題には次のようなものがあります。

• ネットワーク：スイッチのアップリンクが別のネットワークにつながっている、NIC が存在しなくなったネットワークやスイッチにつながっている、ゲストが使っているネットワークのどのポートにもリンクがない、使用中のポートにリンクがない、NIC の変更が再起動待ちになっている。
• ストレージ：同じ名前のプールが 2 つある、keel に記録されているプールがインポートされていない、2 つのプールのマウントポイントが同じ。
• 仮想マシン：光学ドライブが指す ISO ファイルが見つからない、指定した NUMA ノードや CPU がホストにない、自動起動に失敗した、設定ファイルを読めない、USB 転送に必要な bhyve のバージョンが足りない。
• デバイスパススルー：パススルー項目に対応するデバイスがマシンにない、仮想マシンがパススルー一覧にない名前を参照している、コールド移行してきた仮想マシンのパススルーデバイスを選び直す必要がある。
• サービスと証明書：すでに存在しないインスタンスに残った仮想マシン（NAS、keelAuth）、インポートした証明書の期限が近い／切れている、証明書にホストの現在の名前が含まれていない、証明書がディスク上のものと一致しない。

1.2 修正

1. 行の 修正… をクリックします。問題を修正 ダイアログが開き、上部にその問題が表示されます。
2. 修正方法が複数ある場合は 修正方法 で 1 つ選びます。データが消える方法には赤字で データ削除 と表示されます。対象を選ぶ必要がある場合（たとえばどのネットワークに切り替えるか）は、ドロップダウンや入力欄が追加で表示されます。
3. 選択後、下の 変更内容： に、実行する各ステップと対応する API 呼び出しが表示されます。リスクのあるステップには説明が付きます。この段階ではまだ何も変更されていません。
4. データが消える方法では、確認のため … と入力 の欄に、表示された文字（ディスク名や仮想マシン名）をそのまま入力しないと先へ進めません。
5. 実行（データが消える方法では 実行（元に戻せません））をクリックします。完了すると 完了：N 件変更しました と表示されます。途中のステップで失敗した場合は、どのステップで失敗したかが一覧に表示されます。

各修正による変更は監査ログに記録されます。keel に自動修正の方法がない問題では、ダイアログに keel には自動の修正方法がありません。ヒントを参照してください。 と表示されます。

まとめて修正：同じ種類の問題が複数あるとき（たとえば複数の仮想マシンで光学ドライブのファイルが見つからない）は、表の左側でチェックを入れ、上の チェックしたものを修正（N）… をクリックします。まとめてチェックできるのは、同じ種類でまとめて修正できる問題だけです。

無視：当面対処しない問題は 無視 をクリックします。表には残りますが（グレー表示）、件数には数えられず、概要にも表示されません。無視したものも表示（N） にチェックを入れると表示され、再び数える で元に戻せます。

注意：このページを開いたときに一部のチェックでデータを読めなかった場合、一部の情報を読めなかったため、一覧が不完全な可能性があります と表示されます。

2. パーティション

構成 → パーティション には、このホストで並行して動いている「パーティション」が一覧表示されます。keelOS（root）（FreeBSD ホスト、つまり keel 本体）、keelRM（管理 VM。keelRM 管理ポートを参照）、Linux パーティション です。各行に CPU、メモリ、ネットワークポート、状態（実行中、起動中、オフ、起動しませんでした）が表示されます。root と keelRM の行は読み取り専用です。

これはホスト単位のリソース分割であり、仮想マシンを作成するときに通る手順ではありません。普段の仮想マシン作成やテンプレート選択でここに来る必要はありません。特殊な環境が必要な古い OS のテンプレートは keel が自動で割り振るので、仮想化エンジンを選んだり、先にここで何か設定したりする必要もありません。

画面では Linux パーティション を、root の隣でもう 1 つホストを動かすもの、と説明しています。専用のコア、メモリ、ネットワークポートを持ち、FreeBSD 側では動かせない古いシステムを QEMU で動かします。このページでできることは次のとおりです。

• 編集：ダイアログで Linux パーティションを有効にする にチェックを入れ、コア数（コア単位で割り当て、コア上の SMT スレッドも一緒に渡されます。最初のコアは root に残り、keelRM のコアも確保されます）、メモリ（GiB。画面に表示された上限まで）、ネットワークポート を設定します。パーティションのポートは専用です（VT-d パススルー）。root からは見えず、ホストのネットワークと共有されません。管理ポート、keelRM のポート、ネットワーク・スイッチ・パススルーで使用中のポートはグレー表示で選べません。割り当てられるポートがない場合は、その旨が表示されます。ダイアログには、再起動でシャットダウンされる実行中の仮想マシンが一覧表示され、今すぐホストを再起動（ファームウェア経由） にチェックを入れることもできます。
• 変更は 1 回の再起動が必要：設定は hyp.conf に書き込まれ、ホストがファームウェア経由で再起動したときだけ読み込まれます。そのため保存後に Linux パーティションの設定が再起動待ちです と表示されます。今すぐ再起動 をクリックするか、次の再起動を待ちます（自動的にファームウェア経由になります）。再起動時には、実行中の仮想マシンが先にシャットダウンされ、再起動後に起動されます。パーティションを無効にする場合も同様で、コア、メモリ、ポートは次の再起動後に root に戻ります。
• 有効にすると、パーティションの行の下にアドレスと、内部のエージェントが報告するバージョン、稼働時間、仮想マシン数が表示されます。エージェントが応答しないときは エージェントがまだ応答しません と表示されます。
• ログ サブページ：hyp が記録したパーティションの行とエージェント自身のログです。切り分けに使います。更新 で再読み込みします。

3. 詳細：hyp.conf

構成 → 詳細 は、ハイパーバイザーの設定ページです（hyp.conf。各ブートパーティションにあります）。ほとんどの方は触る必要がありません。既定値は多くのマシンに適しており、切り分けや特別な要件があるとき（たとえばホストの画面が真っ黒、起動メッセージをシリアルで見たい、ゲスト用に確保するメモリを変えたい）だけ変更します。

すべての変更は、次回のホスト再起動で初めて有効になります。しかもその再起動は完全な再起動です（実行中の仮想マシンは先にシャットダウンされ、再起動後に自動で起動します）。保存時には、すべてのブートパーティションがまとめて変更されます。ホスト起動後に設定を変更すると、ページ上部に ホスト起動後に設定が変更されました：次回の再起動（完全）で有効になります。 と表示され、横に 再起動 ボタンが付きます。

各項目はドロップダウンか入力欄です。既定 を選ぶか空欄にすると、ハイパーバイザーが自分の既定値を使います。下の小さい文字に役割の説明があります。4 つのグループに分かれています。

変更したら 保存 をクリックします。確認ダイアログに変更内容が表示されます。元に戻す は、まだ保存していない編集を破棄します。入力した値をハイパーバイザーが解釈できない（形式が違う）場合は ハイパーバイザーが読めない値です と表示され、保存ボタンは押せません。

ページの下半分の keel が設定 には、ブートスロット、試用スロット、ハイパーバイザー状態、管理 VM などが表示されます。読み取り専用で、keel がアップグレードや keelRM の中で管理するため、ここでは変更しません。認識できない行は その他の行 に表示され、ファイルの内容 を展開するとファイル全体を確認できます。

注意：root のメモリ や ゲストメモリプール を不適切な値（たとえば root を小さくしすぎる）にすると、ホストや仮想マシンが起動しなくなることがあります。迷ったら 既定 のままにしてください。