Windows向けXenServer VM Tools

Windows向けXenServer VM Tools（旧称：Citrix VM Tools）には従来型デバイスエミュレーションのようなオーバーヘッドがなく、高パフォーマンスのI/Oサービスが提供されます。Windows向けXenServer VM Toolsは、I/Oドライバー（準仮想化ドライバーまたはPVドライバーともいいます）と管理エージェントで構成されています。

仮想マシンが完全にサポートされる構成にするには、各Windows仮想マシンにWindows向けXenServer VM Toolsをインストールする必要があります。仮想マシンはそれらがなくても動作しますが、パフォーマンスは大幅に低下します。

Windows向けXenServer VM Toolsのバージョンは、Citrix Hypervisorのバージョンとは関係なく更新されます。Windows向けXenServer VM Toolsが、仮想マシンと、仮想マシンの作成に使用するテンプレートの両方で、定期的に最新バージョンに更新されていることを確認してください。最新バージョンのToolsについて詳しくは、「Updates to Citrix VM Tools for Windows - For XenServer and Citrix Hypervisor」または「新機能」を参照してください。

XenServer VM Toolsのインストール

注：

Windows仮想マシンにWindows向けXenServer VM Toolsをインストールするには、その仮想マシン上でMicrosoft .NET Framework Version 4.0またはそれ以降が実行されている必要があります。

Windows向けXenServer VM Toolsをインストールする前に、Windows UpdateからI/Oドライバーを受け取るように仮想マシンが設定されていることを確認してください。I/Oドライバーのアップデートを受け取るには、Windows Updateが推奨されています。ただし、Windows Updateが仮想マシンで利用可能なオプションでない場合は、管理エージェントを使用してI/Oドライバーのアップデートを受け取るか、ドライバーを手動で更新することもできます。詳しくは、「I/Oドライバーのアップデート」を参照してください。

Windows向けXenServer VM Toolsをインストールするには：

1. XenServer VM Toolsをインストールまたは更新する前に、VMのスナップショットを作成しておくことをお勧めします。

2. Windows向けXenServer VM Toolsのファイルは、Citrix Hypervisorのダウンロードページからダウンロードできます。

   1. Citrixアカウントにログインして、ダウンロード可能なファイルにアクセスします。
   2. Citrix Hypervisorダウンロードページの製品セクションを展開し、サポートされているバージョンのCitrix Hypervisorをクリックします。

   3. 製品ページで、Citrix Hypervisorの主要コンポーネントセクションに移動します。

      Windows向けXenServer VM Toolsは、32ビット版および64ビット版をご用意しています。

   4. MSIファイルをダウンロードし、提供されたSHA256値に対してダウンロード内容を検証します。

3. ファイルを、Windows仮想マシン、またはWindows仮想マシンがアクセスできる共有ドライブにコピーします。

4. managementagentxXX.msiファイルを実行して、XenServer VM Toolsのインストールを開始します。

   Msiexec.exe /package managementagentxXX.msi
   

5. インストーラーの指示に従います。

   • ウィザードの手順に従って、ライセンス契約書に同意し、保存先フォルダーを選択します。

   • ［Installation and Updates Settings］ ページで設定をカスタマイズします。Citrix Hypervisor Windows Management Agent Setupウィザードで推奨設定が表示されます。ウィザードは、デフォルトで以下の設定を表示します：

     • I/Oドライバーのインストール
     • 管理エージェントの自動アップデートを許可する
     • 管理エージェントが自動的にI/Oドライバーをアップデートすることを許可しない
     • Citrixに匿名の使用状況情報を送信する

     管理エージェントの自動アップデートを許可しない場合は、［管理エージェントが自動的にI/Oドライバーをアップデートすることを許可しない］ を選択します。

     管理エージェントによるI/Oドライバーの自動アップデートを許可する場合は、［管理エージェントが自動的にI/Oドライバーをアップデートすることを許可する］を選択します。ただし、I/Oドライバーのアップデートは、Management Agentではなく、Windows Updateで行うことをお勧めします。

     注：

     Windows UpdateメカニズムによるI/Oドライバーのアップデートを選択した場合は、管理エージェントによるI/Oドライバーの自動アップデートを許可しないでください。

     匿名の使用状況情報をCitrixと共有しない場合は、［匿名の使用状況情報をCitrixに送信する］ チェックボックスをオフにします。Citrixに送信される情報には、アップデートを要求する仮想マシンのUUIDが含まれます。それ以外の仮想マシンに関する情報は収集されず、Citrixに送信されることもありません。

   • ［次へ］、［インストール］の順にクリックして、Windows向けXenServer VM Toolsのインストールプロセスを開始します。

