専用デスクトップ仮想マシンへの Horizon Agent ソフトウェアの再インストール

再インストール機能によって、仮想マシンから既存のエージェントをアンインストールし、最新のエージェントソフトウェアを再インストールできます。再インストール機能を使用すると、強制インストールによるエージェントのアップデート失敗のリカバリメカニズムが提供されます。また、次のユースケースで説明するように、エージェントソフトウェアをアンインストールして再インストールする必要がある特別な状況で発生します。

次の使用事例は、エージェントを再インストールするタイミングを示しています。

専用デスクトップ仮想マシンでの Horizon Agent ソフトウェアの更新で説明されているように、仮想マシン上のエージェントの更新が一貫して失敗する場合。
オペレーティングシステムの更新またはデバイスドライバの問題が原因でアンインストールおよび再インストールするエージェントがある場合。

注：次世代環境に、まだ完了していない第 1 世代の移行がある場合、システムではこのエージェントの再インストール手順を実行できません。 [エージェント] > [再インストール] の順にクリックすると、移行の完了に関するメッセージが表示されます。

手順

Horizon Universal Console で、[プールグループ] ページに移動します。
[仮想マシン] を選択します。
リストから 1 台以上の仮想マシンを選択します。
[エージェント] > [再インストール] の順に選択します。
エージェントの再インストールページが開きます。ページに情報の入力を求めるプロンプトが表示されます。プロンプトは、1 台の仮想マシンを選択したか、複数の仮想マシンを選択したかによって異なります。

単一の仮想マシンが選択された [エージェントの再インストール] ページ

複数の仮想マシンが選択された [エージェントの再インストール] ページ

[エージェントの再インストール] フォームに入力し、 [再インストール] をクリックします。

該当する次のプロンプトに適切な応答を入力します。 [コマンドライン引数] は、単一のエージェントを選択したか、複数のエージェントを選択したかに関係なく適用されます。他のすべてのオプションは、複数のエージェントを選択した場合にのみ適用されます。


オプション	説明
[アクティブなユーザーを含む仮想マシンのスキップ]	アクティブなセッションまたは切断されたセッションの再インストールHorizon Agentをスキップする場合に選択します。このオプションが選択されていない場合、再インストールの開始時に仮想マシンにログインしたユーザーは 5 分間の警告が表示されてから強制的にログオフされます。
[ジョブのタイムアウト]	システムがエージェントの再インストールを自動的に試行し続ける期間を設定します。特定の期間にのみ再インストールを実行する場合は、複数のテンプレートと仮想マシンを選択している場合でも、短い期間を設定できます。仮想マシンの状態、およびその他の待機時間と実行中の再試行に応じて、仮想マシンの 1 つのバッチに 20 ～ 60 分かかることがあります。たとえば、600 台を超える仮想マシンがあり、30 台の仮想マシンを同時に再インストールする場合、期間は次のように計算できます。バッチ数：600/30 = 20 バッチジョブのタイムアウト：20*60 = 1200 分ジョブのタイムアウトを 1200 分に設定します。これは、通常の再インストールの実行に必要な期間よりもはるかに長くなります。注：再インストール中にエラーが発生した仮想マシンの再インストールは再試行されません。
[同時実行]	システムがエージェントの再インストールを同時に試行する仮想マシンの数に制限を設定します。この設定は、[障害のしきい値] 設定と並行して機能します。[同時実行] 設定は [障害のしきい値] 設定以下にすることが理想的です。
[障害のしきい値]	再インストールプロセスが停止となるまでに許容される、エージェントの再インストールが失敗する仮想マシンの数。このしきい値の設定により、大量の障害が発生するのを防ぎます。仮想マシンエージェントの再インストールに失敗したことが原因で再インストールプロセスが停止した場合、設定した [障害のしきい値] よりも多くの障害が発生した仮想マシンが表示されることがあります。障害の数を [障害のしきい値] 設定で指定した数よりも少なくする必要がある場合は、[同時実行] の値を [1] に設定します。これは、一度に 1 台の仮想マシンを再インストールすることになるため、エージェントの再インストールプロセスに長い時間がかかることを意味します。最適な結果を得るには、[同時実行] および [障害のしきい値] を適切に設定することをお勧めします。
[コマンドライン引数]	[コマンドライン引数] テキストボックスに、この再インストールに関連する可能性のあるコマンドラインオプションを追加します。

次のタスク

エージェントの再インストールプロセスはバックグラウンドで実行されます。プロセスの進行状況は、[アクティビティログ] ページで確認できます。[アクティビティログ] ページからの管理者とエンドユーザーのアクティビティの監視を参照してください。

。