2.4. 仮想マシンでの QEMU ゲストエージェント機能の有効化


RHEL 10 システムでホストされている仮想マシンの特定の機能を使用するには、まず QEMU ゲストエージェント (GA) を使用するように仮想マシンを設定する必要があります。

これらの機能の完全なリストは、QEMU ゲストエージェントを必要とする仮想化機能 を参照してください。

2.4.1. Linux ゲストでの QEMU ゲストエージェントの有効化

Linux 仮想マシンで 一部の操作 を実行することを RHEL ホストに許可するには、QEMU ゲストエージェント (GA) を有効にする必要があります。

実行中の仮想マシンとシャットダウンした仮想マシンの両方で、QEMU GA を有効にできます。

手順

  1. QEMU GA の XML 設定ファイル (例: qemuga.xml) を作成します。

    # touch qemuga.xml
  2. ファイルに以下の行を追加します。

    <channel type='unix'>
       <source mode='bind' path='/var/lib/libvirt/qemu/f16x86_64.agent'/>
       <target type='virtio' name='org.qemu.guest_agent.0'/>
    </channel>
  3. XML ファイルを使用して、仮想マシンの設定に QEMU GA を追加します。

    • 仮想マシンが実行中の場合は、次のコマンドを使用します。

      # virsh attach-device <vm-name> qemuga.xml --live --config
    • 仮想マシンがシャットダウンされている場合は、次のコマンドを使用します。

      # virsh attach-device <vm-name> qemuga.xml --config
  4. Linux ゲストオペレーティングシステムで、QEMU GA をインストールします。

    # dnf install qemu-guest-agent
  5. ゲストで QEMU GA サービスを起動します。

    # systemctl start qemu-guest-agent

検証

QEMU GA が Linux 仮想マシンで有効化および実行されていることを確認するには、次のいずれかを実行します。

  • ゲストオペレーティングシステムで、systemctl status qemu-guest-agent | grep Loaded コマンドを使用します。出力に enabled が含まれる場合、仮想マシン上で QEMU GA がアクティブになっています。
  • ホストで virsh domfsinfo <vm-name> コマンドを使用します。何らかの出力が表示された場合、指定した仮想マシン上で QEMU GA がアクティブになっています。

2.4.2. QEMU ゲストエージェントを必要とする仮想化機能

仮想マシン (VM) で QEMU ゲストエージェント (GA) を有効にすると、ホスト上で次のコマンドを使用して仮想マシンを管理できます。

virsh shutdown --mode=agent
このシャットダウン方法は、virsh shutdown --mode=acpi よりも信頼性が高くなります。これは、QEMU GA で使用する virsh shutdown は、確実にクリーンな状態で協調ゲストをシャットダウンするためです。
virsh domfsfreeze および virsh domfsthaw
ゲストファイルシステムを分離してフリーズします。
virsh domfstrim

ゲストにファイルシステムをトリミングするように指示します。これにより、移行中に転送する必要のあるデータを削減できます。

重要

このコマンドを使用して Linux 仮想マシンを管理する場合は、ゲストオペレーティングシステムで次の SELinux ブール値も設定する必要があります。

# setsebool virt_qemu_ga_read_nonsecurity_files on
virsh domtime
ゲストの時計をクエリーまたは設定します。
virsh setvcpus --guest
ゲストに CPU をオフラインにするように指示します。これは、CPU をホットアンプラグできない場合に便利です。
virsh domifaddr --source agent
QEMU GA を使用してゲストオペレーティングシステムの IP アドレスをクエリーします。たとえば、ゲストインターフェイスがホストインターフェイスに直接割り当てられている場合に便利です。
virsh domfsinfo
実行中のゲストにマウントされているファイルシステムのリストを表示します。
virsh set-user-password
ゲストの特定のユーザーアカウントのパスワードを設定します。
virsh set-user-sshkeys

ゲストの特定のユーザーの認可された SSH 鍵ファイルを編集します。

重要

このコマンドを使用して Linux 仮想マシンを管理する場合は、ゲストオペレーティングシステムで次の SELinux ブール値も設定する必要があります。

# setsebool virt_qemu_ga_manage_ssh on
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る