6. 確認メッセージが表示されたら仮想マシンを再起動してインストール処理を完了します。

注：

インストールの一環で仮想マシンが再起動された後に、Windows向けXenServer VM Toolsで、/quiet /norestartまたは/quiet /forcerestartを指定して再起動を要求できます。

Windows Updateからアップデートを受け取ることができるWindows仮想マシンには、I/Oドライバーが自動的にインストールされます。ただし、Windows向けXenServer VM Toolsをインストールして管理エージェントをインストールし、サポートされている構成を保持することをお勧めします。

RDPを介してWindows向けXenServer VM Toolsまたは管理エージェントをインストールすると、再起動のプロンプトが表示されない場合があります。これは、再起動のプロンプトがWindowsコンソールセッションでのみ表示されるためです。仮想マシンを再起動し（必要な場合）、仮想マシンを最適化された状態にするために、RDPで強制再起動オプションを指定します。仮想マシンを最適化された状態にするために必要な場合にのみ、強制再起動オプションによって仮想マシンが再起動されます。

サイレントインストール

Windows向けXenServer VM Toolsをサイレントインストールしてシステムが再起動されないようにするには、次のコマンドを実行します：

Msiexec.exe /package managementagentx86.msi /quiet /norestart
Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->

非インタラクティブで、サイレントインストールしない場合は、次を実行します：

Msiexec.exe managementagentx86.msi /passive
Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->

インストール設定をカスタマイズするには、サイレントインストールコマンドで次のパラメーターを使用します：

たとえば、今後は管理エージェントの自動アップデートを許可せず、Citrixに匿名の情報を送信しない設定でツールのサイレントインストールを実行するには、次のいずれかのコマンドを実行します：

Msiexec.exe /package managementagentx86.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->

インタラクティブで、サイレントおよびパッシブインストールを行う場合は、次回のシステム再起動の後、Windows向けXenServer VM Toolsが完全にインストールされるまでに、何回か自動的に再起動される場合があります。/norestartフラグを指定してインストールした場合もこの動作になります。ただし、/norestartフラグを指定したインストールでは、最初の再起動は手動の場合があります。

Windows向けXenServer VM Toolsは、デフォルトで仮想マシンのC:\Program Files\Citrix\XenToolsにインストールされます。

注：

• Windows仮想マシンにWindows向けXenServer VM Toolsをインストールするには、その仮想マシン上でMicrosoft .NET Framework Version 4.0またはそれ以降が実行されている必要があります。
• /quietパラメーターはインストールダイアログのみに適用され、デバイスドライバーのインストールには適用されません。/quietパラメーターが指定されている場合、デバイスドライバーのインストールで、必要に応じて再起動権限が要求されます。
  • /quiet /norestartが指定されている場合、すべてのツールのインストールが完了した後、システムは再起動されません。この動作は、再起動ダイアログボックスで指定した内容とは関係ありません。
  • /quiet /forcerestartが指定されている場合、すべてのツールのインストールが完了した後、システムは再起動されます。この動作は、再起動ダイアログボックスで指定した内容とは関係ありません。
  • デバイスドライバーのインストールで再起動権限が要求された場合は、quietパラメーターが指定されたツールのインストールがまだ進行中です。タスクマネージャーを使用して、インストーラーが実行中かどうかを確認できます。

警告：

Windows向けXenServer VM Toolsをインストールまたはアップグレードすると、一部のネットワークアダプタのフレンドリ名と識別子が変更されてしまう場合があります。特定のアダプタを使用するように設定したソフトウェアは、Windows向けXenServer VM Toolsのインストールまたはアップグレードの後で再設定が必要になる場合があります。

Windows向けXenServer VM Toolsを更新する

Citrix Hypervisorは、よりシンプルなメカニズムを搭載しており、Windows仮想マシンのI/Oドライバー（PVドライバー）と管理エージェントを自動的にアップデートします。このメカニズムにより、アップデートが利用可能になるとインストールできます。

