ヒント: libvirt 向けにはモニタコンソールが提供されない件について

モニタコンソールにアクセスするには、仮想マシンを qemu-system-アーキテクチャ コマンドで直接起動し、グラフィカルな出力を組み込みの QEMU ウインドウ内に表示させる必要があります。

仮想マシンを libvirt (たとえば virt-manager) で起動している場合で、 VNC や Spice セッション経由で出力を表示させている場合は、モニタコンソールに直接アクセスすることはできません。ただし、 virsh で下記のように入力して実行することで、モニタコマンドを送信することができます:

# virsh qemu-monitor-command コマンド

モニタコンソールへのアクセス方法は、仮想マシンの出力に使用しているディスプレイデバイスの種類によって異なります。ディスプレイに関する詳細は、 36.3.2.2項 「ディスプレイのオプション」 をお読みください。たとえば -display gtk オプションを利用してモニタを表示させている場合、 Ctrl–Alt–2 を押すことでモニタコンソールを表示させることができます。同様に -nographic オプションを利用している場合は、 Ctrl–A C を押すことでモニタコンソールに切り替えることができます。

コンソールの使用方法についてヘルプを表示したい場合は、 help もしくは ? と入力して実行します。特定のコマンドに対するヘルプを表示したい場合は、 help コマンド のように入力して実行してください。

ゲストシステムに関する情報を取得したい場合は、 info を使用します。オプションを何も指定しないで実行すると、指定可能なオプションの一覧が表示されます。オプションでは、表示したい情報を指定します:

VNC のパスワードを変更するには、 change vnc password と入力して実行し、新しいパスワードを入力します:

(qemu) change vnc password
Password: ********
(qemu)

ゲストの動作中に新しいディスクを接続 (ホットプラグ) したい場合は、 drive_add と device_add の各コマンドを使用します。まずは新しいドライブを定義し、それをバス (この例では 0) に接続する流れになります:

(qemu) drive_add 0 if=none,file=/tmp/test.img,format=raw,id=disk1
OK

ブロックサブシステムへの問い合わせを行うことで、新しいデバイスが追加されていることを確認することができます:

(qemu) info block
[...]
disk1: removable=1 locked=0 tray-open=0 file=/tmp/test.img ro=0 drv=raw \
encrypted=0 bps=0 bps_rd=0 bps_wr=0 iops=0 iops_rd=0 iops_wr=0

新しいドライブを定義したら、あとはゲスト側からアクセスすることができるようにするため、接続を行います。通常のデバイスであれば virtio-blk-pci もしくは scsi-disk のいずれかをドライバとして使用します。指定可能な値の一覧を表示するには、下記のように入力して実行します:

(qemu) device_add ?
name "VGA", bus PCI
name "usb-storage", bus usb-bus
[...]
name "virtio-blk-pci", bus virtio-bus

後は下記のようにしてデバイスを追加するだけです:

(qemu) device_add virtio-blk-pci,drive=disk1,id=myvirtio1

下記のように入力して実行すると、接続されたことを確認することができます:

(qemu) info pci
[...]
Bus  0, device   4, function 0:
    SCSI controller: PCI device 1af4:1001
      IRQ 0.
      BAR0: I/O at 0xffffffffffffffff [0x003e].
      BAR1: 32 bit memory at 0xffffffffffffffff [0x00000ffe].
      id "myvirtio1"

ヒント

device_add で追加したデバイスは、 device_del で削除を行うことができます。詳しくは QEMU のモニタコマンドラインから help device_del と入力して実行することで表示される、ヘルプをお読みください。

リムーバブルデバイスのメディアを取り出すには、 eject デバイス名 コマンドを使用します。必要であれば -f オプションを追加して、強制的に取り出すこともできます。

リムーバブルメディア (たとえば CD-ROM) のメディアを交換したい場合は、 change デバイス名 コマンドを使用します。リムーバブルメディアの名前は、 info block コマンドで確認することができます:

(qemu) info block
ide1-cd0: type=cdrom removable=1 locked=0 file=/dev/sr0 ro=1 drv=host_device
(qemu) change ide1-cd0 /path/to/image

モニタコンソールを使用することで、キーボードやマウスの入力を擬似することができます。たとえば、お使いのグラフィカルユーザインターフェイス側で認識されてしまうようなキー入力、たとえば X Window であれば Ctrl–Alt–F1 を VM ゲスト に送信したい場合、 sendkey キー入力 のように入力して実行することで、擬似的にキー入力を送信することができます:

sendkey ctrl-alt-f1

キー入力 の箇所で指定可能なキー名の一覧を表示するには、 sendkey と入力して <Tab> を押します。

マウスを制御したい場合は、下記のようなコマンドを使用することができます:

仮想マシンを -balloon virtio オプション付きで起動している場合 (準仮想化デバイスが有効化されている場合) 、利用可能なメモリを動的に変更することができるようになります。バルーンデバイスの有効化に関する詳細については、 35.1項 「qemu-system-ARCH を利用した基本的なインストール」 をお読みください。

モニタコンソール内でバルーンデバイスに関する情報を取得したり、バルーンデバイスが有効化されているかどうかを調べたりしたい場合は、 info balloon コマンドを実行します:

(qemu) info balloon

バルーンデバイスが有効化されていれば、 balloon メモリ量 (MB 単位) を入力して実行することで、メモリ量を変更することができます:

(qemu) balloon 400

仮想マシンのメモリをディスクやコンソール出力に保存したい場合は、下記のコマンドをお使いください:

QEMU モニタ内でのスナップショット管理機能は、 SUSE ではサポートしていません。本章内での情報は、特定の用途で役に立つものです。

仮想マシン のスナップショット機能は、 CPU やメモリ、書き込み可能な全てのディスクの内容を含む、仮想マシン内の全情報のスナップショットです。仮想マシンのスナップショット機能を使用するには、少なくとも 1 台以上のリムーバブルでない書き込み可能メディアが存在し、かつそれが qcow2 ディスク形式を使用していなければなりません。

スナップショット機能は、お使いの仮想マシンの状態を保存したい場合に便利な機能です。たとえば仮想サーバ内のネットワークサービスを設定していて、何か実験やテストなどを行ってサーバを不安定にしてしまうようなことを行いたい場合、あとから元の状態にすぐに安定状態に戻す用途で使用したりすることができます。また、仮想マシンの電源を落としてスナップショットを採取することで、バックアップとして使用することもできます。本章では前者について説明しています。後者については 35.2.3項 「qemu-img を利用した仮想マシンのスナップショット管理」 で説明しています。

QEMU モニタ内でスナップショットを管理するコマンドとして、下記のようなものが用意されています:

仮想マシンの一時停止や再開を行いたい場合は、下記のようなコマンドを使用します:

ライブマイグレーションを行うことで、一方のホストシステムから他方のホストシステムに対して、仮想マシンを動作させた状態のまま移動することができます。恒久的にホストを移動することができるほか、メンテナンスなどで一時的に移動することもできます。

ライブマイグレーションを行う際の要件は下記のとおりです:

重要: サポート状態について

openSUSE Leap では postcopy モードはサポートしていません。これは技術プレビューとしてのみ提供されているものです。 postcopy モードに関する詳細は、 https://wiki.qemu.org/Features/PostCopyLiveMigration (英語) をお読みください。

また、さらに詳しい推奨条件が https://www.linux-kvm.org/page/Migration に書かれています。

ライブマイグレーションは下記の手順で行います:

QMP は JSON ベースのプロトコルで、 libvirt のようなアプリケーションと動作中の QEMU インスタンスの間で通信を行うことができるプロトコルです。 QMP プロトコルを使用することで、 QEMU モニタにさまざまな方法でアクセスすることができるようになります。

> sudo qemu-system-x86_64 [...] \
-chardev stdio,id=mon0 \
-mon chardev=mon0,mode=control,pretty=on

<- {
    "QMP": {
        "version": {
            "qemu": {
                "micro": 0,
                "minor": 0,
                "major": 2
            },
            "package": ""
        },
        "capabilities": [
        ]
    }
}

-> { "execute": "qmp_capabilities" }
<- {
    "return": {
    }
}

->{ "execute": "eject", "arguments": { "device": "ide1-cd0" } }
<- {
    "timestamp": {
        "seconds": 1410353381,
        "microseconds": 763480
    },
    "event": "DEVICE_TRAY_MOVED",
    "data": {
        "device": "ide1-cd0",
        "tray-open": true
    }
}
{
    "return": {
    }
}

> sudo qemu-system-x86_64 [...] \
-chardev socket,id=mon0,host=localhost,port=4444,server,nowait \
-mon chardev=mon0,mode=control,pretty=on

> telnet localhost 4444
Trying ::1...
Connected to localhost.
Escape character is '^]'.
<- {
    "QMP": {
        "version": {
            "qemu": {
                "micro": 0,
                "minor": 0,
                "major": 2
            },
            "package": ""
        },
        "capabilities": [
        ]
    }
}

> sudo qemu-system-x86_64 [...] \
-chardev stdio,id=mon0 -mon chardev=mon0,mode=readline \
-chardev socket,id=mon1,host=localhost,port=4444,server,nowait \
  -mon chardev=mon1,mode=control,pretty=on

> sudo qemu-system-x86_64 [...] \
-qmp unix:/tmp/qmp-sock,server --monitor stdio

QEMU waiting for connection on: unix:./qmp-sock,server

> sudo nc -U /tmp/qmp-sock
<- {"QMP": {"version": {"qemu": {"micro": 0, "minor": 0, "major": 2} [...]

37.11.4 libvirt の virsh コマンド経由での QMP アクセス #Edit source

libvirt (詳しくは パートII「libvirt を利用した仮想マシンの管理」 をお読みください) 内で仮想マシンを動作させている場合は、 virsh qemu-monitor-command を実行することで、動作中のゲストと通信を行うことができます:

> sudo virsh qemu-monitor-command vm_guest1 \
--pretty '{"execute":"query-kvm"}'
<- {
    "return": {
        "enabled": true,
        "present": true
    },
    "id": "libvirt-8"
}

上記の例では、ホスト側に KVM を動作させる機能が存在しているかどうかと、 KVM が有効化されているかどうかを調べる、シンプルな query-kvm コマンドを実行しています。

ヒント: 読みやすい出力の生成方法について

JSON 形式ではなく分かりやすい QEMU 出力を使用したい場合は、 --hmp オプションを指定して実行してください:

> sudo virsh qemu-monitor-command vm_guest1 --hmp "query-kvm"