Workspace Environment Management

エージェント

エージェントのインストールと構成

注:

  • Workspace Environment Management (WEM) エージェントをインフラストラクチャサーバーにインストールしないでください。
  • 同じマシンに WEM エージェントと管理コンソールをインストールしないでください。
  • 管理コンソールからWEMのアプリケーションショートカットとしてCitrix StoreFront ストアに公開されているリソースを割り当てる場合は、管理コンソールとエージェントホストマシンにWindows向けCitrix Workspaceアプリがインストールされていることを確認してください。詳細については、「 システム要件」を参照してください

手順 1: グループポリシーを構成する (オプション)

必要に応じて、 Citrix Workspace 環境管理エージェントホスト構成 管理テンプレートを使用して、エージェントのグループポリシーを構成することもできます。WEM インストールパッケージには、このテンプレートが含まれています。テンプレートファイルは、.admx ファイルと言語固有の.adml ファイルに分割されます。ドメインコントローラーでグループポリシーを構成することをお勧めします。

エージェント・ホスト構成ポリシーを追加するには、次の手順を実行します。

  1. WEM インストールパッケージで提供されている Agent Group Policies フォルダを WEM ドメイン Controller にコピーします。
  2. .admx ファイルを追加します。

    1. [ エージェントグループポリシー] > [ADMX] フォルダに移動します。
    2. 2つのファイル(Citrix Workspace 環境管理エージェントのホスト構成.adm *x とCitrixbase.admx*)をコピーします。
    3. < C:\Windows >\ PolicyDefinitions フォルダに移動し、ファイルを貼り付けます。
  3. .adml ファイルを追加します。

    1. [ エージェントグループポリシー] > [ADMX] > [en-US] フォルダに移動します。
    2. 2つのファイル(Citrix Workspace 環境管理エージェントのホスト構成.admlCitrixbase.adml)をコピーします。
    3. < C:\Windows >\ PolicyDefinitions\ en-US フォルダに移動し、ファイルを貼り付けます。

グループポリシー管理エディター を使用して、次の設定で GPO を構成します。

グループポリシー管理エディター

インフラストラクチャ・サーバ。WEM インフラストラクチャサーバのアドレス。インフラストラクチャサービスがインストールされているマシンの名前または IP アドレスを入力します。

エージェントサービスポート。エージェントがインフラストラクチャ・サーバに接続するポート。エージェントサービスポートは、インフラストラクチャサービスの設定時にエージェントサービスポートに設定したポートと同じである必要があります。指定しない場合、ポートのデフォルトは 8286 です。

キャッシュ同期ポート。(Workspace Environment Management 1909 以前に適用できます。ワークスペース環境管理 1912 以降* では、 *キャッシュされたデータ同期ポートに置き換えられました。)エージェントキャッシュの同期プロセスが、インフラストラクチャサーバーとエージェントキャッシュを同期するためにインフラストラクチャサービスに接続するポート。キャッシュ同期ポートは、インフラストラクチャサービスの構成中にキャッシュ同期ポート用に構成したポート([WEM Infrastructure Service Configuration] > [ネットワーク設定])と同じである必要があります。ポートのデフォルトは 8285 で、 AgentCacheSyncPort コマンドライン引数に対応します。

キャッシュされたデータ同期ポート。(Workspace Environment Management 1912 以降に適用可能。ワークスペース環境管理 1909 以前の キャッシュ同期ポート を置き換えます。)エージェントキャッシュの同期プロセスが、インフラストラクチャサーバーとエージェントキャッシュを同期するためにインフラストラクチャサービスに接続するポート。キャッシュされたデータ同期ポートは、インフラストラクチャサービスの構成中にキャッシュされたデータ同期ポート ([WEM インフラストラクチャサービスの構成] > [ネットワーク設定]) 用に構成したポートと同じである必要があります。ポートのデフォルトは 8288 で、C achedDataSyncPort コマンドライン引数に対応します。または、WEM エージェントのサイレントインストールのコマンドラインオプションを使用してポートを指定することもできます。次に例を示します:

  • citrix_wem_agent_bundle.exe/quiet cachedDataSyncPort=9000