Windows向けXenServer VM Toolsが、仮想マシンと、仮想マシンの作成に使用するテンプレートの両方で、定期的に最新バージョンに更新されていることを確認してください。

XenServer VM Toolsをインストールまたは更新する前に、VMのスナップショットを作成しておくことをお勧めします。

重要：

現在8.2.x.x以前のドライバーを使用していて、管理エージェントMSIファイルを使用して最新バージョンのドライバーに更新する場合は、これらのドライバーをインストールする前に、Device Managerを使用してVMから8.2.x.xドライバーをアンインストールする必要があります。この手順を完了しないと、MSIのインストールプロセスは失敗します。

Windows向けXenServer VM Toolsのさまざまなコンポーネントを更新するには、次の設定を使用することをお勧めします。

1. 次のレジストリキーの値をREG_DWORD値「3」に設定します： HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot
2. 仮想マシンがWindows UpdateからI/Oドライバーを受け取るように設定されていることを確認します。
3. 管理エージェントが自動的に更新されるように設定します。

XenCenterの ［全般］ タブの ［仮想化の状態］ では、仮想マシンがWindows Updateからアップデートを受け取ることができるかどうかを指定します。Windows UpdateからI/Oドライバーのアップデートを受け取るメカニズムは、デフォルトではオンになっています。Windows UpdateからI/Oドライバーのアップデートを受け取らない場合は、仮想マシンでWindows Updateを無効にするか、グループポリシーを指定します。

重要：

要求されたすべての仮想マシンの再起動が、更新の一部として完了したことを確認してください。複数回の再起動が必要になる場合があります。要求された再起動がすべて完了していないと、予期しない動作が発生する可能性があります。

以下のセクションで、I/Oドライバーおよび管理エージェントの自動アップデートについて説明します。

I/Oドライバーのアップデート

I/Oドライバーのアップデートは、次の場合、Microsoft Windows Updateから自動的に入手できます：

• Citrix Hypervisor 8.2 Premium Editionを実行している、またはCitrix Virtual Apps and DesktopsやCitrix DaaSの利用特典によりCitrix Hypervisorにアクセスできる。

• Citrix Hypervisor 8.2と動作するXenCenterを使用してWindows仮想マシンを作成している

• 仮想マシンでWindows Updateが有効になっている

• 仮想マシンがインターネットにアクセスできる、またはWSUSプロキシサーバーに接続できる

注：

Windows Server Coreでは、I/OドライバーのインストールまたはアップデートにWindows Updateを使用できません。代わりに、Windows向けXenServer VM ToolsインストーラーをCitrix Hypervisorのダウンロードページから入手して使用してください。XenServer VM Toolsは、サポートされているすべてのバージョンのCitrix Hypervisorでダウンロード可能なコンポーネントとして提供されています。これらをダウンロードするには、Citrixアカウントにログインする必要があります。

ユーザーは、管理エージェントの自動アップデートメカニズムでI/Oドライバーのアップデートを自動的に受信することもできます。Windows向けXenServer VM Toolsのインストール中に、この設定を構成できます。詳しくは、「Windows向けXenServer VM Toolsをインストールする」を参照してください。

I/Oドライバーバージョンを確認する

仮想マシンにインストールされているI/Oドライバーのバージョンを確認するには、次の手順に従います。

1. C:\Windows\System32\driversにアクセスします。

2. 一覧からドライバーを見つけます。

3. ドライバーを右クリックして ［プロパティ］ を選択し、次に ［詳細］ を選択します。

   ［ファイルのバージョン］ フィールドには、仮想マシンにインストールされているドライバーのバージョンが表示されます。

自動での再起動

要求されたすべての仮想マシンの再起動が、更新の一部として完了したことを確認してください。複数回の再起動が必要になる場合があります。要求された再起動がすべて完了していないと、予期しない動作が発生する可能性があります。

デバイスマネージャーまたはWindows Updateを使用して、ドライバーをインストールするときに実行される自動再起動の最大数を指定するレジストリキーを設定できます。xenbusドライバーバージョン9.1.1.8以降をインストールした後、Windows向けXenServer VM Toolsは、このレジストリキーによって提供されるガイダンスを使用します。以前のバージョンのxenbusを使用している場合は、予期しない動作が発生する可能性があります。この問題が発生した場合は、XenCenterから仮想マシンを再起動してください。

