インフラストラクチャサービス

インフラストラクチャサービスをインストールする

• .\Citrix Workspace Environment Management インフラストラクチャサービス.exe /quiet BrokerLocation="C:\test\Infrastructure Services" /log "C:\test\test.log"
• /quiet BrokerLocation="C:\test\Infrastructure Services" /log "C:\test\test.log"
  • /quiet。サイレントモードを示します。
  • /log。ログファイルの場所を示します。
  • BrokerLocation。インフラストラクチャサービスのインストールパスを示します。

サービスプリンシパル名を作成する

• Windows認証または負荷分散を使用しない場合は、次のコマンドを使用します。
  • setspn -C -S Norskale/BrokerService [hostname]
  ここで、hostname はインフラストラクチャサーバーの名前です。
• Windows認証または負荷分散（Windows認証が必要）を使用する場合は、次のコマンドを使用します。
  • setspn -U -S Norskale/BrokerService [accountname]
  ここで、accountname はWindows認証に使用されているサービスアカウントの名前です。

グループ管理サービスアカウント

1. 既存のgMSAがすでにある場合は、次の操作を行います。
   1. 次のコマンドを使用して、Citrix WEM SPNをアカウントにバインドします。
      • setspn -C -S Norskale/BrokerService [gMSA]$
      ここで、gMSA はgMSAアカウントの名前です。
   2. 次のコマンドを使用して、関連するマシンをアカウントに追加します。
      • Set-ADServiceAccount -Identity [gMSA] -PrincipalsAllowedToRetrieveManagedPassword [hostname]
      ここで、 はインフラストラクチャサーバーの名前です。
2. gMSA をお持ちでない場合は、ドメインコントローラーに移動して作成し、Citrix WEM SPN をそれにバインドします。次のコマンドを使用します。
   • New-ADServiceAccount [gMSA] -DNSHostName [hostname 1] -PrincipalsAllowedToRetrieveManagedPassword [hostname 2], [hostname 3] -KerberosEncryptionType RC4, AES128, AES256 -ServicePrincipalNames Norskale/BrokerService
   ここで、 は DNS サーバーの名前です。
   ここで、、 はインフラストラクチャサーバーの名前です。
   gMSA の作成の詳細については、<https://docs.microsoft.com/ja-jp/windows-server/security/group-managed-service-accounts/getting-started-with-group-managed-service-accounts> を参照してください。
3. gMSA を手動で構成します。
   1. アカウントがデータベースにアクセスできるようにします。
      1. プライマリ SQL Server で、 > に移動し、 を右クリックして、 を選択します。
      2. ウィンドウで、 をクリックします。
      3. ウィンドウで、次のように設定を構成し、 をクリックしてウィンドウを閉じます。
         • 。 のみを選択します。
         • 。 を選択します。
         • オブジェクト名。手順 1 で作成したアカウント名を入力します。
      4. ページで、gMSA を適用するデータベースを選択し、データベースのロールメンバーシップとして db-owner を選択します。
      5. 「Status」ページで、「Grant」と「Enabled」オプションが選択されていることを確認します。
      6. 「OK」をクリックして、「Login - New」ウィンドウを閉じます。
   2. 追加したサービスアカウントを使用して、Citrix WEM Infrastructure Serviceを開始します。
      1. インフラストラクチャサーバーで、Windowsサービスマネージャーを開き、Citrix WEM Infrastructure Serviceを右クリックして、「Properties」を選択します。
      2. 「Log On」ページで、「This account」を選択し、「Browse」をクリックして、手順3の3番目のサブステップで説明されているように設定を構成します。
      3. 「OK」をクリックして、「Citrix WEM Infrastructure Service Properties」ウィンドウを閉じます。
      4. Windowsサービスマネージャーで、Citrix WEM Infrastructure Serviceを再起動します。
      注:
      または、WEM GUIを使用してアカウントを構成することもできます。「WEMデータベースの作成」および「インフラストラクチャサービスの構成」を参照してください。

負荷分散の構成

