19.2. virtiofs を使用したホストとその仮想マシン間でのファイルの共有

手順

1. 仮想マシンと共有するホストの各ディレクトリーを、仮想マシンの XML 設定の virtiofs ファイルシステムとして設定します。

   1. 目的の仮想マシンの XML 設定を開きます。

      # virsh edit vm-name

   2. 仮想マシンの XML 設定の <devices> に、以下のようなエントリーを追加します。

      <filesystem type='mount' accessmode='passthrough'>
        <driver type='virtiofs'/>
        <binary path='/usr/libexec/virtiofsd' xattr='on'/>
        <source dir='/root/shared-files'/>
        <target dir='host-file-share'/>
      </filesystem>

      この例では、ホストの/root/shared-files ディレクトリーを、仮想マシンのhost-file-share として表示するように設定します。

2. 共有メモリー用の NUMA トポロジーを XML 設定に追加します。以下の例では、すべての CPU と RAM に基本的なトポロジーを追加します。

   <cpu mode='host-passthrough' check='none'>
     <numa>
       <cell id='0' cpus='0-{number-vcpus - 1}' memory='{ram-amount-KiB}' unit='KiB' memAccess='shared'/>
     </numa>
   </cpu>

3. 共有メモリーバッキングを XML 設定の <domain> に追加します。

   <domain>
    [...]
    <memoryBacking>
      <access mode='shared'/>
    </memoryBacking>
    [...]
   </domain>

4. 仮想マシンを起動します。

   # virsh start vm-name

5. ゲストオペレーティングシステムにファイルシステムをマウントします。以下の例では、Linux ゲストオペレーティングシステムで事前に設定した host-file-share ディレクトリーをマウントします。

   # mount -t virtiofs host-file-share /mnt

手順

1. Windows 仮想マシンで WinFsp をインストールします。これを行うには、インストールプログラムを使用し、プロンプトに従います。

   インストールウィザードの Custom Setup ウィンドウで、仮想マシンにインストールする機能を選択します。

2. virtiofs サービスを起動します。

   # sc start VirtioFsSvc

3. This PC に移動します。

   File Explorer → This PC

   virtiofs は、Windows 仮想マシン上で、z: から逆順に遡る、使用可能な最初のドライブ文字として使用できます。たとえば、my_viofs (Z:) です。

   重要

   共有ディレクトリーにアクセスするには、仮想マシンを再起動するたびに virtiofs サービスを再起動する必要があります。

4. オプション: 追加の virtiofs インスタンスを設定するには、以下を実行します。

   1. virtiofs サービスを停止します。

      # sc stop VirtioFsSvc
      # sc config VirtioFsSvc start=demand

   2. 複数の virtiofs インスタンスをセットアップするように WinFSP.Launcher サービスを設定します。

      # "C:\Program Files (x86)\WinFsp\bin\fsreg.bat" virtiofs "<path to the binary>\virtiofs.exe" "-t %1 -m %2"

   3. virtiofs インスタンスをドライブにマウントします。

      たとえば、mount_tag0 タグを持つ virtiofs を Y: ドライブにマウントするには、以下を実行します。

      "C:\Program Files (x86)\WinFsp\bin\launchctl-x64.exe" start virtiofs viofsY mount_tag0 Y:

   4. 前の手順を繰り返して、すべての virtiofs インスタンスをマウントします。

   5. virtiofs インスタンスをアンマウントするには、以下を実行します。

      "C:\Program Files (x86)\WinFsp\bin\launchctl-x64.exe" stop virtiofs viofsY

検証

1. Windows 仮想マシンで、This PC に移動します。

   File Explorer → This PC

   • virtiofs サービスのセットアップ時にマウントポイントを指定しなかった場合は、z: から逆順に遡る、使用可能な最初のドライブ文字が使用されます。
   • 複数の virtiofs インスタンスをセットアップした場合、それらはインスタンスに割り当てた文字を持つドライブとして表示されます。

手順

1. 仮想マシン インターフェイスで、ファイルを共有する VM をクリックします。

   新しいページが開き、選択した VM に関する基本情報を含む 概要 セクションと、コンソール セクションが表示されます。

2. 共有ディレクトリー までスクロールします。

   共有ディレクトリー セクションには、その VM と共有されているホストファイルとディレクトリーに関する情報、および共有ディレクトリーを 追加 または 削除 するためのオプションが表示されます。

   

3. 共有ディレクトリーの追加 をクリックします。

   ホストディレクトリーをゲストと共有する ダイアログが表示されます。

   

4. 以下の情報を入力します。

   • ソースパス - 共有するホストディレクトリーへのパス。
   • マウントタグ - VM がディレクトリーをマウントするために使用するタグ。

5. 追加オプションを設定します。

   • 拡張属性 - 共有ファイルとディレクトリーで拡張属性 xattr を有効にするかどうかを設定します。

6. 共有 をクリックします。

   選択したディレクトリーは仮想マシンと共有されます。

手順

1. 仮想マシン インターフェイスで、共有ファイルを削除する VM をクリックします。

   新しいページが開き、選択した VM に関する基本情報を含む 概要 セクションと、コンソール セクションが表示されます。

2. 共有ディレクトリー までスクロールします。

   共有ディレクトリー セクションには、その VM と共有されているホストファイルとディレクトリーに関する情報、および共有ディレクトリーを 追加 または 削除 するためのオプションが表示されます。

   

3. 仮想マシンとの共有を解除するディレクトリーの横にある Remove をクリックします。

   ファイルシステムの削除 ダイアログが表示されます。

   

4. 削除 をクリックします。

   選択したディレクトリーは VM と共有されていません。