この機能を使用するには、できるだけ早く次のレジストリキーを設定することをお勧めします： HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot。レジストリキーの値は正の整数である必要があります。レジストリキーの再起動回数を3に設定することをお勧めします。

このレジストリキーが設定されている場合、Windows向けXenServer VM Toolsは、更新を完了するために必要な回数、またはレジストリキーで指定された再起動回数のいずれか低い方の値で再起動を実行します。

各再起動の前に、Windowsは60秒間、次の再起動を警告するアラートを表示できます。アラートを閉じることはできますが、この操作で再起動がキャンセルされることはありません。再起動には時間がかかるため、最初の再起動後、再起動サイクルが完了するまで数分待ってください。

注：

この設定は、静的IPアドレスを持つヘッドレスサーバーに必要です。

この自動再起動機能は、デバイスマネージャーやWindows UpdateによるWindows I/Oドライバーのアップデートにのみ適用されます。管理エージェントインストーラーを使用してドライバーを展開している場合、インストーラーはこのレジストリキーを無視し、独自の設定に従って仮想マシンの再起動を管理します。

すべての再起動が完了するまで待機した後も予期しない動作が発生する場合は、XenCenterから仮想マシンの再起動を開始して、構成の復元を試みてください。

コマンドラインを使用して自動再起動を設定する

Windows仮想マシンで、コマンドプロンプトを管理者として開き、次のコマンドを実行します：

reg add HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->

また、Windows仮想マシンがリモートアクセスを許可するように構成されている場合は、別のシステムの管理者コマンドプロンプトから次のコマンドを実行できます：

reg add \<windows-name>\HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->

詳しくは、reg add Windowsコマンドを参照してください。

レジストリエディターを使用して自動再起動を設定する

1. Windowsのスタートメニューからレジストリエディターを開き、キーHLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters​に移動します。
2. Autorebootという名前のREG_DWORDタイプの新しいサブキーを作成します。
3. Autorebootの値を整数に設定します（例： 3）。

管理エージェントのアップデート

Citrix Hypervisorでは、新しいWindows仮想マシンおよび既存のWindows仮想マシンの両方で、管理エージェントを自動的にアップデートできます。Citrix Hypervisorは、デフォルトで管理エージェントの自動アップデートを許可します。ただし、管理エージェントが自動的にI/Oドライバーをアップデートすることは許可しません。Windows向けXenServer VM Toolsのインストール中、管理エージェントのアップデート設定をカスタマイズできます。管理エージェントの自動アップデートはシームレスに行われ、仮想マシンを再起動しません。仮想マシンの再起動が必要なシナリオでは、必要なアクションをユーザーに通知するメッセージが仮想マシンの［コンソール］タブに表示されます。

次の場合、管理エージェントのアップデートを自動的に取得できます：

• Citrix Hypervisor 8.2 Premium Editionを実行している、またはCitrix Virtual Apps and DesktopsやCitrix DaaSの利用特典によりCitrix Hypervisorにアクセスできる。

• Citrix Hypervisor 7.0以降と動作するWindows向けXenServer VM Toolsがインストールされている

• Windows仮想マシンがインターネットにアクセスできる

管理エージェントバージョンの確認

仮想マシンにインストールされている管理エージェントのバージョンを確認するには、次の手順に従います。

1. C:\Program Files\Citrix\XenToolsにアクセスします。

2. 一覧からXenGuestAgentを右クリックして ［プロパティ］ を選択し、次に ［詳細］ を選択します。

   ［ファイルのバージョン］ フィールドには、仮想マシンにインストールされている管理エージェントのバージョンが表示されます。

CLIを使用した自動アップデートの管理

Citrix Hypervisorでは、I/Oドライバーや管理エージェントの自動アップデートの管理にコマンドラインを使用できます。次の表の引数を指定してmsiexec.exeを実行して、I/Oドライバーや管理エージェントを自動でアップデートするかどうかを指定できます。msiexec.exeを使用してWindows向けXenServer VM Toolsをインストールする方法については、「サイレントインストール」を参照してください。

注：

PVSまたはMCSを使用して管理される仮想マシンでは、Citrix Virtual Desktops VDAが存在し、マシンが非永続であることがレポートされている場合、自動アップデートは自動的にオフになります。

例：