Citrix クラウドコネクタ。オンプレミスバージョンの WEM には適用されません。状態は [ 未構成] のままにします

エージェントプロキシの設定。オンプレミスバージョンの WEM には適用されません。状態は [ 未構成] のままにします

VuemAppcmd余分な同期遅延.エージェントアプリケーションランチャー(VuemAppcmd.exe)がCitrix Virtual Apps and Desktops s公開リソースを起動するまでの待機時間を指定します。この設定により、必要なエージェント作業が最初に完了します。指定しない場合、遅延間隔はデフォルトで 0 になります。

手順 2: エージェントをインストールする

重要:

.NET Framework はエージェントのインストール中に自動的にインストールできますが、エージェントをインストールする前に手動でインストールすることをお勧めします。そうしないと、エージェントのインストールを続行するためにコンピュータを再起動する必要があり、完了に時間がかかることがあります。

Citrix Workspace 環境管理エージェントのセットアップは、ユーザー環境 で実行できます。コマンド・ラインを使用してエージェントをインストールすることもできます。デフォルトでは、エージェントはオペレーティングシステムに応じて、次のいずれかのフォルダーにインストールされます。

  • C:\Program Files (x86)\Citrix\Workspace Environment Management Agent (64-bit OS)
  • C:\Program Files\ Citrix\Workspace Environment Management Agent (32-bit OS)

エージェントを対話形式でインストールするには、次の手順を実行します。

  1. マシンで Citrix Workspace 環境管理エージェントSetup.exe を実行します。
  2. [ライセンス条項 に同意します] を選択し、[ **インストール] をクリックします。**
  3. [ようこそ] ページで、[ 次へ] をクリックします

    注:

    [ようこそ] ページが表示されるまでに時間がかかる場合があります。この遅延は、必要なソフトウェアが見つからない、バックグラウンドでインストールされている場合に発生します。

  4. [保存先フォルダ] ページで、[ 次へ] をクリックします

    • デフォルトでは、インストール先フォルダーフィールドにはデフォルトのフォルダーパスが自動的に設定されます。エージェントを別のフォルダにインストールする場合は、[ 変更 ] をクリックしてフォルダに移動し、[ 次へ] をクリックします
    • WEM エージェントを既にインストールしている場合は、インストール先フォルダーフィールドに既存のインストールフォルダーパスが自動的に入力されます。
  5. [展開の種類] ページで、展開の種類を選択し、[ 次へ] をクリックします。この場合は、[ オンプレミス展開] を選択します

    WEM エージェントのインストール 01

  6. [インフラストラクチャサービスの構成] ページで、エージェントが接続するインフラストラクチャサービスを指定し、[ 次へ] をクリックします

    • 設定をスキップします。グループポリシーを使用して設定を既に構成している場合は、このオプションを選択します。
    • インフラストラクチャサービスを構成します。インフラストラクチャサービスの FQDN または IP アドレスを入力して、インフラストラクチャサービスを構成できます。
    • エージェントサービスポート。デフォルトでは、値は 8286 です。
    • キャッシュされたデータ同期ポート。デフォルトでは、値は 8288 です。

    WEM エージェントインストール 02

  7. [詳細設定]ページで、エージェントの詳細設定を構成し、[ 次へ]をクリックします

    • 代替キャッシュの場所(オプション)。エージェントキャッシュの代替場所を指定できます。[参照] をクリックして、該当するフォルダに移動します。
    • VUEMAPPCMD 余分な同期遅延(オプション)。エージェントアプリケーションランチャー (VuemAppcmd.exe) が公開リソースを開始するまでの待機時間を指定できます。この遅延を設定すると、必要なエージェント作業が最初に完了します。デフォルト値は 0 です。

    注:

    追加の同期間遅延間隔に入力する値は、0 以上の整数である必要があります。

    WEM エージェントのインストール 03

  8. [インストールの準備完了] ページで、[ インストール] をクリックします
  9. [ 完了 ] をクリックして、インストールウィザードを終了します。

