Windows向けXenServer VM Tools
Windows向けXenServer VM Tools（旧称：Citrix VM ToolsまたはXenServer PV Tools）には従来型デバイスエミュレーションのようなオーバーヘッドがなく、高パフォーマンスのI/Oサービスが提供されます。Windows向けXenServer VM Toolsは、I/Oドライバー（準仮想化ドライバーまたはPVドライバーともいいます）と管理エージェントで構成されています。
仮想マシンが完全にサポートされる構成にするには、各Windows仮想マシンにWindows向けXenServer VM Toolsをインストールする必要があります。仮想マシンはそれらがなくても動作しますが、パフォーマンスは大幅に低下します。
Windows向けXenServer VM Toolsのバージョンは、XenServerのバージョンとは関係なく更新されます。継続してサポートを受けるためには、Windows向けXenServer VM Toolsが、仮想マシンと、仮想マシンの作成に使用するテンプレートの両方で、定期的に最新バージョンに更新されていることを確認してください。ツールの最新バージョンについて詳しくは、「新機能」を参照してください。
XenServer VM Toolsのインストール
注：
Windows仮想マシンにWindows向けXenServer VM Toolsをインストールするには、その仮想マシン上でMicrosoft .NET Framework Version 4.0またはそれ以降が実行されている必要があります。
Windows向けXenServer VM Toolsは、デフォルトで仮想マシンのC:\Program Files\XenServer\XenToolsにインストールされます。
Windows向けXenServer VM Toolsをインストールするには：
-
XenServer VM Toolsをインストールまたは更新する前に、VMのスナップショットを作成しておくことをお勧めします。
-
XenServer downloadsページからWindows向けXenServer VM Toolsファイルをダウンロードします。
-
提供されたSHA256値に対してダウンロード内容を検証します。
-
ファイルを、Windows仮想マシン、またはWindows仮想マシンがアクセスできる共有ドライブにコピーします。
-
managementagentx64.msiファイルを実行して、XenServer VM Toolsのインストールを開始します。Msiexec.exe /package managementagentx64.msi -
インストーラーの指示に従います。
-
ウィザードの手順に従って、ライセンス契約書に同意し、保存先フォルダーを選択します。
-
［Installation and Updates Settings］ ページで設定をカスタマイズします。
ウィザードは、デフォルトで以下の推奨設定を表示します：
- I/Oドライバーのインストール
- 仮想マシンに
has-vendor-device=trueが設定されている場合、このオプションは選択されません。I/OドライバーはWindows Updateによって既にインストールされています。 - 仮想マシンに
has-vendor-device=falseが設定されている場合は、このオプションが選択されます。
- 仮想マシンに
- 管理エージェントの自動アップデートを許可する
- 管理エージェントが自動的にI/Oドライバーをアップデートすることを許可しない
- Cloud Software Group, Incに匿名の使用状況情報を送信する。
一部のユースケースでは、異なるアップデート設定が推奨されます。詳しくは、「XenServer VM Toolsのアップデート」を参照してください。
アップデート設定を構成するために、次の変更を行うことができます：
- 管理エージェントの自動アップデートを許可しない場合は、［管理エージェントが自動的にI/Oドライバーをアップデートすることを許可しない］ を選択します。
- 管理エージェントによるI/Oドライバーの自動アップデートを許可する場合は、［管理エージェントが自動的にI/Oドライバーをアップデートすることを許可する］ を選択します。ただし、I/Oドライバーのアップデートは、Management Agentではなく、Windows Updateで行うことをお勧めします。Windows UpdateメカニズムによるI/Oドライバーのアップデートを選択した場合は、管理エージェントによるI/Oドライバーの自動アップデートを許可しないでください。
- 匿名の使用状況情報を当社と共有しない場合は、［Send anonymous usage information to Cloud Software Group, Inc.］ チェックボックスをオフにします チェックボックス。Cloud Software Groupに送信される情報には、アップデートを要求する仮想マシンのUUIDの最初の4文字が含まれます。それ以外の仮想マシンに関する情報は収集されず、送信されることもありません。
- I/Oドライバーのインストール
-
［次へ］、［インストール］の順にクリックして、Windows向けXenServer VM Toolsのインストールプロセスを開始します。
-
-
確認メッセージが表示されたら仮想マシンを再起動してインストール処理を完了します。
RDPを介してWindows向けXenServer VM Toolsまたは管理エージェントをインストールすると、再起動のプロンプトが表示されない場合があります。これは、再起動のプロンプトがWindowsコンソールセッションでのみ表示されるためです。仮想マシンを再起動し（必要な場合）、仮想マシンを最適化された状態にするために、RDPで強制再起動オプションを指定します。仮想マシンを最適化された状態にするために必要な場合にのみ、強制再起動オプションによって仮想マシンが再起動されます。
警告：
Windows向けXenServer VM Toolsをインストールまたはアップグレードすると、一部のネットワークアダプタのフレンドリ名と識別子が変更されてしまう場合があります。特定のアダプタを使用するように設定したソフトウェアは、Windows向けXenServer VM Toolsのインストールまたはアップグレードの後で再設定が必要になる場合があります。
サイレントインストール
Windows向けXenServer VM Toolsをサイレントインストールしてシステムが再起動されないようにするには、次のコマンドを実行します：
Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->
非インタラクティブで、サイレントインストールしない場合は、次を実行します：
Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->
注：
/quietパラメーターはインストールダイアログのみに適用され、デバイスドライバーのインストールには適用されません。/quietパラメーターが指定されている場合、デバイスドライバーのインストールで、必要に応じて再起動権限が要求されます。
/quiet /norestartが指定されている場合、すべてのツールのインストールが完了した後、システムは再起動されません。この動作は、再起動ダイアログボックスで指定した内容とは関係ありません。/quiet /forcerestartが指定されている場合、アップグレードまたはインストールプロセスによって複数回の再起動がトリガーされる可能性があります。この動作は、再起動ダイアログボックスで指定した内容とは関係ありません。- デバイスドライバーのインストールで再起動権限が要求された場合は、
quietパラメーターが指定されたツールのインストールがまだ進行中です。タスクマネージャーを使用して、インストーラーが実行中かどうかを確認できます。
インストール設定をカスタマイズするには、サイレントインストールコマンドで次のパラメーターを使用します：
| パラメーター | 許可される値 | デフォルト | 説明 |
|---|---|---|---|
| ALLOWAUTOUPDATE | はい/いいえ | はい | 管理エージェントの自動アップデートを許可する |
| ALLOWDRIVERINSTALL | はい/いいえ | はい | I/Oドライバーをインストールする |
| ALLOWDRIVERUPDATE | はい/いいえ | いいえ | 管理エージェントの自動アップデートで、アップデートされたドライバーのインストールを許可する |
| IDENTIFYAUTOUPDATE | はい/いいえ | はい | 当社に匿名の使用状況情報を送信する |
たとえば、今後は管理エージェントの自動アップデートを許可せず、Cloud Software Groupに匿名の情報を送信しない設定でツールのサイレントインストールを実行するには、次のいずれかのコマンドを実行します：
Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->
インタラクティブで、サイレントおよびパッシブインストールを行う場合は、次回のシステム再起動の後、Windows向けXenServer VM Toolsが完全にインストールされるまでに、何回か自動的に再起動される場合があります。/norestartフラグを指定してインストールした場合もこの動作になります。ただし、/norestartフラグを指定したインストールでは、最初の再起動は手動の場合があります。
XenServer VM Toolsのアップデート
Windows向けXenServer VM Toolsが、仮想マシンと、仮想マシンの作成に使用するテンプレートの両方で、定期的に最新バージョンに更新されていることを確認してください。XenServer VM Toolsをアップデートする前に、仮想マシンのスナップショットを作成しておくことをお勧めします。 ツールの最新バージョンについて詳しくは、「新機能」を参照してください。
重要：
要求されたすべての仮想マシンの再起動が、更新の一部として完了したことを確認してください。複数回の再起動が必要になる場合があります。要求された再起動がすべて完了していないと、仮想マシンで予期しない動作が発生する可能性があります。
XenServerは、各コンポーネントに対して自動アップデートメカニズムを提供します：
- 管理エージェントは自動的にアップデートされます
- I/Oドライバーは、管理エージェントまたはWindows Updateを通じてアップデートできます。
または、ユーザーはこれらのコンポーネントをそれぞれまたは両方、手動でアップデートできます。
ツールの各コンポーネントで選択するアップデート方法は、環境によって異なります。
推奨されるアップデート設定
多くの場合、Windows向けXenServer VM Toolsのさまざまなコンポーネントをアップデートするには、次の設定を使用することをお勧めします：
-
次のレジストリキーの値をREG_DWORD値「3」に設定します：
HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot。詳しくは、「自動再起動」を参照してください。
インストール中：
最初の2つの設定は、インストーラーを実行したときのデフォルトです：
Citrix Provisioningターゲットまたはreset-on-bootマシンの設定
Windows仮想マシンをCitrix Provisioningターゲットとして使用する場合、またはreset-on-bootフラグを設定して使用する場合は、自動アップデートメカニズムは使用できません。これらの仮想マシンを作成するために使用するマスターテンプレートで次の構成を設定することをお勧めします：
-
仮想マシンの作成中に、
has-vendor-deviceフラグがfalseに設定されていることを確認してください。詳しくは、「CLIによるWindows仮想マシンの作成」を参照してください。
インストール中：
XenServer VM Toolsを初めてインストールするときに、この構成を指定します：
管理エージェントのみによる自動アップデートの設定
管理エージェントでは、自身とI/Oドライバーの両方のアップデートを構成できます。この構成を使用する場合、仮想マシンはWindows Updateを通じてI/Oドライバーをアップデートすることはできません。両方のメカニズムがI/Oドライバーのアップデートを試みると、不要なアップデートが行われる可能性があるためです。
Windows仮想マシンにアップデートを適用する前に確認することが所属する組織によって求められる場合は、この方法を選択します。この場合は、管理エージェントをリダイレクトして、内部サーバーからアップデートを取得する必要もあります。
-
（オプション）管理エージェントのアップデートをリダイレクトする。
インストール中：
XenServer VM Toolsを初めてインストールするときに、この構成を指定します：
管理エージェントのアップデート
XenServerでは、新しいWindows仮想マシンおよび既存のWindows仮想マシンの両方で、管理エージェントを自動的にアップデートできます。XenServerは、デフォルトで管理エージェントの自動アップデートを許可します。ただし、管理エージェントが自動的にI/Oドライバーをアップデートすることは許可しません。Windows向けXenServer VM Toolsのインストール中、管理エージェントのアップデート設定をカスタマイズできます。管理エージェントの自動アップデートはシームレスに行われ、仮想マシンを再起動しません。仮想マシンの再起動が必要なシナリオでは、必要なアクションをユーザーに通知するメッセージが仮想マシンの［コンソール］タブに表示されます。
Windows仮想マシンがインターネットに接続できる場合、管理エージェントのアップデートを自動的に取得できます。
CLIを使用した自動アップデートの管理
XenServerでは、I/Oドライバーや管理エージェントの自動アップデートの管理にコマンドラインを使用できます。次の表の引数を指定してmsiexec.exeを実行して、I/Oドライバーや管理エージェントを自動でアップデートするかどうかを指定できます。msiexec.exeを使用してWindows向けXenServer VM Toolsをインストールする方法については、「サイレントインストール」を参照してください。
注：
PVSまたはMCSを使用して管理される仮想マシンでは、Citrix Virtual Desktops VDAが存在し、マシンが非永続であることがレポートされている場合、自動アップデートは自動的にオフになります。
| 引数 | 値 | 説明 |
|---|---|---|
| ALLOWAUTOUPDATE | YES/NO | 管理エージェントの自動アップデートを許可/禁止 |
| ALLOWDRIVERINSTALL | YES/NO | Windows向けXenServer VM ToolsインストーラーによるI/Oドライバーのインストールを許可/禁止 |
| ALLOWDRIVERUPDATE | YES/NO | 管理エージェントが自動的にI/Oドライバーをアップデートすることを許可/禁止 |
| IDENTIFYAUTOUPDATE | YES/NO | 当社に匿名の使用状況情報を送信する自動アップデートメカニズムを許可/禁止 |
管理エージェントのアップデートを有効にする
仮想マシンごとに管理エージェントの自動アップデートを無効にするには：
-
仮想マシンで、コマンドプロンプトを管理者として開きます。
-
次のコマンドを実行します：
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-->
管理エージェントのアップデートを無効にする
仮想マシンごとに管理エージェントの自動アップデートを無効にするには、以下のコマンドを実行します：
-
仮想マシンで、コマンドプロンプトを管理者として開きます。
-
次のコマンドを実行します：
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サーバーにリダイレクトしてからインストールできます。このリダイレクトより、アップデートが仮想マシンに自動的にインストールされる前にレビューできます。
管理エージェントは、アップデートファイルを使用して利用可能な更新に関する情報を取得します。このアップデートファイルの名前は、使用する管理エージェントのバージョンによって異なります：
- 管理エージェント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。
管理エージェントのアップデートをリダイレクトするには、次の手順を実行します：
-
アップデートファイルをダウンロードします。
-
アップデートファイルで参照されている管理エージェントのMSIファイルをダウンロードします。
-
仮想マシンがアクセスできる内部WebサーバーにMSIファイルをアップロードします。
-
アップデートファイルを更新して、内部WebサーバーのMSIファイルをポイントするようにします。
-
アップデートファイルをWebサーバーにアップロードします。
自動アップデートも、仮想マシンごとやプールごとにリダイレクトできます。仮想マシンごとにアップデートをリダイレクトする手順は、以下のとおりです。
-
仮想マシンで、コマンドプロンプトを管理者として開きます。
-
コマンドを実行する
reg.exe ADD HKLM\SOFTWARE\XenServer\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-->
I/Oドライバーのアップデート
I/Oドライバーは、Windows Updateを通じて、または管理エージェントを使用してアップデートできます。自動アップデートをオフにして、I/Oドライバーのアップデートを手動にするよう管理することもできます。
それぞれのI/Oドライバー（xennet、xenvif、xenvbd、xeniface、xenbus）には独自のバージョンがあります。最新バージョンについて詳しくは、「新機能」を参照してください。
I/OドライバーでWindows Update経由のアップデートを設定する
I/Oドライバーのアップデートは、次の場合、Microsoft Windows Updateから自動的に入手できます：
-
仮想マシンでWindows Updateが有効になっている
-
仮想マシンがインターネットにアクセスできる、またはWSUSプロキシサーバーに接続できる
-
Windows ServerのCoreバージョンを実行していない。Windows Server Coreでは、I/OドライバーのインストールまたはアップデートにWindows Updateを使用できません。
XenCenterの ［全般］ タブの ［仮想化の状態］ では、仮想マシンがWindows Updateからアップデートを受け取ることができるかどうかを指定します。Windows UpdateからI/Oドライバーのアップデートを受け取るメカニズムは、デフォルトではオンになっています。Windows UpdateからI/Oドライバーのアップデートを受け取らない場合は、仮想マシンでWindows Updateを無効にするか、グループポリシーを指定します。
Windows Update経由のI/Oドライバーのアップデートを無効にする
XenCenterの ［全般］ タブの ［仮想化の状態］ では、仮想マシンがWindows Updateからアップデートを受け取ることができるかどうかを指定します。Windows UpdateからI/Oドライバーのアップデートを受け取るメカニズムは、デフォルトではオンになっています。
既にWindows仮想マシンが存在する場合、Windows UpdateからI/Oドライバーのアップデートを受け取らないためには、グループポリシーを指定します。
新しいWindows仮想マシンの場合、仮想マシン作成時に仮想マシンにフラグを設定することで、Windows UpdateからI/Oドライバーをアップデートできないようにします。詳しくは、「Citrix Provisioningターゲットまたはreset-on-bootマシンの設定」 および「CLIによるWindows仮想マシンの作成」を参照してください。
管理エージェントによるI/Oドライバーのアップデートを設定する
Windows向けXenServer VM Toolsのインストール中、管理エージェントによるI/Oドライバーの自動アップデートを指定できます。Windows向けXenServer VM Toolsのインストールプロセスが完了してからこの設定をアップデートする場合は、次の手順を実行します：
-
仮想マシンで、コマンドプロンプトを管理者として開きます。
-
次のコマンドを実行します：
reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate /t REG_SZ /v \ InstallDrivers /d YES <!--NeedCopy-->
管理エージェントによるI/Oドライバーのアップデートを停止する
管理エージェントがI/Oドライバーをアップデートできないようにする場合は、次の手順を実行します：
-
仮想マシンで、コマンドプロンプトを管理者として開きます。
-
次のコマンドを実行します：
reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate /t REG_SZ /v \ InstallDrivers /d NO <!--NeedCopy-->
自動での再起動
要求されたすべての仮想マシンの再起動が、更新の一部として完了したことを確認してください。複数回の再起動が必要になる場合があります。要求された再起動がすべて完了していないと、予期しない動作が発生する可能性があります。
デバイスマネージャーまたは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コマンドを参照してください。
レジストリエディターを使用して自動再起動を設定する
- Windowsのスタートメニューからレジストリエディターを開き、キー
HLKM\System\CurrentControlSet\services\xenbus_monitor\Parametersに移動します。 -
Autorebootという名前のREG_DWORDタイプの新しいサブキーを作成します。 -
Autorebootの値を整数に設定します（例：3）。
その他の設定とクエリ
I/Oドライバーバージョンを確認する
仮想マシンにインストールされているI/Oドライバーのバージョンを確認するには、次の手順に従います。
-
C:\Windows\System32\driversにアクセスします。 -
一覧からドライバーを見つけます。
-
ドライバーを右クリックして ［プロパティ］ を選択し、次に ［詳細］ を選択します。
［ファイルのバージョン］ フィールドには、仮想マシンにインストールされているドライバーのバージョンが表示されます。
管理エージェントバージョンの確認
仮想マシンにインストールされている管理エージェントのバージョンを確認するには、次の手順に従います。
-
C:\Program Files\XenServer\XenToolsにアクセスします。 -
一覧から
XenGuestAgentを右クリックして ［プロパティ］ を選択し、次に ［詳細］ を選択します。［ファイルのバージョン］ フィールドには、仮想マシンにインストールされている管理エージェントのバージョンが表示されます。
匿名の使用情報を設定する
Windows向けXenServer VM Toolsのインストール中に、匿名の使用状況情報をCloud Software Group, Inc.に送信するかどうかを指定できます。Windows向けXenServer VM Toolsのインストール プロセスの完了後にこの設定をアップデートしたい場合は、次の手順を実行します：
-
仮想マシンで、コマンドプロンプトを管理者として開きます。
-
次のコマンドを実行します：
reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate REG_SZ /v \ IDENTIFYAUTOUPDATE /d YES/NO <!--NeedCopy-->
Windows向けXenServer VM Toolsのトラブルシューティング
XenServer VM Toolsの診断情報を取得するツールxtbugtoolが利用可能です。詳しくは、「仮想マシンの問題のトラブルシューティング」を参照してください。
XenServer VM Toolsのアンインストール
Windows仮想マシンからXenServer VM Toolsを削除することは推奨しません。Windows仮想マシンを完全にサポートするには、これらのツールが必要です。これらを削除すると、予期しない動作が発生する可能性があります。XenServer VM Toolsを手動でアンインストールするのは、他に手段がない場合に限ります。
標準アンインストール
XenServer VM Toolsの標準的なアンインストールを行うには、Windowsの ［プログラムの追加と削除］ 機能を使用できます：
- 開始する前に、仮想マシンのスナップショットを作成します。
- Windows仮想マシンで、［プログラムの追加と削除］ に移動します。
- XenServer VM Toolsを選択し、［アンインストール］ をクリックします。
- 仮想マシンを再起動します。
uninstall.exeコマンド
Windowsの ［プログラムの追加と削除］ 機能を使用してXenServer VM Toolsをアンインストールすると、<tools-install-directory>\uninstall.exeファイルが呼び出されてアンインストール操作が実行されます。代わりに、管理者権限を使用して、PowerShellターミナルまたはコマンドプロンプトからこのコマンドを呼び出すこともできます。
- 開始する前に、仮想マシンのスナップショットを作成します。
- 管理者として、コマンドプロンプトまたはPowerShellターミナルを開きます。
- コマンド
<tools-install-directory>\uninstall.exeを実行します。 - 仮想マシンを再起動します。
コマンドオプション
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ドライバーがインストールされる前に状態に仮想マシンをリセットします。ツールを新しいバージョンにアップグレードするときに問題が発生した場合、または新しいツールセットを仮想マシンにインストールするためにクリーンな状態にする必要がある場合は、このユーティリティを使用します。
- 開始する前に、仮想マシンのスナップショットを作成します。
- 管理者として、コマンドプロンプトまたはPowerShellターミナルを開きます。
-
<tools-install-directory>\uninstall.exe purge verboseのコマンドを実行します - 仮想マシンを再起動します。
このコマンドを使用した後は、以前のバージョンの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およびC:\Program Files\XenServer\XenToolsから削除します。
-
- その他：
-
［プログラムの追加と削除］ で古いエントリを削除します。このアクションは、
cleanupコマンドラインオプションを実行した場合と同じです。 - InstallAgentの古い状態情報の一部をクリアします。
- 上位フィルターから
xenfilt.sysを削除します。この変更により、xenfilt.sysがドライバーノードにロードされなくなります。 -
unplugキーを削除すると、再起動したとき、仮想マシンがエミュレートされたデバイスに戻ります。 - StorNvmeのStartOverrideを削除します。この変更により、起動時に
stornvme.sysが強制的に起動され、エミュレートされたNVMe（UEFI）起動デバイスが機能できるようになります。
-
［プログラムの追加と削除］ で古いエントリを削除します。このアクションは、
新機能
Windows向けXenServer VM Toolsのバージョンは、XenServerのバージョンとは関係なく更新されます。Windows向けXenServer VM Toolsが、仮想マシンと、仮想マシンの作成に使用するテンプレートの両方で、定期的に最新バージョンに更新されていることを確認してください。
Windows向けXenServer VM Toolsの最新バージョンは、XenServerダウンロードページから入手できます。
Windows向けXenServer VM Tools 9.3.3
2024年6月4日リリース
このツールセットには、次のコンポーネントバージョンが含まれています：
- インストーラー：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
9.3.3で解決された問題
このリリースには、次の問題の修正が含まれています：
- 仮想マシンに大きな負荷がかかっている場合、管理エージェントがManagementExceptionでクラッシュすることがあります。
- Windows 2022 Serverでは、単一の仮想CPUがCPUを100%消費する可能性があります。その結果、サーバーが応答しなくなります。
- OpenVSwitchネットワークとVLANタグ付きイーサネットフレームを使用するプールでホストされているWindows仮想マシンでは、ネットワーク接続が不安定になる可能性があります。
以前のリリース
9.3.2
2023年11月27日リリース
このリリースでは、Citrix VM Toolsの名称がXenServer VM Toolsに変更されます。
このツールセットには、次のコンポーネントバージョンが含まれています：
- インストーラー：9.3.2
- 管理エージェント：9.2.2.435
- xenbus：9.1.7.80
- xeniface：9.1.8.69
- xennet：9.1.5.51
- xenvbd：9.1.6.58
- xenvif：9.1.10.83
このリリースでは、次の機能の強化も含まれています：
-
uninstall.exeコマンドの強化。 - XenServerのバージョンとWindowsオペレーティングシステムがサポートしている場合に、一部のWindows仮想マシンが最大64個の仮想CPUを使用できるようにするための変更。
このリリースには、次の問題の修正が含まれています：
- 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
このリリースには、以下の改善点が含まれています：
-
purgeパラメーターを含む、uninstall.exeユーティリティの改善。詳しくは、「XenServer Toolsのアンインストール」を参照してください。 - XenServer VM Toolsインストーラーの全般的な改善。
- レジストリキーの文字列処理の全般的な改善。
このリリースには、次の問題に対する修正が含まれています：
- 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。
ツールを最新バージョンにアップデートすると、これらの以前の名前はいずれも表示されなくなります。インストールされたプログラムにはXenServer VM 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）（操作の失敗）要求した操作が失敗しました。」というエラーメッセージが返されるという問題が発生する場合があります。