msiexec.exe /i managementagentx64.msi ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
    ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

管理エージェントのアップデートのリダイレクト

Citrix Hypervisorでは、ユーザーが管理エージェントのアップデートを、内部Webサーバーにリダイレクトしてからインストールできます。このリダイレクトより、アップデートが仮想マシンに自動的にインストールされる前にレビューできます。

管理エージェントのアップデートをリダイレクトするには：

管理エージェントは、アップデートファイルを使用して利用可能な更新に関する情報を取得します。このアップデートファイルの名前は、使用する管理エージェントのバージョンによって異なります：

• 管理エージェント9.2.1.35以降の場合は、https://pvupdates.vmd.citrix.com/autoupdate.v1.jsonを使用します。
• 管理エージェント9.0.0.0～9.2.0.27の場合、https://pvupdates.vmd.citrix.com/updates.v9.json。

管理エージェントのアップデートをリダイレクトするには、次の手順を実行します：

1. アップデートファイルをダウンロードします。

2. アップデートファイルで参照されている管理エージェントのMSIファイルをダウンロードします。

3. 仮想マシンがアクセスできる内部WebサーバーにMSIファイルをアップロードします。

4. アップデートファイルを更新して、内部WebサーバーのMSIファイルをポイントするようにします。

5. アップデートファイルをWebサーバーにアップロードします。

自動アップデートも、仮想マシンごとやプールごとにリダイレクトできます。仮想マシンごとにアップデートをリダイレクトする手順は、以下のとおりです。

1. 仮想マシンで、コマンドプロンプトを管理者として開きます。

2. コマンドを実行する

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_SZ /v update_url /d \
       url of the update file on the web server
   <!--NeedCopy-->
   

プールごとに管理エージェントの自動アップデートをリダイレクトするには、以下のコマンドを実行します：

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_url=url of the update file on the web server
<!--NeedCopy-->

管理エージェントのアップデートの無効化

仮想マシンごとに管理エージェントの自動アップデートを無効にするには、以下のコマンドを実行します：

1. 仮想マシンで、コマンドプロンプトを管理者として開きます。

2. 次のコマンドを実行します：

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_DWORD /v DisableAutoUpdate /d 1
   <!--NeedCopy-->
   

プールごとに管理エージェントの自動アップデートを無効にするには、以下のコマンドを実行します。

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=false
<!--NeedCopy-->

自動I/Oドライバーのアップデート設定の変更

Windows向けXenServer VM Toolsのインストール中、管理エージェントが自動的にI/Oドライバーをアップデートするのを許可するかどうかを指定できます。Windows向けXenServer VM Toolsのインストールプロセスが完了してからこの設定をアップデートする場合は、次の手順を実行します：

1. 仮想マシンで、コマンドプロンプトを管理者として開きます。

2. 次のコマンドを実行します：

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
       InstallDrivers /d YES/NO
   <!--NeedCopy-->
   

匿名の使用状況情報をCitrixに送信するには：

Windows向けXenServer VM Toolsのインストール中、匿名の使用状況情報をCitrixに送信するかを指定できます。Windows向けXenServer VM Toolsのインストールプロセスが完了してからこの設定をアップデートする場合は、次の手順を実行します：

1. 仮想マシンで、コマンドプロンプトを管理者として開きます。

2. 次のコマンドを実行します：

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate REG_SZ /v \
       IDENTIFYAUTOUPDATE /d YES/NO
   <!--NeedCopy-->
   

Windows向けXenServer VM Toolsのトラブルシューティング

XenServer VM Toolsの診断情報を取得するツールxtbugtoolが利用可能です。詳しくは、「仮想マシンの問題のトラブルシューティング」を参照してください。

Windows向けXenServer VM Toolsをアンインストールする

Windows仮想マシンからXenServer VM Toolsを削除することは推奨しません。Windows仮想マシンを完全にサポートするには、これらのツールが必要です。これらを削除すると、予期しない動作が発生する可能性があります。XenServer VM Toolsを手動でアンインストールするのは、他に手段がない場合に限ります。

標準アンインストール

XenServer VM Toolsの標準的なアンインストールを行うには、Windowsの ［プログラムの追加と削除］ 機能を使用できます：

