Windows 用 XenServer® VM ツール
Windows 向け XenServer VM Tools (旧称 Citrix VM Tools または XenServer PV Tools) は、従来のデバイスエミュレーションのオーバーヘッドなしに、高性能なI/Oサービスを提供します。Windows 向け XenServer VM Tools は、I/Oドライバー (準仮想化ドライバーまたはPVドライバーとも呼ばれます) と管理エージェントで構成されています。
VMが完全にサポートされた構成であるためには、各Windows VMにXenServer VM Tools for Windowsをインストールする必要があります。VMはそれらなしでも機能しますが、パフォーマンスは低下します。
XenServer VM Tools for Windowsのバージョンは、XenServerのバージョンとは独立して更新されます。サポート対象となるには、VM内およびVMの作成に使用するテンプレートの両方で、XenServer VM Tools for Windowsが常に最新バージョンに更新されていることを確認してください。ツールの最新バージョンについては、新機能を参照してください。
XenServer VM Toolsのインストール
注記:
Windows VMにXenServer VM Tools for Windowsをインストールするには、VMでMicrosoft .NET Frameworkバージョン4.0以降が実行されている必要があります。
XenServer VM Tools for Windowsは、VM上のC:\Program Files\XenServer\XenToolsディレクトリにデフォルトでインストールされます。
XenServer VM Tools for Windowsをインストールするには:
-
XenServer VM Toolsをインストールまたは更新する前に、VMのスナップショットを作成することをお勧めします。
-
XenServerダウンロードページからXenServer VM Tools for Windowsファイルをダウンロードします。
-
提供されているSHA-256値と照合して、ダウンロードを検証します。
-
ファイルをWindows VM、またはWindows VMがアクセスできる共有ドライブにコピーします。
-
managementagentx64.msiファイルを実行して、XenServer VM Toolsのインストールを開始します。Msiexec.exe /package managementagentx64.msi -
インストーラーの指示に従います。
-
ウィザードの指示に従って、ライセンス契約に同意し、保存先フォルダーを選択します。
-
インストールと更新の設定ページで設定をカスタマイズします。
デフォルトでは、ウィザードは次の推奨設定を表示します。
- XenServer VM Tools for Windows を自動的に最新の状態に保つ。
一部のユースケースでは、異なる更新設定が推奨されます。詳細については、「XenServer VM Tools の更新」を参照してください。
更新設定を構成するには、次の変更を行うことができます。
- Management Agent の自動更新を許可しない場合は、XenServer VM Tools for Windows を自動的に最新の状態に保つチェックボックスの選択を解除します。
-
次へをクリックし、インストールをクリックして、XenServer VM Tools for Windows のインストールプロセスを開始します。
-
-
インストールプロセスを完了するために、プロンプトが表示されたらVMを再起動します。
RDP を介して XenServer VM Tools for Windows または Management Agent をインストールするお客様は、再起動のプロンプトが表示されない場合があります。これは、Windows コンソールセッションでのみ表示されるためです。VM を再起動し(必要な場合)、VM を最適化された状態にするには、RDP で強制再起動オプションを指定します。強制再起動オプションは、VM を最適化された状態にするために必要な場合にのみ VM を再起動します。
警告:
XenServer VM Tools for Windows をインストールまたはアップグレードすると、一部のネットワークアダプターのフレンドリ名と識別子が変更される場合があります。特定のネットワークアダプターを使用するように構成されているソフトウェアは、XenServer VM Tools for Windows のインストールまたはアップグレード後に再構成する必要がある場合があります。
サイレントインストール
XenServer VM Tools for Windows をサイレントインストールし、システムの再起動を防ぐには、次のコマンドを実行します。
Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->
非対話型ではあるがサイレントではないインストールは、次のコマンドを実行することで実現できます。
Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->
注記:
/quietパラメーターはインストールダイアログにのみ適用され、デバイスドライバーのインストールには適用されません。/quietパラメーターが指定されている場合、デバイスドライバーのインストールは、必要に応じて再起動の許可を求めます。
/quiet /norestartが指定されている場合、ツール全体のインストールが完了してもシステムは再起動しません。この動作は、ユーザーが再起動ダイアログで指定した内容とは関係ありません。/quiet /forcerestartが指定されている場合、アップグレードまたはインストールプロセスによって複数回の再起動がトリガーされることがあります。この動作は、ユーザーが再起動ダイアログで指定した内容とは関係ありません。- デバイスドライバーのインストールが再起動の許可を求めたとき、
quietパラメーターが指定されたツールインストールがまだ進行中である可能性があります。インストーラーがまだ実行中であるかどうかを確認するには、タスクマネージャーを使用してください。
インストール設定をカスタマイズするには、サイレントインストールコマンドで次のパラメーターを使用します。
| パラメーター | 許可される値 | デフォルト | 説明 |
|---|---|---|---|
| ALLOWAUTOUPDATE | YES または NO | YES | 管理エージェントの自動更新を許可する |
例えば、将来の管理エージェントの自動更新を許可しないツールのサイレントインストールを行うには、次のいずれかのコマンドを実行します。
Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->
対話型、サイレント、およびパッシブインストールの場合、次のシステム再起動後、XenServer VM Tools for Windowsが完全にインストールされるまでに複数の自動再起動が発生する可能性があります。この動作は、/norestartフラグが指定されたインストールの場合も同様です。ただし、/norestartフラグが指定されたインストールの場合、最初の再起動は手動で開始されることがあります。
XenServer VM Toolsの更新
XenServer VM Tools for Windowsは、VM内およびVMの作成に使用するすべてのテンプレートで、常に最新バージョンに更新されていることを確認してください。XenServer VM Toolsを更新する前に、VMのスナップショットを作成することをお勧めします。ツールの最新バージョンについては、新機能を参照してください。
重要:
更新の一部として、要求されたすべてのVM再起動が完了していることを確認してください。複数回の再起動が必要になる場合があります。要求されたすべての再起動が完了しない場合、VMが予期しない動作を示す可能性があります。
XenServerは、各コンポーネントに自動更新メカニズムを提供します。
- 管理エージェントは、自身とI/Oドライバーを自動的に更新できます。
- I/Oドライバーは、XenCenterの新規VMウィザードでVMテンプレートを選択する際に、Windows Update経由でも更新できます。Windows Update経由で提供される更新プログラムはVMの再起動を引き起こす可能性があるため、この方法は推奨されません。Windows Update経由でのI/Oドライバー更新の有効化に関する詳細は、VM作成手順の概要を参照してください。
ツールはMSIインストーラーでインストールし、組み込みの管理エージェント更新メカニズムを使用して更新を管理することをお勧めします。インストーラーでツールをインストールすると、管理エージェント更新メカニズムはMachine Creation Services (MCS)またはCitrix Provisioningを使用してプロビジョニングされたVMを自動的に検出し、プロビジョニングされたマシンに影響を与えることなくゴールデンイメージに更新を適用できます。
あるいは、インストーラーを使用してこれらのコンポーネントのいずれかまたは両方を更新することもできます。
ツールの各コンポーネントに選択する更新方法は、お使いの環境によって異なります。
推奨される更新設定
ほとんどのユースケースでは、XenServer VM Tools for WindowsをMSIインストーラーでインストールし、管理エージェントを使用して自身とI/Oドライバーの両方を最新の状態に保つことをお勧めします。このアプローチにより、Windows Update経由で更新が提供された場合に発生する可能性のあるVMの再起動を回避できます。
次の設定をお勧めします。
-
Windows Update を介した I/O ドライバーの更新を無効にする(#disable-io-driver-updates-through-windows-update)。
インストール時:
設定の既定値が推奨されます。
既定の更新設定が選択された XenServer VM Tools インストーラー(/en-us/xenserver/8/media/tools-updates-recommended.png)
Citrix Provisioning™ ターゲットまたは起動時にリセットされるマシンの設定
Windows VM を Citrix Provisioning ターゲットとして使用する場合、または起動時にリセットするフラグを有効にして使用する場合、自動更新メカニズムは使用できません。これらの VM の作成に使用するマスターテンプレートで、以下の構成を設定することをお勧めします。
-
VM の作成時に、
has-vendor-deviceフラグがfalseに設定されていることを確認してください。これにより、Windows Update が XenServer VM Tools for Windows の I/O ドライバーを自動的に更新するのを防ぎます。このフラグは、次の方法で設定できます。- CLI を使用する。詳細については、「CLI を使用して Windows VM を作成する」を参照してください。
インストール時:
XenServer VM Tools を初めてインストールするときに、この構成を指定します。
自動更新設定が選択されていない XenServer VM Tools インストーラー(/en-us/xenserver/8/media/tools-updates-recommended.png)
Management Agent のみによる自動更新の設定
Management Agent が自身と I/O ドライバーの両方を更新するように構成できます。
組織が Windows VM に更新を適用する前にレビューすることを要求する場合は、このアプローチを選択してください。この場合、Management Agent が内部サーバーから更新を取得するようにリダイレクトする必要もあります。
-
Windows Update を介した I/O ドライバーの更新を無効にする(#disable-io-driver-updates-through-windows-update)。
-
(オプション) 管理エージェントの更新をリダイレクトする(#redirect-the-management-agent-updates)。
インストール中:
XenServer VM Tools を初めてインストールする際に、この構成を指定します。
自動更新設定が選択されていない XenServer VM Tools インストーラー(/en-us/xenserver/8/media/tools-updates-recommended.png)
管理エージェントを更新する
XenServer を使用すると、新規および既存の Windows VM の両方で管理エージェントを自動的に更新できます。デフォルトでは、XenServer は管理エージェントの自動更新を許可しています。XenServer VM Tools for Windows のインストール中に、管理エージェントの更新設定をカスタマイズできます。管理エージェントの自動更新はシームレスに行われ、VM を再起動することはありません。VM の再起動が必要なシナリオでは、VM のコンソールタブに、必要なアクションをユーザーに通知するメッセージが表示されます。
Windows VM がインターネットにアクセスできる場合、管理エージェントの更新を自動的に取得できます。
CLI を使用して自動更新を管理する
XenServer を使用すると、コマンドラインを使用して I/O ドライバーと管理エージェントの自動更新を管理できます。I/O ドライバーと管理エージェントが自動的に更新されるかどうかを指定するには、次の表にリストされている引数とともに msiexec.exe を実行します。msiexec.exe を使用した XenServer VM Tools for Windows のインストールについては、「サイレントインストール」を参照してください。
注:
PVS または MCS のいずれかを使用して管理されている VM の場合、管理エージェントは非永続的なマシンを自動的に検出し、それらの自動更新を無効にします。これにより、プロビジョニングされたマシンに影響を与えることなく、ゴールデンイメージにツール更新を適用でき、リセット時に失われる非永続的な VM での更新試行を防ぐことができます。
| 引数 | 値 | 説明 |
|---|---|---|
| ALLOWAUTOUPDATE | はい/いいえ | 管理エージェントの自動更新を許可/不許可にする |
管理エージェントの更新を有効にする
VMごとに管理エージェントの自動更新を有効にするには、次の手順を実行します。
-
VM上で、管理者としてコマンドプロンプトを開きます。
-
次のコマンドを実行します。
reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate /t REG_DWORD /v DisableAutoUpdate /d 0 <!--NeedCopy-->
プールごとに管理エージェントの自動更新を有効にするには、ホストコンソールで次のコマンドを実行します。
xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=true
<!--NeedCopy-->
管理エージェントの更新を無効にする
VMごとに管理エージェントの自動更新を無効にするには、次の手順を実行します。
-
VM上で、管理者としてコマンドプロンプトを開きます。
-
次のコマンドを実行します。
reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate /t REG_DWORD /v DisableAutoUpdate /d 1 <!--NeedCopy-->
プールごとに管理エージェントの自動更新を無効にするには、ホストコンソールで次のコマンドを実行します。
xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=false
<!--NeedCopy-->
管理エージェントの更新をリダイレクトする
XenServerでは、管理エージェントの更新がインストールされる前に、内部Webサーバーにリダイレクトできます。このリダイレクトにより、顧客は更新がVMに自動的にインストールされる前に確認できます。
管理エージェントは、利用可能な更新に関する情報を取得するために更新ファイルを使用します。この更新ファイルの名前は、使用している管理エージェントのバージョンによって異なります。
- 管理エージェント 9.4.0 以降では、https://pvupdates.vmd.citrix.com を使用します。
管理エージェントを最新バージョンにアップグレードすることを強くお勧めします。ただし、古いバージョンの管理エージェントを使用している場合は、古いバージョンで使用するための以下の更新ファイルを提供しています。
- 管理エージェント 9.2.1.35 から 9.3.3.125 まで https://pvupdates.vmd.citrix.com/autoupdate.v1.json。
- 管理エージェント 9.0.0.0 から 9.2.0.27 まで https://pvupdates.vmd.citrix.com/updates.v9.json。
管理エージェントの更新をリダイレクトするには、以下の手順を実行します。
-
更新ファイルをダウンロードします。
-
更新ファイルで参照されている管理エージェントの MSI ファイルをダウンロードします。
-
管理エージェントの MSI ファイルのハッシュが、更新ファイルで参照されているものと一致することを検証します。
-
VM がアクセスできる内部 Web サーバーに MSI ファイルをアップロードします。
-
更新ファイルを更新して、内部 Web サーバー上の MSI ファイルを指すようにします。
-
更新ファイルを Web サーバーにアップロードします。
自動更新は、VM ごとまたはプールごとにリダイレクトすることもできます。VM ごとに更新をリダイレクトするには:
-
VM 上で、管理者としてコマンドプロンプトを開きます。
-
コマンドを実行します。
reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools /t REG_SZ /v update_url /d \ url of the update file on the web server <!--NeedCopy-->
プールごとにManagement Agentの自動更新をリダイレクトするには、次のコマンドを実行します。
xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_url=url of the update file on the web server
<!--NeedCopy-->
I/Oドライバーを更新する
I/Oドライバーは、Windows UpdateまたはManagement Agentを使用して更新できます。XenCenterのVMのGeneralタブにあるVirtualization stateセクションは、VMがWindows Updateから更新を受け取る資格があるかどうかを示します。または、自動更新をオフにして、I/Oドライバーの更新を手動で管理することもできます。
各I/Oドライバー(xennet、xenvif、xenvbd、xeniface、xenbusなど)には独自のバージョンがあります。最新バージョンの詳細については、新機能を参照してください。
Windows Update を介した I/O ドライバーの更新を有効にする
Microsoft Windows Update から I/O ドライバーの更新を自動的に取得するには、以下の条件を満たす必要があります。
-
VMでWindows Updateが有効になっていること。
-
VMがインターネットにアクセスできるか、WSUSプロキシサーバーに接続できること。
-
Windows ServerのCoreバージョンを実行していないこと。Windows Server Coreは、Windows Updateを使用してI/Oドライバーをインストールまたは更新することをサポートしていません。
XenCenterのNew VMウィザードでVMテンプレートを選択する際に、Windows Updateを介したI/Oドライバーの更新を有効にできます。Windows Updateを介したI/Oドライバーの更新を有効にする方法の詳細については、VM作成手順の概要を参照してください。
Windows UpdateからI/Oドライバーの更新を受け取りたくない場合は、VMでWindows Updateを無効にするか、グループポリシーを指定してください。
Windows Update を介した I/O ドライバーの更新を無効にする
新規および既存のVMの両方で、Windows Updateを介したI/Oドライバーの更新を無効にできます。
-
新規VMの場合: XenCenterのNew VMウィザードを使用して新しいVMを作成する際に、フラグを設定することで自動I/Oドライバー更新を無効にできます。これは、Citrix Provisioningターゲットまたは起動時にリセットされるマシンにとって特に重要であり、自動更新を無効にすることで安定性が確保されます。詳細については、VM作成手順の概要およびCitrix Provisioningターゲットまたは起動時にリセットされるマシンの設定を参照してください。コマンドラインを使用してこれらの設定を管理することを好む上級ユーザーの場合は、CLIを使用してWindows VMを作成するを参照してください。
-
既存VMの場合: VMがすでに展開されている場合は、グループポリシーを構成することでI/Oドライバーの更新を無効にできます。これにより、VMがWindows Updateから自動更新を受け取らないようにします。
管理エージェントがI/Oドライバーを更新するように設定する
詳細については、「Windows 用 XenServer VM Tools のインストール」を参照してください。
自動再起動
更新の一部として、要求されたすべてのVM再起動が完了していることを確認してください。複数の再起動が必要になる場合があります。要求されたすべての再起動が完了しない場合、予期しない動作が発生する可能性があります。
デバイスマネージャーまたはWindows Updateを介してドライバーをインストールする際に実行される自動再起動の最大数を指定するレジストリキーを設定できます。xenbusドライバーバージョン9.1.1.8以降をインストールすると、Windows用XenServer VM Toolsはこのレジストリキーによって提供されるガイダンスを使用します。以前のバージョンのxenbusを使用している場合、予期しない動作が発生する可能性があります。この場合、XenCenterからVMを再起動してください。
この機能を使用するには、できるだけ早く次のレジストリキーを設定することをお勧めします: HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot。レジストリキーの値は正の整数である必要があります。レジストリキーの再起動回数を3に設定することをお勧めします。
このレジストリキーが設定されている場合、Windows用XenServer VM Toolsは、更新を完了するために必要な再起動回数、またはレジストリキーで指定された再起動回数のいずれか少ない方の回数だけ再起動を実行します。
各再起動の前に、Windowsは今後の再起動を警告するアラートを60秒間表示できます。このアラートを閉じることができますが、この操作によって再起動がキャンセルされることはありません。再起動間のこの遅延のため、最初の再起動後、再起動サイクルが完了するまで数分間待ってください。
注:
この設定は、静的IPアドレスを持つヘッドレスサーバーに必要です。
この自動再起動機能は、デバイスマネージャーまたはWindows Updateを介したWindows I/Oドライバーの更新にのみ適用されます。管理エージェントインストーラーを使用してドライバーを展開している場合、インストーラーはこのレジストリキーを無視し、独自の設定に従ってVMの再起動を管理します。
すべての再起動が完了するのを待った後も予期しない動作が発生する場合は、構成を復元するためにXenCenter®からVMの再起動を開始してください。
コマンドラインを使用して自動再起動を設定する
Windows VMで、管理者としてコマンドプロンプトを開き、次のコマンドを実行します。
reg add HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->
または、Windows VMがリモートアクセスを許可するように構成されている場合は、別のシステムの管理者コマンドプロンプトから次のコマンドを実行できます。
reg add \\<windows-name>\HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->
詳細については、reg add Windows コマンドを参照してください。
レジストリエディターを使用して自動再起動を設定する
- Windowsのスタートメニューからレジストリエディターを開き、次のキーに移動します:
HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters。 - タイプ
REG_DWORDの新しいサブキーをAutorebootという名前で作成します。 -
Autorebootの値を整数に設定します。例:3。
その他の設定とクエリ
I/Oドライバーのバージョンを確認する
VMにインストールされているI/Oドライバーのバージョンを確認するには:
-
C:\Windows\System32\driversに移動します。 -
リストからドライバーを見つけます。
-
ドライバーを右クリックし、プロパティ、次に詳細を選択します。
ファイルのバージョンフィールドに、VMにインストールされているドライバーのバージョンが表示されます。
管理エージェントのバージョンを確認する
VMにインストールされている管理エージェントのバージョンを確認するには:
-
C:\Program Files\XenServer\XenToolsに移動します。 -
リストから
XenGuestAgentを右クリックし、プロパティ、次に詳細をクリックします。ファイルバージョンフィールドには、VM にインストールされている管理エージェントのバージョンが表示されます。
バージョン 9.6.0.19 での動作変更
XenServer VM Tools for Windows 9.6.0.19 以降、VM の has-vendor-device パラメータが変更された際の信頼性を向上させるため、デバイスのアクティベーション動作が変更されました。
XenServer VM Tools for Windows は現在、次のようになっています。
- 優先度ベースのデバイスアクティベーションを使用する
- 構成の変更を自動的に管理する
- デバイスの移行全体で一貫した子デバイス識別子を使用する
- 再起動後に正しい PV デバイスに自動的に移行する
これらの改善は、共有ゴールデンイメージを使用する MCS および PVS 環境にとって特に重要です。
has-vendor-device パラメータを変更した後、手動でのデバイスクリーンアップや追加の再起動サイクルは不要です。
パラメータの変更を有効にするには、シャットダウンと再起動が引き続き必要です。
XenServer VM Tools for Windows のトラブルシューティング
XenServer VM Tools の診断情報を取得するツール xtbugtool を提供しています。詳細については、「VM の問題のトラブルシューティング」を参照してください。
has-vendor-device パラメータの切り替え
VMのhas-vendor-deviceパラメータを変更するには、VMをシャットダウンして再起動する必要があります。
注:
イメージがデプロイされた後で
has-vendor-deviceを切り替えることは推奨されません。reset-on-bootイメージは起動ごとに構成を再構築するため、ネットワーク構成が変更される可能性があります。
XenServer VM Tools for Windows 9.6.0.19以降では:
- 起動時に正しいPVデバイスが自動的に選択されます
- 重複するバックエンド接続が防止されます
- デバイス構成の不一致が自動的に解決されます
再起動後、VM内での追加の再起動サイクルや手動介入は不要です。
以前のバージョンのXenServer VM Tools for Windowsがインストールされている場合、追加の再起動または手動でのデバイスクリーンアップが必要になることがあります。
XenServer VM Toolsのアンインストール
Windows VMからXenServer VM Toolsを削除することはお勧めしません。これらのツールは、Windows VMが完全にサポートされるために必要です。これらを削除すると、予期しない動作が発生する可能性があります。XenServer VM Toolsの手動アンインストールは、最終手段としてのみ行ってください。
標準アンインストール
XenServer VM Toolsを標準アンインストールするには、Windowsのプログラムの追加と削除機能を使用できます。
- 開始する前にVMのスナップショットを作成します。
- Windows VMで、プログラムの追加と削除に移動します。
- XenServer VM Tools を選択し、アンインストール をクリックします。
- VM を再起動します。
uninstall.exe コマンド
Windows の プログラムの追加と削除 機能を使用して XenServer VM Tools をアンインストールすると、アンインストール操作を実行するために <tools-install-directory>\uninstall.exe ファイルが呼び出されます。代わりに、管理者権限を持つ PowerShell ターミナルまたはコマンドプロンプトからこのコマンドを呼び出すこともできます。
- 開始する前に、VM のスナップショットを作成します。
- 管理者として、コマンドプロンプトまたは PowerShell ターミナルを開きます。
-
<tools-install-directory>\uninstall.exeコマンドを実行します。 - VM を再起動します。
コマンドオプション
uninstall.exe コマンドは次のパラメーターを受け入れます。
-
help- コマンドの使用情報を表示します。 -
log- コマンドが実行した内容を示すログファイルを生成します。 -
verbose- コマンドが実行した内容をコンソールに出力します。 -
disable- インストーラー MSI によってインストールされたドライバーを無効にします。 -
force-disable- すべての状況でドライバーを無効にします。 -
hidden- 隠しデバイスを削除します。これらのデバイスは未使用で、すでに置き換えられていますが、古いレジストリエントリが残っている可能性があります。 -
cleanup- プログラムの追加と削除から古いアンインストーラーを削除します。これらのアンインストーラーには、以前のバージョンのツールからの重複エントリが含まれている場合があります。 -
purge- (9.3.1以降) VMを、XenServer VM Toolsのいずれかの部分がインストールされる前のクリーンな状態にリセットします。詳細については、「すべてのXenServer VM Toolsコンポーネントの完全アンインストール」を参照してください。 -
install- (9.3.1以降) 現在のI/Oドライバーセットをインストールし、必要に応じてVMの再起動を促します。 -
reboot- 他のすべてのコマンド操作が完了した後、VMを再起動します。
すべてのXenServer VM Toolsコンポーネントの完全アンインストール
Windows用XenServer VM Toolsの最新バージョン(9.3.1以降)には、コマンドuninstall.exe purgeが含まれています。uninstall.exeアプリケーションのpurgeオプションは、I/Oドライバーがインストールされる前の状態にVMをリセットします。ツールを新しいバージョンにアップグレードする際に問題が発生している場合や、VMに新しいツールセットをインストールするためにクリーンな状態が必要な場合は、このユーティリティを使用してください。
- 開始する前にVMのスナップショットを作成します。
- 管理者として、コマンドプロンプトまたはPowerShellターミナルを開きます。
- コマンド
<tools-install-directory>\uninstall.exe purge verboseを実行します。 - VMを再起動します。
このコマンドを使用した後、以前のバージョンのXenServer VM Toolsで必要だったような手動のクリーンアップ手順を実行する必要はありません。XenServer VM Toolsに関連するすべての変更が削除されています。
purgeオプションは何を削除しますか?
コマンドuninstall.exe purgeを使用すると、XenServer VM Toolsのすべての痕跡がWindows VMから削除されます。このコマンドによって実行されるアクションのリストは次のとおりです。
- サービス:
- すべての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 ToolsINFファイルを削除します。 -
C:\Program Files\Citrix\XenToolsおよびC:\Program Files\XenServer\XenToolsから、サポート対象外のバージョンのツールによって残された古いファイルをすべて削除します。
-
- その他:
-
プログラムの追加と削除にある古いエントリを削除します。この操作は、
cleanupコマンドラインオプションによって実行されるものと同じです。 - InstallAgent の古い状態情報の一部をクリアします。
- upper-filters から
xenfilt.sysを削除します。この変更により、xenfilt.sysがどのドライバーノードにもロードされなくなります。 -
unplugキーを削除します。これにより、VM は再起動時にエミュレートされたデバイスに戻ります。 - StorNvme の StartOverride を削除します。この変更により、
stornvme.sysは起動時に強制的に開始され、エミュレートされた NVMe (UEFI) ブートデバイスが機能するようになります。
-
プログラムの追加と削除にある古いエントリを削除します。この操作は、
ベストプラクティス
MCS および PVS 展開の推奨バージョン
VM が has-vendor-device=true と has-vendor-device=false の間で移行する環境では、XenServer VM Tools for Windows 9.6.0.19 以降を使用してください。
このバージョンでは、PV デバイスの移行の信頼性が向上し、共有ゴールデンイメージ展開における構成の不一致が減少します。
新機能
XenServer VM Tools for Windows のバージョンは、XenServer のバージョンとは独立して更新されます。VM 内および VM の作成に使用するすべてのテンプレートで、XenServer VM Tools for Windows が常に最新バージョンに更新されていることを確認してください。
XenServer VM Tools for Windows の最新バージョンは、XenServer ダウンロードページ から入手できます。
Windows 用 XenServer VM ツール 9.6.0
May 13, 2026 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.6.0
- 管理エージェント 9.6.0.12
- ゼンバス 9.1.13.23
- ゼンイフェイス 9.1.14.6
- ゼンネット 9.1.8.6
- ゼンブイブイディー 9.1.11.5
- ゼンブイエフ 9.1.15.8
9.6.0での変更点
-
VM構成変更に対する回復性が向上しました。
-
システムトレイアイコンからの通知が改善されました。
9.6.0で修正された点
-
RSSネットワークトラフィックがCPU間で分散されない問題を修正しました。
-
一部の構成でXenServer VM Tools for Windowsを更新する際に発生するバグチェックを修正しました。
以前のリリース
9.4.2
Sep 24, 2025 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.4.2
- 管理エージェント 9.3.2.95
- ゼンバス 9.1.12.120
- ゼニフェイス 9.1.13.96
- xennet バージョン 9.1.7.65
- xenvbd バージョン 9.1.10.84
- ゼーンビフ 9.1.14.109
9.4.2での変更点
- インストールオプションの簡素化
- XenServer VM Tools for Windowsの通知を提供するシステムトレイアイコン
このリリースには、テレメトリーを収集するための更新も含まれています。
9.4.2で修正済み
- CPU間でのネットワークワークロードの分散を改善
9.4.1
May 27, 2025 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.4.1
- 管理エージェント: 9.3.1.80
- ゼーンバス: 9.1.11.115
- ゼニフェイス: 9.1.12.94
- ゼネット: 9.1.7.65
- xenvbd: 9.1.9.82 バージョン
- xenvif: 9.1.13.107 バージョン
CTX692748 - XenServer and Citrix Hypervisor Security Bulletinに記載されている問題の影響を受けるすべてのお客様は、このバージョンのツール以降にアップデートする必要があります。
このリリースには、収集されたテレメトリへの更新も含まれています。
9.4.1で修正された問題
このリリースには、以下の問題に対する修正が含まれています。
- 場合によっては、XenServer VM Tools 9.4.0 がインストールされていると、Windows 11 を 23H2 から 24H2 にアップグレードできません。
- 管理エージェントは、VM の再起動時または起動時にクラッシュすることがあります。
- 一部の Windows VM で、予期しないハード再起動が発生することがあります。
9.4.0
Oct 22, 2024 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.4.0
- 管理エージェント: 9.3.0.65
- ゼンバス: 9.1.9.105
- ゼニフェイス: 9.1.10.87
- xennet バージョン 9.1.7.65
- xenvbd バージョン 9.1.8.79
- xenvif: 9.1.12.101
このリリースには、以下の問題に対する修正が含まれています。
- The XenServer VM Tools for Windows version is not correctly reported to Citrix Hypervisor™ due to the Management Agent checking the incorrect InstallStatus value in the registry.
- StorNvmeのStartOverrideレジストリキーの処理が不完全なため、Windows Updateを介したXenServer VM Toolsの更新中にWindows VMを再起動すると、「Inaccessible Boot Device」エラーでBSODが発生する可能性があります。
- XenServer VM Tools for Windowsを更新する際、静的IP設定が失われ、ネットワーク設定がDHCPを使用するように変更されることがあります。この問題は、バージョン9.3.3以降から更新する場合(例:9.4.0から新しいバージョンへ)は解決されます。ただし、9.3.3より前のバージョンから更新する場合(例:9.3.2から9.4.0へ)は、更新中に一度だけ問題が発生しますが、それ以降の更新には影響しません。詳細については、サポート記事「VM Tools for Windows 9.3.3以前への更新時に静的IPが失われる」を参照してください。
このリリースには、以下の既知の問題が含まれています。
- 自動更新にManagement Agentを使用している場合は、証明書チェックの問題により9.3.3が9.4.0に自動的に更新されないため、バージョン9.4.0以降に手動で更新する必要があります。この問題を解決するには、各VMにXenServer VM Tools for Windows 9.4.0以降のバージョンを手動でインストールしてください。
9.3.3
Jun 04, 2024 にリリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.3.3
- 管理エージェント: 9.2.3.60
- xenbus: バージョン 9.1.8.88
- xeniface: バージョン 9.1.9.78
- xennet バージョン 9.1.6.60
- xenvbd バージョン 9.1.7.66
- xenvif: バージョン 9.1.11.92
このリリースには、以下の問題に対する修正が含まれています。
- VMが重い負荷状態にある場合、管理エージェントがManagementExceptionでクラッシュすることがあります。
- Windows 2022 Serverでは、単一のvCPUがCPUを100%消費することがあります。その結果、サーバーが応答しなくなります。
- OpenVSwitchネットワークとVLANタグ付きイーサネットフレームを使用するプールでホストされているWindows VMは、ネットワーク接続が不安定になることがあります。
9.3.2
Nov 27, 2023 リリース
このリリースでは、Citrix® VM ToolsがXenServer VM Toolsにリブランドされます。
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.3.2
- 管理エージェント: 9.2.2.435
- ゼンバス: 9.1.7.80
- ゼニフェイス: 9.1.8.69
- ゼンネット: 9.1.5.51
- ゼンブイビード: 9.1.6.58
- ゼンブイアイエフ: 9.1.10.83
このリリースには、以下の改善点も含まれています。
-
uninstall.exeコマンドの改善。 - XenServerのバージョンとWindowsオペレーティングシステムがサポートしている場合、一部のWindows VMで最大64個のvCPUを使用できるようにするための変更。
このリリースには、以下の問題に対する修正が含まれています。
- XenServer VM Toolsのインストール中に、致命的ではないエラーが原因でインストールが失敗することがあります。
9.3.1
Jan 25, 2023 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.3.1
- 管理エージェント: 9.2.1.35
- xenbus: バージョン 9.1.5.54
- ゼニフェイス: 9.1.5.42
- ゼンネット: 9.1.3.34
- xenvbd のバージョン: 9.1.4.37
- xenvif のバージョン: 9.1.8.58
このリリースには、以下の改善が含まれています。
-
uninstall.exeユーティリティの改善点。これにはpurgeパラメーターが含まれます。詳細については、XenServer VM Toolsのアンインストールを参照してください。 - XenServer VM Toolsインストーラーの全般的な改善。
- レジストリキーの文字列処理に関する全般的な改善。
このリリースには、以下の問題に対する修正が含まれています。
- Windows Updateを通じてXenServer VM Toolsが更新されると、静的IP設定が失われ、ネットワーク設定がDHCPを使用するように変更されることがあります。
- Windows VMでは、グラントテーブルが容易に枯渇する可能性があります。この場合、読み取りおよび書き込み要求が失敗したり、追加のVIFが正しく有効にならずに起動に失敗したりすることがあります。
- まれに、Windows用XenServer VM Toolsをアップグレードする際に、既存の管理エージェントがシャットダウンに失敗し、アップグレードが成功しないことがあります。
- Windows VMでは、インストールされているプログラムに、ツールまたは管理エージェントの以前のバージョンとそれ以降のバージョンの両方が表示されることがあります。
- (以前のバージョン) Citrix XenServer Windows Management Agent
- (以降のバージョン) Citrix Hypervisor PV Tools。
ツールを最新バージョンに更新すると、これらの以前の名前はどちらも表示されません。インストールされているプログラムには、XenServer VM Toolsのみが表示されます。
9.3.0
リリース日: Jul 26, 2022
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.3.0
- 管理エージェント: 9.2.0.27
- ゼノバス:9.1.4.49
- ゼニフェイス:9.1.4.34
- ゼネット: 9.1.3.34
- ゼンブイディー: 9.1.3.33
- xenvif バージョン 9.1.6.52
このリリースには、以下の改善が含まれています。
- XenServer VM Toolsインストーラーに対する全般的な改善。
このリリースには、以下の問題に対する修正が含まれています。
- セキュリティソフトウェアが、データ漏洩防止策として、取り外し可能とマークされたセカンダリディスクがOSに公開されるのをブロックしていました。このアップデートにより、VBDを非リムーバブルとしてフラグ付けし、OSを通じて正しく公開できるようになります。
- Windows VMでは、SR-IOV VIFのIPアドレスがXenCenterに表示されないことがあります。
9.2.3
Apr 28, 2022 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 9.2.3
- 管理エージェント: 9.1.1.13
- xenbus バージョン 9.1.3.30
- ゼニフェイス: 9.1.4.34
- ゼネット:
- 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
このリリースには、以下の問題の修正が含まれています。
- XenServer VM Tools for Windows バージョン 9.2.2 では、時刻同期オプションが利用できません。
- Citrix Hypervisor 8.2 Cumulative Update 1 でライブマイグレーションを実行した後、競合状態により Windows VM にブルースクリーンエラーが表示されることがあります。
- XenServer VM Tools のバージョン 9.2.1 または 9.2.2 がインストールされており、PVS ターゲットである Windows VM が、黒い画面でフリーズすることがあります。「Guest Rx stalled」というメッセージが dom0 カーネルログに表示されます。この問題は、他のプールメンバーよりもプールコーディネーターでより頻繁に発生します。
- 8 個を超える vCPU を搭載した Windows VM では、xenvif ドライバーが間接テーブルの設定に失敗するため、受信側スケーリングが動作しない可能性があります。
9.2.2
リリース日: Jan 14, 2022
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 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オペレーティングシステム用)
- ゼンブイビィディー:9.1.2.20
- ゼンブイアイエフ:9.1.3.31
このリリースには、以下の問題に対する修正が含まれています。
- ツールの更新中に、xenbusドライバーがドライバーのインストール完了前に再起動を促すことがあります。この再起動を受け入れると、Windows VMでブルースクリーンエラーが発生する可能性があります。
- 収集された診断情報を圧縮する際、xt-bugtool診断ツールが20秒後にタイムアウトします。この動作により、診断zipファイルが正しく作成されない可能性があります。
- VNCクリップボード共有が機能しません。
- 以前のバージョンのドライバーは、Windows Updateを通じてリリースされていませんでした。
9.2.1
Jun 24, 2021 リリース
このツールセットには、以下のコンポーネントバージョンが含まれています。
- インストーラー: 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
- ゼンヴィフ: 9.1.2.16
注:
このドライバーセットは、Windows Update を通じて提供されませんでした。
このリリースには、以下の問題に対する修正が含まれています。
- 場合によっては、VM のラップトップ/スレートの状態を変更できません。
- VM を再起動すると、daemon.log ファイルに過剰なログメッセージを送信し始めることがあります。
- OSアップグレード後のドライバーロード依存関係における競合状態により、XenServer VM Toolsのアップグレードが妨げられる可能性があります。
- ストレージエラーにより、Windows VMがクラッシュする可能性があります。
- SR-IOV VIFのIPアドレスがXenCenterに表示されない場合があります。この問題を解決するには、VMのサービスマネージャー内から管理エージェントを再起動してください。
- 高いネットワークおよびシステム負荷、およびリソース不足の状況下で、VMはCitrixおよびサードパーティ製ドライバーの両方でバグチェックを経験する可能性があり、通常はコードIRQL_NOT_LESS_OR_EQUALを伴います。この修正により、ネットワークバッファリングが改善され、これらのバグチェックが防止されます。
- Windows I/Oドライバーをアップグレードすると、UEFI VMが起動に失敗し、「0xC000000E. 必要なデバイスが接続されていないか、アクセスできません。」と報告される可能性があります。
- 以前のバージョンのXenServer VM Toolsをアンインストールした後でXenServer VM Toolsをインストールする際に、「このデバイスを開始できません (コード 10) (操作が失敗しました) 要求された操作は成功しませんでした」というエラーメッセージが返される問題が発生する可能性があります。