または、WEM エージェントのサイレントインストールを選択することもできます。これを行うには、次のコマンドラインを使用します。

  • 「Citrix Workspace 環境管理エージェントSetup.exe」/クワイエットクラウド=0

ヒント:

ログファイルを参照して、エージェントのインストールのトラブルシューティングを行うこともできます。既定では、インストール中に発生したすべてのアクションを記録するログファイルは「%TEMP%」で作成されます。/log log.txt コマンドを使用して、ログファイルを保存する特定の場所を指定できます。

コマンドラインオプションを使用して、カスタム引数を指定することもできます。これにより、インストールプロセス中にエージェントとシステム設定をカスタマイズできます。詳細については、「知 っておきましょう」を参照してください

インストール後、エージェントは Citrix WEMエージェントホストサービス (以前のNorskale エージェントホストサービス)および Citrix WEMエージェントユーザーログオンサービスとして実行されます。エージェントは、アカウント LocalSystem として実行されます。このアカウントの変更はサポートされていません。サービスには、ローカルシステムの** アクセス許可として **ログオンする必要があります。

手順 3: エージェントサービスキャッシュを構築する (オプション)

デフォルトでは、エージェントサービスキャッシュは、エージェントを初めて実行すると構築されます。エージェントの実行前に、エージェントサービスキャッシュを構築するように選択できます。これは、WEMエージェント・ホストをプリインストール・ソフトウェアとして含むイメージを構築する場合に便利です。

エージェントサービスキャッシュを構築または再構築するには、コマンドラインを使用してエージェントインストールフォルダ* で *AgentCacheUtility.exe を実行します。実行可能ファイルは、次のコマンドライン引数を受け入れます。

  • -help:許可された引数のリストを表示します
  • -refreshcache または -r:キャッシュビルドまたはリフレッシュをトリガーします

手順 4: コンピュータを再起動してインストールを完了する

ヒント

エージェント実行可能ファイルは、「エージェント設定」および「システム設定」セクションで説明されているように、カスタム引数を受け入れます。

エージェントの設定

WEM エージェントの設定には、次のものがあります。

  • エージェントロケーション。エージェントのインストール場所を指定できます。有効なフォルダパスを指定します。

  • エージェントキャシェロケーション。エージェントキャッシュの代替場所を指定できます。構成されている場合、エージェントローカルキャッシュファイルは、エージェントインストールフォルダーではなく、指定された場所に保存されます。

  • エージェントキャッシュ同期ポート。エージェントキャッシュの同期処理がインフラストラクチャサービスに接続し、エージェントキャッシュをインフラストラクチャサーバーと同期させるポートを指定できます。

  • エージェントサービスポート。エージェントがインフラストラクチャサーバーに接続するポートを指定できます。

  • インフラストラクチャ・サーバ。インフラストラクチャサービスが実行されているインフラストラクチャサーバーの FQDN または IP アドレスを指定できます。

  • VuemAppcmdDelay.エージェントアプリケーションランチャー(VuemAppcmd.exe)がCitrix Virtual Apps and Desktops s公開リソースを起動するまでの待機時間を指定できます。デフォルト値は 0(ミリ秒)です。追加の同期間遅延間隔に入力する値は、0 以上の整数である必要があります。

次の点に注意してください。

  • コマンドラインで設定を構成する場合、WEM エージェントインストーラーは構成済みの設定を使用します。

  • コマンドラインから設定を構成しない場合で、以前に構成した設定がある場合、インストーラーは以前に構成した設定を使用します。

  • コマンドラインで設定を構成せず、以前に構成した設定がない場合、インストーラーはデフォルト設定を使用します。

システム設定