1. 開始する前に、仮想マシンのスナップショットを作成します。
2. Windows仮想マシンで、［プログラムの追加と削除］ に移動します。
3. ［Citrix Hypervisor PV Tools］ を選択し、［アンインストール］ をクリックします。
4. 仮想マシンを再起動します。

uninstall.exeコマンド

Windowsの ［プログラムの追加と削除］ 機能を使用してXenServer VM Toolsをアンインストールすると、<tools-install-directory>\uninstall.exeファイルが呼び出されてアンインストール操作が実行されます。代わりに、管理者権限を使用して、PowerShellターミナルまたはコマンドプロンプトからこのコマンドを呼び出すこともできます。

1. 開始する前に、仮想マシンのスナップショットを作成します。
2. 管理者として、コマンドプロンプトまたはPowerShellターミナルを開きます。
3. コマンド<tools-install-directory>\uninstall.exeを実行します。
4. 仮想マシンを再起動します。

コマンドオプション

uninstall.exeコマンドで使用できるパラメーターは次のとおりです：

• help - コマンドの使用情報を表示します。
• log - コマンドの実行内容を示すログファイルを生成します。
• verbose - コマンドが実行した内容をコンソールに出力します。
• disable - インストーラーMSIによってインストールされたドライバーを無効にします。
• force-disable - すべての状況でドライバーを無効にします。
• hidden - 非表示のデバイスを削除します。これらのデバイスは使用されておらず、置き換えられていますが、古いレジストリエントリが残っている可能性があります。
• cleanup - ［プログラムの追加と削除］ から古いアンインストーラーを削除します。これらのアンインストーラーには、ツールの古いバージョンからの重複したエントリが含まれる場合があります。
• purge -（9.3.1以降）仮想マシンを、XenServer VM Toolsの一部がインストールされる前のクリーンな状態にリセットします。詳しくは、「XenServer VM Toolsの全コンポーネントの完全なアンインストール」を参照してください。
• install - （9.3.1以降）I/Oドライバーの現在のセットをインストールします。必要に応じて仮想マシンの再起動も要求します。
• reboot- ほかのすべてのコマンド操作が完了したら仮想マシンを再起動します。

XenServer VM Toolsの全コンポーネントの完全なアンインストール

Windows向けXenServer VM Toolsの最新バージョン（9.3.1以降）には、uninstall.exe purgeというコマンドが含まれています。uninstall.exeアプリケーションのpurgeオプションは、一切のI/Oドライバーがインストールされる前に状態に仮想マシンをリセットします。ツールを新しいバージョンにアップグレードするときに問題が発生した場合、または新しいツールセットを仮想マシンにインストールするためにクリーンな状態にする必要がある場合は、このユーティリティを使用します。

1. 開始する前に、仮想マシンのスナップショットを作成します。
2. 管理者として、コマンドプロンプトまたはPowerShellターミナルを開きます。
3. <tools-install-directory>\uninstall.exe purge verboseのコマンドを実行します
4. 仮想マシンを再起動します。

このコマンドを使用した後は、以前のバージョンのXenServer VM Toolsで必要だったような手動のクリーンアップ操作を実行する必要はありません。XenServer VM Toolsに関連するすべての変更が削除されています。

purgeオプションで削除されるもの

uninstall.exe purgeのコマンドを使用すると、XenServer VM ToolsのすべてのトレースがWindows仮想マシンから削除されます。このコマンドによって実行されるアクションの一覧は次のとおりです：

• サービス：
  • すべてのXenServer VM Toolsサービスを無効にします。これにより、インストールされているドライバーとサービスが再起動時に開始されなくなります。
  • 実行中のXenServer VM Toolsサービスを停止します。
• ドライバー：
  • すべてのデバイスノードからI/Oドライバーをアンインストールします。
  • 非表示のデバイスをアンインストールします。このアクションは、hiddenコマンドラインオプションを実行した場合と同じです。
  • キャッシュされたドライバーパッケージをアンインストールして、ドライバーストアから削除します。その結果、I/Oドライバーは自動的に再インストールされません。
• レジストリ：
  • サポートされていないバージョンのドライバーで使用されている古いレジストリ情報を削除します。
  • HKLM\System\CurrentControlSet\Control\Class\...からツール関連のキーを削除します。
  • HKLM\System\CurrentControlSet\Servicesからツール関連のキーを削除します。
  • HKLM\System\CurrentControlSet\Enum\...からツール関連のキーを削除します。
