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

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

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

• 仮想マシンのエージェントの更新（「専用デスクトップ仮想マシンでの Horizon Agent ソフトウェアの更新」を参照）が継続して失敗する場合。
• オペレーティング システムの更新またはデバイス ドライバの問題が原因でアンインストールおよび再インストールするエージェントがある場合。

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

手順

1. Horizon Universal Console で、[プール グループ] ページに移動します。

2. [仮想マシン] を選択します。

3. リストから 1 台以上の仮想マシンを選択します。

4. [エージェント] > [再インストール] の順に選択します。

   エージェントの再インストール ページが開きます。ページに情報の入力を求めるプロンプトが表示されます。プロンプトは、1 台の仮想マシンを選択したか、複数の仮想マシンを選択したかによって異なります。

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

     

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

     

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

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

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

次の手順

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

。