エージェントホストマシンに関連するシステム設定には、次のものがあります。

  • GPNetworkStartタイムアウトポリシー値。インストール中に作成された GPNetworkStartTimeoutPolicyValue レジストリキーの値を秒単位で構成できます。この引数は、ログオン時のポリシー処理中に、グループポリシーがネットワーク可用性通知を待機する時間を指定します。引数には、1(最小)から 600(最大)の範囲の任意の整数を指定できます。デフォルトでは、この値は 120 です。

  • SyncForeGroundPolicy。エージェントのインストール時に SyncForeGroundPolicy レジストリ値を構成できます。このポリシー設定は、グループポリシー処理を同期するかどうかを決定します。受け入れられる値:0、1。値が設定されていない場合、または値を0に設定した場合、Citrix WEMエージェントユーザーログオンサービスはログオンを遅延させず、ユーザーのグループポリシー設定はバックグラウンドで処理されます。この値を1に設定すると、Citrix WEMエージェントユーザーログオンサービスは、ユーザーのグループポリシー設定の処理が完了するまでログオンを遅延させます。デフォルトでは、この値はインストール中に変更されません。

    重要:

    グループポリシー設定がバックグラウンドで処理される場合、すべてのポリシー設定が処理される前に Windows シェル (Windows エクスプローラ) が起動することがあります。したがって、一部の設定は、ユーザーが初めてログオンしたときに有効にならない場合があります。ユーザーが初めてログオンしたときにすべてのポリシー設定を処理する場合は、値を 1 に設定します。

  • WaitForNetwork.インストール中に作成された WaitForNetwork レジストリキーの値を秒単位で構成できます。この引数は、ネットワークが完全に初期化され、利用可能になるまでエージェントホストが待機する時間を指定します。引数には、0(最小)~ 300(最大)の範囲の任意の整数を指定できます。デフォルトでは、この値は 30 です。

上記の 3 つのキーにより、Windows ログオン画面が表示される前に、WEM エージェントサービスが開始されます。3 つのキーはすべて、インストール** 中に HKEY_LOCAL_MACHINE\ ソフトウェア\ マイクロソフト\ Windows NT\ 現在のバージョン\ Winlogon の下に作成されます。また、キーを使用すると、ユーザー環境がログオン前にインフラストラクチャサーバーアドレス GPO を受信できます。Active Directory サーバーまたはドメインコントローラサーバーの応答が遅いネットワーク環境では、ログオン画面が表示されるまでの処理時間が余分になることがあります。影響を与えるには、 **GPNetworkStartTimeoutPolicyValue キーの値を 30 以上に設定することをお勧めします。

  • [ サービス] [パイプタイムアウト]。ServiceSpipeTimeout レジストリキーの値を構成できます。キーは、インストール中に HKEY_LOCAL_MACHINE\ システム\ 現在のコントロールセット\ コントロールの下に作成されます。このレジストリキーは、サービスコントロールマネージャーが WEM エージェントサービスの状態をレポートできるようにする前に遅延を追加します。この遅延により、ネットワークが初期化される前にエージェントサービスが起動しなくなるため、エージェントの障害を防ぐことができます。この引数は、ミリ秒単位で任意の値を受け入れます。指定しない場合、デフォルト値の 6000(60 秒)が使用されます。

    注:

    コマンドラインを使用して上記の設定を構成しない場合、WEM エージェントインストーラーはインストール中にこれらの設定を処理しません。

以下のコマンドライン形式を使用して設定を構成できます。

  • 「Citrix Workspace 環境管理エージェントセットアップ.exe」<キー=値>

次に例を示します:

  • WEM エージェントのサイレントインストールまたはアップグレードの選択
    • 「Citrix Workspace 環境管理エージェントSetup.exe」/クワイエットクラウド=0
  • ユーザーログオンネットワークの待機時間を 60 秒に設定する
    • 「Citrix Workspace 環境管理エージェントSetup.exe」WaitForNetwork=60

エージェント