• ファイル：
  • C:\Windows\System32とC:\Windows\System32\driversからXenServer VM Toolsドライバーファイルを削除します。
  • C:\Windows\INFからXenServer VM ToolsのINFファイルを削除します。
  • サポートされていないバージョンのツールによって残された古いファイルを、C:\Program Files\Citrix\XenToolsから削除します。
• その他：
  • ［プログラムの追加と削除］ で古いエントリを削除します。このアクションは、cleanupコマンドラインオプションを実行した場合と同じです。
  • InstallAgentの古い状態情報の一部をクリアします。
  • 上位フィルターからxenfilt.sysを削除します。この変更により、xenfilt.sysがドライバーノードにロードされなくなります。
  • unplugキーを削除すると、再起動したとき、仮想マシンがエミュレートされたデバイスに戻ります。
  • StorNvmeのStartOverrideを削除します。この変更により、起動時にstornvme.sysが強制的に起動され、エミュレートされたNVMe（UEFI）起動デバイスが機能できるようになります。

新機能

Windows向けXenServer VM Toolsのバージョンは、Citrix Hypervisorのバージョンとは関係なく更新されます。Windows向けXenServer VM Toolsが、仮想マシンと、仮想マシンの作成に使用するテンプレートの両方で、定期的に最新バージョンに更新されていることを確認してください。

Windows向けXenServer VM Tools 9.3.1

2023年1月25日リリース

このツールセットには、次のコンポーネントバージョンが含まれています：

• インストーラー：9.3.1
• 管理エージェント：9.2.1.35
• xenbus：9.1.5.54
• xeniface：9.1.5.42
• xennet：9.1.3.34
• xenvbd：9.1.4.37
• xenvif：9.1.8.58

9.3.1の改善点

このリリースには、以下の改善点が含まれています：

• purgeパラメーターを含む、uninstall.exeユーティリティの改善。詳しくは、「Windows向けXenServer VM Toolsをアンインストールする」を参照してください。
• XenServer VM Toolsインストーラーの全般的な改善。
• レジストリキーの文字列処理の全般的な改善。

9.3.1で解決された問題

このリリースには、次の問題に対する修正が含まれています：

• Windows Updateを使用してXenServer VM Toolsを更新すると、静的IP設定が失われ、ネットワーク設定がDHCPを使用するように変更されることがあります。
• Windows VMでは、付与テーブルが簡単に使い果たされる可能性があります。これが発生すると、読み取りおよび書き込み要求が失敗するか、追加のVIF（Virtual Network Interface：仮想ネットワークインターフェイス）が正しく有効化されず、開始できない可能性があります。
• まれに、Windows向けXenServer VM Toolsをアップグレードするときに、既存の管理エージェントがシャットダウンに失敗し、アップグレードが成功しないことがあります。
• Windows仮想マシンでは、インストール済みプログラムの一覧に、ツールまたは管理エージェントの以前のバージョンと最新バージョンの両方が表示される場合があります。
  • （旧バージョン）Citrix XenServer Windows Management Agent
  • （最新バージョン）Citrix Hypervisor PV Tools。

以前のリリース

9.3.0

2022年7月26日リリース

このツールセットには、次のコンポーネントバージョンが含まれています：

• インストーラー：9.3.0
• 管理エージェント：9.2.0.27
• xenbus：9.1.4.49
• xeniface：9.1.4.34
• xennet：9.1.3.34
• xenvbd：9.1.3.33
• xenvif：9.1.6.52

このリリースには、以下の改善点が含まれています：

• XenServer VM Toolsインストーラーの全般的な改善。

このリリースには、次の問題に対する修正が含まれています：

• データ流出防止策として、取り外し可能としてマークされたセカンダリディスクがOSに公開されるのをセキュリティソフトウェアが阻んでいました。今回のアップデートにより、VBD（Virtual Block Device：仮想ブロックデバイス）を取り外し不可としてフラグを立て、OSを通じて正しく公開できるようになりました。
• Windows仮想マシンで、SR-IOV VIFのIPアドレスがXenCenterに表示されないことがあります。

9.2.3

2022年4月28日リリース

このツールセットには、次のコンポーネントバージョンが含まれています：