1. WEMインフラストラクチャサービスがWEMデータベースに接続するためのWindowsインフラストラクチャサービスアカウントを作成します。
2. WEMデータベースを作成するときに、「Use Windows authentication for infrastructure service database connection」オプションを選択し、インフラストラクチャサービスアカウント名を指定します。詳しくは、「Workspace Environment Managementデータベースの作成」を参照してください。
3. 各インフラストラクチャサービスを、SQL認証ではなくWindows認証を使用してSQLデータベースに接続するように構成します。「Enable Windows account impersonation」オプションを選択し、インフラストラクチャサービスアカウントの資格情報を指定します。詳しくは、「インフラストラクチャサービスの構成」を参照してください。
4. WEMインフラストラクチャサービスがインフラストラクチャサービスアカウント名を使用するようにSPNを構成します。詳しくは、「サービスプリンシパル名の作成」を参照してください。
   重要：
   WEM環境を展開する前に、サービスアカウントを使用するかマシンアカウントを使用するかを決定します。WEM環境がすでに展開されている場合、元に戻すことはできません。たとえば、マシンアカウントをすでに使用している状態で受信要求の負荷分散を行いたい場合は、サービスアカウントの代わりにマシンアカウントを使用する必要があります。

5. VIPの背後に配置するインフラストラクチャサーバーの数をカバーする仮想IPアドレス (VIP) を作成します。エージェントがVIPに接続する際、VIPでカバーされているすべてのインフラストラクチャサーバーが対象となります。
6. エージェントホスト構成GPOを構成するときは、インフラストラクチャサーバーの設定を個々のインフラストラクチャサーバーのアドレスではなくVIPに設定します。詳細については、「エージェントのインストールと構成」を参照してください。
7. 管理コンソールとインフラストラクチャサービス間の接続には、セッション永続性が必要です。(エージェントとインフラストラクチャサービス間のセッション永続性は不要です。) 各管理コンソールは、VIPを使用するのではなく、インフラストラクチャサービスサーバーに直接接続することをお勧めします。

Workspace Environment Managementデータベースの作成

1. Database Management Utilityがまだ開いていない場合は、スタートメニューからCitrix>Workspace Environment Management>WEM Database Management Utilityを選択します。
   
2. Create Databaseをクリックし、Nextをクリックします。
   
3. 次のデータベース情報を入力し、Nextをクリックします。
   • サーバーとインスタンス名。データベースがホストされるSQL Serverのアドレス。このアドレスは、インフラストラクチャサーバーから入力されたとおりに到達可能である必要があります。サーバーとインスタンス名は、マシン名、完全修飾ドメイン名、またはIPアドレスとして入力します。完全なインスタンスアドレスは、serveraddress,port\\instancenameとして指定します。ポートが指定されていない場合、デフォルトのSQLポート番号 (1433) が使用されます。
   • データベース名。作成するSQLデータベースの名前。
   注:
   ハイフン (-) やスラッシュ (/) などの特殊文字は、データベース名では使用できません。
   • データファイル: SQL Server上の .mdf ファイルの場所へのパス。
   • ログファイル: SQL Server上の .ldf ファイルの場所へのパス。
   注:
   データベース管理ユーティリティは、データファイルとログファイルのデフォルトの場所についてSQL Serverにクエリを実行できません。これらは、MS SQL Serverのデフォルトインストールにおけるデフォルト値に設定されます。これらの2つのフィールドの値がMS SQL Serverのインストールに対して正しいことを確認してください。そうしないと、データベース作成プロセスが失敗します。
   
4. ウィザードがデータベースの作成に使用できるデータベースサーバーの資格情報を入力し、次へをクリックします。これらの資格情報は、インフラストラクチャサービスがデータベース作成後にデータベースに接続するために使用する資格情報とは独立しています。これらは保存されません。
   統合接続を使用オプションはデフォルトで選択されています。これにより、ウィザードは実行中のIDのWindowsアカウントを使用してSQLに接続し、データベースを作成できます。このWindowsアカウントにデータベースを作成する十分な権限がない場合、十分な権限を持つWindowsアカウントとしてデータベース管理ユーティリティを実行するか、このオプションをクリアして十分な権限を持つSQLアカウントを提供するかのいずれかを選択できます。
   
