ドキュメント · 1.0

システム：keelRM 管理ポート

keelRM は、サーバーの BMC の Web 管理ポートに似たものですが、keelOS 自身が提供します。ホスト上で小さな管理仮想マシンが動き、LAN ポートを 1 つ占有して、専用のアドレスで Web ページを提供します。ホストの keelOS が再読み込み中でも、固まっても、ダウンしても、このページは開けます。データセンターまで行かなくても、画面やログを見たり、再起動したりできます。この章では システム → リモート管理 タブについて、どんなときに使えるか、有効化と無効化の方法、できることを説明します。

1. できること

keelRM のページ（HTTPS）には次のものがあります。

• ホストの画面とシリアルコンソール。
• ハイパーバイザー（hyp）のログ。
• root の再読み込み（reload）、リセット、シャットダウン、そして「次回はスロット A / B から一度起動」。

root と管理者パスワードでログインします（管理者パスワードはアカウント、トークン、権限を参照）。同じアドレスからのログイン失敗が続くと、しばらく待たされます。

ホスト自身の LAN ポートとアドレスにはまったく手を加えません。keelRM でホストがネットワークから切れることはありません。keelRM が使うのは追加の、ケーブルがつながった LAN ポートだからです。

2. 使える条件

keelRM には次のものが必要です。

• 専用の LAN ポート：ホストの管理ポートとは別に、ケーブルがつながっていて、仮想マシンのネットワーク（keel のスイッチ、ネットワーク、ブリッジ）が載っていない LAN ポートがもう 1 つ必要です。ケーブルがつながった LAN ポートが 1 つしかないホストでは、keelRM を有効にできません。その場合はホストも仮想マシンも管理仮想マシン経由でネットワークに出ることになり、keelOS が許可していないためです。2 つ目の LAN ポートにケーブルをつないでから有効にしてください。
• Intel CPU で EPT 付きの VT-x があり、BIOS で VT-d（IOMMU）が有効であること。AMD の CPU は 1.0 ではまだ対応していません。
• ホストが keelOS のハイパーバイザー上で動いていること（ネイティブモードではないこと。システム：アップグレードと再起動を参照）。
• CPU にハイパースレッディングがあり、論理 CPU が 4 つ以上あること：keelRM はそのうち 1 スレッド（同じコアのもう一方のスレッドはホストに残ります）と 64 MiB のメモリを使います。ハイパースレッディングのない CPU（たとえば 4 コア 4 スレッド）には、コア 1 つ丸ごと取られてしまうため、keelRM は割り当てません。
• 実行中の keelOS に、管理仮想マシンのイメージが含まれていること。

条件を満たさない場合、keelRM を有効にする ダイアログに、どの条件が満たされていないかが 1 件ずつ表示されます。

注意：1.0 より前のいくつかの旧モード（管理仮想マシンとホストが 1 つのポートを共有するもの）は廃止されました。旧モードのホストでは、ページに黄色の keelRM の旧モードはサポートされなくなりました というカードが表示され、ボタンは keelRM を無効にする です。ファームウェア経由で 1 回再起動し、LAN ポートをホストに返します。ホストにケーブルのつながった 2 つ目の LAN ポートがあるなら、そのポートで改めて有効にしてください。

3. 有効にする

1. システム → リモート管理 を開き、keelRM を有効にする をクリックします。keel が詳細をすべて計算し、ダイアログに 1 件ずつ表示します。 - keelRM の専用ポート：候補が 1 つならそのまま使われ、複数ある場合は 1 つ選びます。igb1 (00:19.0) のような名前で表示されます。keelRM に割り当てられないポート（ホストの管理ポート、仮想マシンのネットワークがあるもの、ケーブルのないもの）も、理由とともに表示されます。 - keelRM が 1 スレッドと 64 MiB のメモリを使うことの注意（黄色の文字）。 - keelRM のアドレス：DHCP（自動） または 固定アドレス（アドレス/プレフィックス、たとえば 192.168.1.250/24、ゲートウェイ（省略可） を入力）。keelRM は独立した機器で、専用のアドレスを持ちます。DHCP を使う場合は、ルーターでアドレスを予約しておくことをお勧めします。 - このポートに現在アドレスがある場合、それは LAN ポートごとなくなります（ダイアログに注意が表示されます）。 - ホストをファームウェア経由で 1 回再起動します（数分）。実行中の仮想マシンはシャットダウンされ、再起動後に起動します。対象の仮想マシンはダイアログに一覧表示されます。
2. 今すぐ再起動（チェックしなければ次の再起動で） にチェックを入れて、keelRM を有効にする をクリックします。チェックしない場合、ページに「次回の再起動で keelRM を有効にします」というカードが表示され、いつでも 今すぐ再起動 をクリックできます。
3. ホストが再起動すると、keel が管理仮想マシンがそのポートを使って動いているかを自動でチェックします。成功するとページにそのアドレスと ページ のリンクが表示されます。失敗した場合は keel が変更を元に戻し、理由がページ上のカード（keelRM を有効にできませんでした）に表示されます。ホストのネットワークには影響しません。

4. ページの内容

有効にすると、システム → リモート管理 には次の内容が表示されます。

keelRM は自身の自己署名証明書を使います（名前は <ホスト名>-keelrm とそのアドレス）。初めて開くときは、ブラウザで一度確認が必要です。

変更 をクリックして keelRM のアクセス を設定します。リモート管理のオン/オフと、許可するネットワーク（CIDR、1 行に 1 つ。空欄はどこからでも許可）です。管理ネットワークのみ（自動） にチェックを入れると、ホストの管理ネットワークだけが許可されます。

5. 無効にする

keelRM を無効にする をクリックします。ダイアログには、LAN ポートがホストに戻ること、管理仮想マシンに関する数行がブートパーティションの設定から削除されること、ファームウェア経由の再起動が 1 回必要なこと（数分。実行中の仮想マシンはシャットダウンされて再起動します）が表示されます。keelRM を無効にする をクリックして確定し、今すぐ再起動 にチェックを入れるとすぐに再起動します。

6. セーフモード

ホストの root が繰り返しエラーを起こして起動できない場合は、keelRM のページから次回をセーフモードで起動させることができます。仮想マシンは自動で起動せず、パススルーデバイスはホストに残るので、まずホストを復旧できます。このとき システム → リモート管理 ページの上部に 今回の起動はセーフモードです というカードが表示されます。直したら セーフモードを終了 をクリックします。自動起動の仮想マシンが起動します。パススルーデバイスがある仮想マシンは、次回の起動を待ちます。

7. ホスト再起動中の画面

アップグレードの切り替えやホストの再起動中は、Web 画面に「ホストを再起動中」の案内が重なって表示されます。keelRM を有効にしているホストでは、この案内に root の状態と起動の段階、シリアルコンソールの最後の数行（または画面）、keelRM を開くリンクもリアルタイムで表示され、ホストが戻るまで続きます。ホストがクラッシュしたり固まったりした場合は、すぐにその旨が表示され、対応を待つために画面に残ります。keelRM の証明書をまだ確認していない場合は、案内に確認用のリンクが表示されます。

8. 1.0 の制限

• 対応しているのは「専用ポート」モードだけです。LAN ポートが 1 つしかないホストでは使えません。
• Intel の CPU のみです。