• インストーラー：9.2.3
• 管理エージェント：9.1.1.13
• xenbus：9.1.3.30
• xeniface：9.1.4.34
• xennet：
  • 9.1.1.8（Windows Server 2012、Windows Server 2012 R2の場合）
  • 9.1.2.23（上記以外のサポートされているWindowsオペレーティングシステムの場合）
• xenvbd：9.1.2.20
• xenvif：9.1.5.48

このリリースには、次の問題に対する修正が含まれています：

• Windows向けXenServer VM Toolsバージョン9.2.2では、時刻同期オプションは利用できません。
• 競合状態により、Citrix Hypervisor 8.2累積更新プログラム1でのライブマイグレーション後に、Windows仮想マシンにブルースクリーンエラーが表示されることがあります。
• バージョン9.2.1または9.2.2のXenServer VM Toolsがインストールされており、かつPVSのターゲットであるWindows仮想マシンの場合、黒い画面でフリーズすることがあります。dom0カーネルログに「ゲストRxが停止中です」というメッセージが表示されます。この問題は、ほかのプールメンバーよりもプールマスターでより頻繁に発生します。
• 8つを超える仮想CPUを搭載したWindows仮想マシンでは、xenvifドライバーが間接指定テーブルの設定に失敗するため、受信側スケーリングが機能しない場合があります。

9.2.2

2022年1月14日リリース

このツールセットには、次のコンポーネントバージョンが含まれています：

• インストーラー：9.2.2
• 管理エージェント：9.1.1.13
• xenbus：9.1.3.30
• xeniface：9.1.2.22
• xennet：
  • 9.1.1.8（Windows Server 2012、Windows Server 2012 R2の場合）
  • 9.1.2.23（上記以外のサポートされているWindowsオペレーティングシステムの場合）
• xenvbd：9.1.2.20
• xenvif：9.1.3.31

このリリースには、次の問題に対する修正が含まれています：

• ツールの更新中、ドライバーのインストールが完了する前に、xenbusドライバーが再起動を要求する場合があります。再起動を許可すると、Windows仮想マシンでブルースクリーンエラーが発生する可能性があります。
• 収集した診断情報を圧縮すると、xt-bugtool診断ツールが20秒後にタイムアウトします。この動作により、診断のzipファイルが正しく作成されない可能性があります。
• 仮想ネットワークコンピューティングのクリップボード共有が機能しません。
• 以前のバージョンのドライバーは、Windows Updateを通じてリリースされませんでした。

9.2.1

2021年6月24日リリース

このツールセットには、次のコンポーネントバージョンが含まれています：

• インストーラー：9.2.1
• 管理エージェント：9.1.0.10
• xenbus：9.1.2.14
• xeniface：9.1.1.11
• xennet：9.1.1.8
• xenvbd：9.1.1.8
• xenvif：9.1.2.16

注：

このドライバーセットは、Windows Updateでは提供されませんでした。

このリリースには、次の問題に対する修正が含まれています：

• 場合によっては、仮想マシンのノートPC/スレート状態は変更できません。
• 仮想マシンが再起動すると、daemon.logファイルに過剰なログメッセージが送信されることがあります。
• OSのアップグレード後にドライバーの負荷依存関係の競合状態が発生すると、XenServer VM Toolsのアップグレードが妨げられることがあります。
• ストレージエラーにより、Windows仮想マシンがクラッシュする可能性があります。
• SR-IOV VIFのIPアドレスがXenCenterに表示されないことがあります。この問題を修正するには、仮想マシンのサービスマネージャー内から管理エージェントを再起動します。
• ネットワークとシステムの負荷が高く、リソースが少ない場合、Citrixとサードパーティのドライバーの両方にて、仮想マシンでバグチェックが行われることがあります。通常、IRQL_NOT_LESS_OR_EQUALというコードで行われます。この修正により、ネットワークのバッファ処理が改善され、こうしたバグチェックが防止されます。
• WindowsのI/Oドライバーをアップグレードすると、次のメッセージとともにUEFI仮想マシンが起動に失敗しすることがあります。「0xC000000E。必要なデバイスが接続されていないか、アクセスできません。」
• 以前のバージョンのXenServer VM ToolsをアンインストールしてからXenServer VM Toolsをインストールすると、「このデバイスを開始できません。（コード10）（操作の失敗）要求した操作が失敗しました。」というエラーメッセージが返されるという問題が発生する場合があります。