5. VUEM管理者とデータベースセキュリティの詳細を入力し、次へをクリックします。ここで提供する資格情報は、インフラストラクチャサービスがデータベース作成後にデータベースに接続するために使用されます。これらはデータベースに保存されます。
   • 初期管理者グループ。このユーザーグループは、管理コンソールのフルアクセス管理者として事前設定されています。Workspace Environment Management管理者として設定されたユーザーのみが管理コンソールを使用できます。有効なユーザーグループを指定しないと、ご自身で管理コンソールを使用できなくなります。
   • インフラストラクチャサービスのデータベース接続にWindows認証を使用する。このオプションがクリアされている場合（デフォルト）、データベースはインフラストラクチャサービスがvuemUser SQLユーザーアカウントを使用して接続することを想定します。vuemUser SQLユーザーアカウントはインストールプロセスによって作成されます。これには、SQLインスタンスで混合モード認証が有効になっている必要があります。
   このオプションが選択されている場合、データベースはインフラストラクチャサービスがWindowsアカウントを使用して接続することを想定します。この場合、選択するWindowsアカウントは、SQLインスタンスにすでにログインを持っていてはなりません。つまり、データベースの作成に使用したのと同じWindowsアカウントをインフラストラクチャサービスの実行に使用することはできません。
   gMSAを選択するには、ADユーザーを選択する場合と同じ手順に従います。
   • vuemUser SQLユーザーアカウントのパスワードを設定する。デフォルトでは、vuemUser SQLアカウントは、大文字と小文字、数字、句読点を使用する8文字のパスワードで作成されます。独自のvuemUser SQLアカウントパスワードを入力したい場合（たとえば、SQLポリシーでより複雑なパスワードが必要な場合）は、このオプションを選択します。
   重要：
   • SQL Server Always On 可用性グループに Workspace Environment Management データベースを展開する場合、vuemUser SQL ユーザーアカウントのパスワードを設定する必要があります。
   • ここでパスワードを設定した場合、インフラストラクチャサービスを構成する際に同じパスワードを指定することを忘れないでください。

6. 概要ペインで、選択した設定を確認し、問題がなければデータベースの作成をクリックします。
7. データベースの作成が正常に完了したという通知を受け取ったら、完了をクリックしてウィザードを終了します。
   データベースの作成中にエラーが発生した場合は、インフラストラクチャサービスのインストールディレクトリにあるログファイル「Citrix WEM Database Management Utility Debug Log.log」を確認してください。

インフラストラクチャサービスを構成する

1. スタートメニューから、Citrix>Workspace Environment Management>WEM Infrastructure Service Configuration Utilityを選択します。
2. データベース設定タブで、次の詳細を入力します。
   • データベースサーバーとインスタンス。Workspace Environment ManagementデータベースがホストされているSQL Serverインスタンスのアドレス。これは、インフラストラクチャサーバーから入力されたとおりに到達可能である必要があります。完全なインスタンスアドレスを「serveraddress,port\\instancename」として指定します。ポートが指定されていない場合、デフォルトのSQLポート番号（1433）が使用されます。
   • データベースフェールオーバーサーバーとインスタンス。データベースミラーリングを使用している場合は、ここにフェールオーバーサーバーアドレスを指定します。
   • データベース名。SQLインスタンス上のWorkspace Environment Managementデータベースの名前。
   
3. ネットワーク設定タブで、インフラストラクチャサービスが使用するポートを入力します。
   • 管理ポート。このポートは、管理コンソールがインフラストラクチャサービスに接続するために使用されます。
   • エージェントサービスポート。このポートは、エージェントホストがインフラストラクチャサービスに接続するために使用されます。
   • キャッシュ同期ポート。このポートは、エージェントサービスがキャッシュをインフラストラクチャサービスと同期するために使用されます。
   • WEM監視ポート。
   
4. Advanced Settingsタブで、偽装と自動更新の設定を入力します。
   • Windowsアカウントの偽装を有効にする。デフォルトでは、このオプションはオフになっており、インフラストラクチャサービスは混合モード認証を使用してデータベースに接続します（データベース作成時に作成されたSQLアカウントvuemUserを使用）。代わりに、データベース作成時にWindowsインフラストラクチャサービスアカウントを選択した場合は、このオプションを選択し、接続時にインフラストラクチャサービスが偽装するWindowsアカウントを指定する必要があります。選択するアカウントは、インフラストラクチャサーバーのローカル管理者である必要があります。
     gMSAを選択するには、ADユーザーを選択する場合と同じ手順に従います。
   • vuemUser SQLユーザーアカウントのパスワードを設定する。データベース作成時にvuemUser SQLユーザー用に構成されたカスタムパスワードをインフラストラクチャサービスに通知できます。このオプションは、データベース作成時に独自のパスワードを指定した場合にのみ有効にしてください。
   • インフラストラクチャサービスのキャッシュ更新遅延。インフラストラクチャサービスがキャッシュを更新するまでの時間（分）。インフラストラクチャサービスがSQLに接続できない場合、キャッシュが使用されます。
   • インフラストラクチャサービスのSQL状態監視遅延。インフラストラクチャサービスがSQLサーバーをポーリングする各試行間の時間（秒）。
   • インフラストラクチャサービスのSQL接続タイムアウト。インフラストラクチャサービスがSQLサーバーとの接続を確立しようとするときに、試行を終了してエラーを生成するまでに待機する時間（秒）。
   • デバッグモードを有効にする。有効にすると、インフラストラクチャサービスは詳細ログモードに設定されます。
   • オンラインでもキャッシュを使用する。有効にすると、インフラストラクチャサービスは常にサイト設定をキャッシュから読み取ります。
   • パフォーマンスチューニングを有効にする。接続されているエージェントの数が特定のしきい値（デフォルトでは200）を超えたシナリオでパフォーマンスを最適化できます。その結果、エージェントまたは管理コンソールがインフラストラクチャサービスに接続するまでの時間が短縮されます。
     • ワーカー スレッドの最小数。スレッド プールがオンデマンドで作成するワーカー スレッドの最小数を指定します。ワーカー スレッドの数は30～3000の範囲で設定します。接続されているエージェントの数に基づいて値を決定します。デフォルトでは、ワーカー スレッドの最小数は200です。
     • 非同期I/Oスレッドの最小数。スレッド プールがオンデマンドで作成する非同期I/Oスレッドの最小数を指定します。非同期I/Oスレッドの数は30～3000の範囲で設定します。接続されているエージェントの数に基づいて値を決定します。デフォルトでは、非同期I/Oスレッドの最小数は200です。
   重要：
   この機能は、エージェントまたは管理コンソールがインフラストラクチャサービスから断続的に切断される場合に特に役立ちます。
   注:
   ［パフォーマンスチューニングを有効にする］フィールドで設定した値は、新しい要求が行われたとき、およびスレッドの作成と破棄を管理するアルゴリズムに切り替える前に使用されます。詳しくは、<https://docs.microsoft.com/ja-jp/dotnet/api/system.threading.threadpool.setminthreads?view=netframework-4.8>および<https://support.microsoft.com/en-sg/help/2538826/wcf-service-may-scale-up-slowly-under-load>を参照してください。
   • Google Analyticsを使用してWorkspace Environment Managementの改善に協力する。選択すると、インフラストラクチャサービスは匿名の分析データをGoogle Analyticsサーバーに送信します。
   • Google Analyticsを使用してWorkspace Environment Managementの改善に協力しない。選択すると、インフラストラクチャサービスは匿名の分析データをGoogle Analyticsサーバーに送信しません。
   重要：
   2212以降、Workspace Environment Managementは、インフラストラクチャサービスをホストするマシンの地域に基づいて、選択するオプションを決定します。マシンがヨーロッパ以外の地域にある場合は、最初のオプションが選択されます。マシンがヨーロッパ地域にある場合は、2番目のオプションが選択されます。この動作は、新規インストールにのみ適用されます。
   
5. データベースメンテナンスタブを使用して、データベースメンテナンスを構成できます。
   • スケジュールされたデータベースメンテナンスを有効にする。有効にすると、この設定により、古い統計レコードが定期的にデータベースから削除されます。
   • 統計の保持期間。ユーザーおよびエージェントの統計が保持される期間を決定します。デフォルトは365日です。
   • システム監視の保持期間。システム最適化の統計が保持される期間を決定します。デフォルトは90日です。
   • エージェント登録の保持期間。エージェント登録ログがデータベースに保持される期間を決定します。デフォルトは1日です。
   • 実行時間。データベースメンテナンスアクションが実行される時間を決定します。デフォルトは02:00です。
   ヒント
   ベストプラクティスとして、データベースサイズを削減し、最高のパフォーマンスを実現するために、スケジュールされたデータベースメンテナンスを有効にすることをお勧めします。単一のWEM展開に複数のインフラストラクチャサービスがある場合は、1つのインフラストラクチャサービスのみで有効にしてください。
   
6. インフラストラクチャサービスの構成中に、オプションでライセンスタブを使用してCitrixライセンスサーバーを指定できます。指定しない場合、管理コンソールが新しいWorkspace Environment Managementデータベースに初めて接続するときに、管理コンソールリボンのバージョン情報タブでCitrixライセンスサーバーの資格情報を入力する必要があります。どちらの場合も、Citrixライセンスサーバーの情報はデータベース内の同じ場所に保存されます。
   • グローバルライセンスサーバーのオーバーライド。このオプションを有効にすると、Workspace Environment Managementで使用されるCitrixライセンスサーバーの名前を入力できます。ここに入力した情報は、Workspace Environment Managementデータベースに既に存在するCitrixライセンスサーバー情報をすべて上書きします。