Citrix Virtual Apps and Desktopsデータソース
この記事では、StoreFrontを使用してオンプレミスのCitrixVirtual Apps and Desktops サイトをCitrix Analyticsに接続する手順について説明します。この記事に記載されているオンボーディング手順は、パフォーマンス向けCitrix Analytics(パフォーマンス分析)とセキュリティ向けCitrix Analytics(セキュリティ分析)の両方に適用されます。
各オファリングに固有のオンボーディング手順については、次の記事を参照してください。
-
Citrix Analytics for PerformanceによるオンプレミスのCitrixVirtual Apps and Desktops サイトの構成
-
Citrix Analytics for Security用のCitrix Virtual Apps and Desktops およびCitrix DaaSデータソースの設定
StoreFrontを使用したCitrix Virtual Apps and Desktops のオンプレミスサイトのオンボーディング
組織でオンプレミスのStoreFront展開環境を使用している場合は、Citrix WorkspaceアプリがCitrix Analytics にイベントを送信できるようにStoreFrontサーバーを構成する必要があります。Citrix Analyticsはイベントを処理して、Citrix ITインフラストラクチャのパフォーマンスとユーザー行動に関する実用的な洞察を提供します。
Citrix Analytics用にStoreFront展開環境を構成する方法について詳しくは、StoreFrontドキュメントの「 Citrix Analytics サービス 」を参照してください。
以前は、Citrix Apps and Desktopsのオンプレミスサイトを使用しているお客様は、サイトアグリゲーションを使用してオンプレミスサイトをCitrix Analytics for Security and Performanceにオンボーディングする必要がありました。
サイトの集約に依存することなく、Citrix Apps and Desktopsのオンプレミスサイトをオンボーディングできるようになりました。
サイトアグリゲーションにサイトを追加していない場合でも、ワークスペースアプリケーションに[ Connect Storefront Deployment ]オプションが表示されます。
前提条件
開始する前に、次のことを確認してください。
-
StoreFront のバージョンは1906以降である必要があります。
-
StoreFront展開環境では、次のアドレスに接続できる必要があります。
-
StoreFront 展開環境では、アウトバウンドインターネット接続用にポート443が開いている必要があります。ネットワーク上のプロキシサーバーは、Citrix Analytics とのこの通信を許可する必要があります。
-
StoreFront 展開環境が、Webプロキシを使用してインターネットに接続するWebサーバー上でホストされている場合は、各ストアのプロキシをアウトバウンドトラフィックを許可するように手動で構成する必要があります。StoreFront は、ホストWebサーバーのプロキシ設定を自動的には使用しません。詳しくは、「 HTTPプロキシを使用するWebサーバーでホストされるStoreFront 展開環境の構成」を参照してください。
-
StoreFront 展開環境には、次のいずれかのクライアントを使用してアクセスする必要があります。
-
HTML5互換ブラウザーのWebサイト用のCitrix Receiver。
注
HTML5ユーザーの場合、CitrixVirtual Apps and Desktops は、StoreFront で特定の構成が有効になっているときにイベントを起動できます。構成手順について詳しくは、HTML5向けCitrix Workspace アプリのドキュメントの「 インストール 」の記事を参照してください。印刷関連のイベントの場合、StoreFront で追加のポリシーを構成する必要があります。詳しくは、HTML5向けCitrix Workspace アプリのドキュメントの「 PDF印刷 」を参照してください。
-
Citrix Workspace アプリ1907以降のWindows版。
-
Linux以降のCitrix Workspace アプリ2006。
-
Mac版以降のCitrix Workspace アプリ2006
-
-
Citrix Virtual Apps and Desktops 7 1912 LTSRを使用している場合、サポートされているStoreFront のバージョンは1912です。
StoreFront 展開環境に接続する
以下の方法でStoreFront デプロイメントに接続できます。
-
アプリとデスクトップ — Workspace アプリサイトカードとアプリとデスクトップ— 監視サイトカードの使用
-
レコメンデーションパネルの使用
アプリとデスクトップ — Workspace アプリサイトカードとアプリとデスクトップ — 監視サイトカードを使用して接続
-
[ 設定] > [データソース] > [セキュリティ]に移動します。[アプリとデスクトップ-Workspace]アプリサイトカードで、縦方向の省略記号(⋮)をクリックし、[StoreFront展開環境の接続]を選択します。
-
[ 設定] > [データソース] > [パフォーマンス]に移動します。[アプリとデスクトップ-監視]サイトカードで、縦方向の省略記号(⋮)をクリックし、[StoreFront展開環境の接続]を選択します。
StoreFront オンボーディングウィザードまたはStoreFront デプロイメントへの接続ポップアップが表示されます 。
-
「 パッケージをダウンロード」をクリックします。
注
このファイルには機密情報が含まれています。ファイルを安全な場所に保存します。
-
StoreFront デプロイメントを構成するには、
-
インストールパッケージをStoreFront サーバーにコピーします。
-
コピーしたファイルを解凍し、PowerShell 内のフォルダーに移動します。
-
StoreFront をオンボーディングするには、管理者として次のコマンドを実行する必要があります。
.\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
その他のオプションやパラメーターについては、「 PowerShell スクリプト 」セクションを参照してください。
-
StoreFront サーバーを開き、PowerShellスクリプトを実行します。
-
OnboardStoreFront を実行してもStoreFrontサイトがCitrix Analytics Service GUIに表示されない場合は、iisresetコマンドを実行してください。
-
Citrix Analytics Service GUIにログインし、クラスターIDがスクリプトによってコンソールに記録されたものと一致するかどうかを確認します。
-
構成が完了したら、Citrix Analyticsにログインして、接続されているStoreFront 展開環境を表示します。
-
-
設定が成功したら、[ 完了] をクリックします。
-
[ データ処理を有効にする ]をクリックして、Citrix Analytics でデータを処理できるようにします。
PowerShellスクリプト
Citrix AnalyticsサービスへのStoreFront のオンボーディングプロセスを簡素化するために、新しいPowerShellスクリプトが導入されました。このPowerShellスクリプトは、前提条件の確認、インストール、およびStoreFront の構成プロセスを自動化します。PowerShell スクリプトは管理者モードで実行する必要があります。
お客様は、StoreFront でこのPowerShellスクリプトを実行して、オンボーディング、デボーディング、セルフチェックの実行、トラブルシューティング、およびCitrix Analytics Service GUIへのオンボーディングが成功したかどうかの検証を行うことができます。顧客が初めてスクリプトを実行すると、発行者に確認を求めるセキュリティ警告メッセージが表示されます。発行元が信頼できる場合は、「常に実行」オプションを選択します。
PowerShellスクリプトは、StoreFront Configuration.jsonファイル、いくつかのCCauth、およびdllファイルとともに、StoreFrontDeploymentの接続ページでzipファイル形式で入手できます 。PowerShell スクリプトログは、ダウンロードフォルダーの cas-logs ファイルに保存されます。
PowerShell スクリプトは、以下のパラメーターをサポートしています。
-
SelfCheck: SelfCheckパラメーターを使用して 、StoreFrontオンボーディングの前提条件が満たされていることを検証します。StoreFront のインストール、必要なバージョン、アウトバウンド接続、cURL Analyticsサーバーのネットワーク接続、インターネット接続、サーバーグループ構成、および既存のCitrix Analytics Service構成をチェックします。 以下のコマンドを使用してセルフチェックを実行します。
.\Manage-CitrixAnalytics.ps1 –param SelfCheck
-
OnboardStoreFront: OnboardStoreFrontパラメーターは 、セルフチェックをすばやく実行して、Citrix Analyticsサービス構成のセットアップ準備が整っていることを確認します。セットアップの準備が整うと、Citrix Analytics Serviceの構成がインポートされ、変更がサーバーグループ内の他のサーバーに公開されます。サーバーグループの場合、PublishConfigurationコマンドはスクリプトから自動的に実行され、StoreFront 構成をそのStoStoreFront 内のすべてのサーバーに公開します。
PublishConfiguration
アクションを確認するポップアップが表示されます。「 すべてはい」 ボタンを選択します。構成の公開が正常に完了すると、スクリプトはCitrix Analytics Service APIを呼び出して、StoreFront がCitrix AnalyticsサービスGUIにオンボーディングされているかどうかを確認します。この API を呼び出すには、認証用の秘密鍵が必要です。この秘密鍵を生成するには、CCAuth ファイルと dll ファイル、およびダウンロードした JSON ファイルにある認証情報が必要です。
注:
StoreFront のオンボーディングプロセスが完了すると、StoreFront がCitrix AnalyticsサービスのGUIに表示されるまでに2〜5分かかる場合があります。StoreFront サイトがCitrix AnalyticsサービスのGUIに表示されない場合は、IISRESETを実行してインターネットインフォメーションサービスをリセットする必要があります。
次のコマンドを使用して OnBoardStoreFrontを実行します。
.\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
-
IsOnBoarded: IsOnBoardedパラメーターは、StoreFront がCitrix AnalyticsサービスGUIにオンボーディングされているかどうかを確認するために使用されます 。スクリプトは終了するまで1分間待機しますが、オンボーディングが成功してからStoreFront がGUIに表示されるまでに最大5分かかることがあります。確認するには、このコマンドを実行する必要があります。このコマンドには、CCAuth ファイルと dll ファイルとの依存関係もあります。以下のコマンドを使用して ISonBoardedを実行します。
.\Manage-CitrixAnalytics.ps1 –param IsOnboarded
-
トラブルシューティング:5分待ってもCitrix Analytics Service GUIにStoreFront サイトが表示されない場合は、IISRESETを実行してインターネットインフォメーションサービスをリセットする必要があります。それでもStoreFront サイトがGUIに表示されない場合は、 トラブルシューティングパラメーターを使用してください 。接続に関する問題のトラブルシューティングやログの収集に役立ちます。 次のコマンドを使用してトラブルシューティングを実行します。
.\Manage-CitrixAnalytics.ps1 –param TroubleShoot
トラブルシューティングパラメータは、次の 2 つのユースケースに役立ちます。
-
ユースケース 1: CurlAnalytics が失敗したかどうかのセルフチェックの一環として、ファイアウォールルールが作成されます。このファイアウォールルールは 443 ポートを開き、Analytics への接続を確認します。そうでない場合は、Analytics サーバーにアクセスできず、スクリプトはここから終了します。Citrix Analytics サービスへの接続が復元されたら、スクリプトを再実行します。
-
ユースケース2:cURLが正常に実行されてもStoreFront サイトがGUIに反映されない場合、管理者はDebugViewのダウンロードからDebugViewツールのzipファイルをダウンロードし、 解凍してダウンロードフォルダーに配置する必要があります。 PowerShell スクリプトは、Citrix Analytics サービスがすでに構成されている場合、まずアンインストールします。Verbose ロギングを有効にします。次に、DebugViewツールを起動し、Citrix Analytics サービスを再インストールします。最後に、DebugView を停止し、詳細ログを無効にします。
デバッグビューログはキャプチャしてCitrixスサポートと共有できます。Citrix管理者はさらにデバッグを行い、問題の特定と解決を試みます。ログは生成され、DebugView フォルダー内にログファイルとして保存されます。
次の 3 つのログファイルを Citrix 管理者と共有する必要があります。
- デバッグビューログファイル (ダウンロード\ デバッグビュー\ ログ)
- StoreFront ログファイル (C:\Program Files\ Citrix\ Receiver StoreFront\ Admin\ trace)
- CAS ログファイル。これらのログはスクリプトの実行の一部として生成され、[ ダウンロード] > [cas-logs ] フォルダーに保存されます。
サーバーグループの場合、スクリプトがStoreFront のデボードまたはオンボードを試みると、
PublishConfiguration
コマンドが自動的に実行されます。PublishConfigurationコマンドは、そのStoreFront 内のすべてのサーバーにStoreFront 構成を公開するのに役立ちます。このアクションを確認するポップアップが表示されます。「 すべてはい」 ボタンを選択します。 -
-
DeboardStoreFront: DeboardStoreFrontパラメーターは、Citrix AnalyticsサービスからStoreFrontサーバーをデボーディングするために使用されます。次のコマンドを使用して DeBoardStoreFront を実行します。
.\Manage-CitrixAnalytics.ps1 –param DeboardStoreFront
PowerShellスクリプトは、まずすべてのCitrix Analytics Service構成をStoreFront から削除し、削除が正常に完了したことを確認します。次に、ServerGroupが存在するかどうかを確認し、構成を公開して、削除された構成がすべてのStoreFront に公開されるようにします。最後に、「ボード上のサイトの削除」を呼び出します。サイトがCitrix Analytics Service GUIから削除されていない場合は、StoreFront展開を使用してStoreFront サイトを手動で削除し、StoreFront 展開環境のワークスペースアプリケーションサイトカードからStoreFront サイトを手動で削除する必要があります。
サーバーグループの場合、PublishConfigurationコマンドはスクリプトから自動的に実行され、StoreFront 構成をそのStoStoreFront 内のすべてのサーバーに公開します。このアクションを確認するポップアップが表示されます。「 すべてはい」 ボタンを選択します。
レコメンデーションパネルを使用して接続
データソースページのレコメンデーションパネルは、データソースをオンボーディングすることの重要性についてユーザーに教えます 。これにより、ユーザーはデータソースを簡単にオンボーディングできます。また、使用可能なすべてのデータソースを確認してオンボーディングしたことを確認するオプションも提供されます。
-
Security Analytics サービスを使用している場合は、[ 設定] > [データソース] > [セキュリティ] を選択します。
-
パフォーマンス分析サービスを使用している場合は、[ 設定] > [データソース] > [パフォーマンス]に移動します。
-
[ **データソース ] ページの [推奨事項] パネルに表示される情報と推奨事項を確認して、Storefrontの展開を開始します。**
注
StoreFront データソースをオンボーディングすると、Workspaceアプリはエンドポイントの可視性に関するテレメトリデータをAnalyticsに送信できます。
-
「 オンボーディングを開始」をクリックします。「 デプロイされたStoreFrontインスタンスの指定 」ページが表示されます。
-
Analyticsがデータソースを正常にオンボーディングできるように、 デプロイされたStoreFront インスタンスの総数を指定します。
注:
デプロイされたStoreFront インスタンスの総数はStoreFront グループの総数であり、個々のStoreFront サーバーの数ではありません。
-
[続行] をクリックします。StoreFront オンボーディングウィザードまたはStoreFront デプロイメントへの接続ポップアップが表示されます 。
-
[ StoreFront 展開環境の接続 ]ページで、[パッケージのダウンロード]をクリックしてインストールパッケージをダウンロードします。
メモ
このファイルには機密情報が含まれています。ファイルを安全な場所に保存します。
1つのパッケージをダウンロードして、1つのStoreFront グループのオンボーディングにのみ使用できます。StoreFront グループが複数ある場合は、StoreFront グループごとにパッケージを個別にダウンロードする必要があります。1つのパッケージを使用して1つのStoreFront グループのオンボーディングが終了したら、そのパッケージを再度ダウンロードして、次のStoreFront グループのオンボーディングを続行します。
何らかの問題により、1つのパッケージを使用して2日以内にStoreFront のオンボーディングが正しく完了しない場合は、2日後に新しいパッケージを再ダウンロードする必要があります。2日以内に正常にオンボーディングされないと、パッケージ内のキーの有効期限が切れてしまうためです。
-
StoreFront デプロイメントを構成するには、
-
インストールパッケージをStoreFront サーバーにコピーします。
-
コピーしたファイルを解凍し、PowerShell 内のフォルダーに移動します。
-
次のコマンドを実行してStoreFront をオンボードします。
.\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
-
StoreFront サーバーを開き、PowerShellスクリプトを実行します。
-
StoreFront サイトがCitrix Analytics Service GUIに表示されない場合は、次のコマンドを実行します:
Execute iisreset
-
PowerShell スクリプトで使用可能なクラスタ ID を記録して確認します。
-
構成が完了したら、Citrix Analyticsにログインして、接続されているStoreFront 展開環境を表示します。
-
-
設定が成功したら、[ 完了] をクリックします。
推奨パネルからオンボーディングする場合 、システムはCitrix AnalyticsサービスにオンボーディングしたStoreFront 展開環境の数を取得します。 推奨パネルが表示され 、オンボードされたStoreFront 展開を確認できます。「 レコメンデーション 」パネルでメッセージを確認し、「 完了としてマーク」をクリックします。
注
レコメンデーションパネルとメッセージは 、宣言されたすべてのStorefrontデプロイがオンボーディングされた場合にのみ消えます。
- [ データ処理を有効にする ]をクリックして、Citrix Analytics でデータを処理できるようにします。
レコメンデーションパネルを確認
推奨パネルでは 、宣言されたStoreFront 展開の数と、登録されたStoreFront 展開環境の数を比較できます。
宣言されたStoreFront 展開環境の数がオンボーディングされたStoreFront 展開環境の数と同じ場合は、すべてのStoreFront 展開環境がオンボーディングされたことを示すAll Onboardedメッセージが表示されます 。「 レコメンデーション 」パネルでメッセージを確認し、「 完了としてマーク」をクリックします。
注
さらに多くのStoreFront 展開環境をオンボーディングする場合は、[ オンボーディング手順を表示 ]をクリックすると、StoreFront オンボーディングウィザードまたは[ StoreFront 展開環境への接続 ]ポップアップが再び表示されます。
宣言されたStoreFront 展開の数がオンボードされたStoreFront 展開の数より少ない場合は、[ 数を編集]をクリックすると、[ 展開されたStoreFrontインスタンスの指定 ]ページが表示されます。次に、 デプロイされたStoreFront インスタンスの総数を入力して、[ 続行]をクリックします。StoreFront オンボーディングウィザードまたはStoreFront デプロイメントへの接続ポップアップが再び表示されます 。手順に従って、さらに多くのStoreFront デプロイメントをオンボーディングしてください。
注:
デプロイされたStoreFront インスタンスの総数はStoreFront グループの総数であり、個々のStoreFront サーバーの数ではありません。
接続されているStoreFront 展開環境の表示
StoreFront展開環境は、正常に構成された場合にのみサイトカードに表示されます。サイトカードには、Citrix Analytics との接続が確立されているStoreFront 展開環境の数が表示されます。
-
パフォーマンス分析オファリングを使用している場合、[ アプリとデスクトップ-監視 ] サイトカードに次の情報が表示されます。
-
Security Analytics サービスを使用している場合、 Workspace アプリサイトカードに次の情報が表示されます 。
サイトカード上のStoreFront 展開環境の数をクリックして、サーバーグループを表示します。
各StoreFront 展開は、ベースURLとサーバーグループIDによって表されます。
Security Analytics オファリングを使用している場合、受信したイベントに関する次の情報もサイトカードに表示されます。
-
過去1時間にStoreFront展開環境から受信したイベント。これはデフォルトの時間選択です。1週間(1 W)を選択して、データを表示することもできます。受信したイベントの数をクリックすると、 セルフサービス検索ページにイベントが表示されます 。
-
データ処理を有効にすると、サイトカードに [ データを受信していません ] ステータスが表示される場合があります。このステータスは、次の2つの理由で表示されます:
-
初めてデータ処理をオンにした場合、イベントがCitrix Analyticsのイベントハブに到達するまでに時間がかかります。Citrix Analyticsがイベントを受信すると、ステータスがData processing onに変わります。しばらくしてもステータスが変わらない場合は、[ データソース ] ページを更新します。
-
Citrix Analyticsは、過去1時間にデータソースからイベントを受信していません。
-
StoreFront 展開環境を追加または削除する
StoreFront展開環境を追加するには、[ StoreFront展開環境]セクションの[StoreFront展開環境への接続** ]をクリックします。構成ファイルをダウンロードし、手順に従ってStoreFront 展開環境を構成します。
構成済みのStoreFront 展開環境からのイベント送信を停止し、Citrix Analytics から削除するには:
-
Citrix Analytics から削除するStoreFront 展開環境に移動します。次のコマンドを実行して、StoreFrontサーバーから構成設定を削除します。
Remove-STFCasConfiguration
-
マルチサーバー展開を使用している場合は、次のコマンドを実行して変更を伝播し、StoreFrontサーバーグループ内のすべてのサーバーから構成設定を削除します。
Publish-STFServerGroupConfiguration
-
次のコマンドを実行して、構成設定が正常に削除されたことを確認します。設定が正常に削除された場合、このコマンドは何も返しません。
Get-STFCasConfiguration
-
Citrix Analytics に再度ログインし、[StoreFront展開環境] セクションでStoreFront展開環境を選択します 。縦の省略記号(⋮)をクリックし、[ AnalyticsからStoreFront展開環境を削除]を選択します。
注
指定したコマンドをStoreFront 展開環境で実行してから、Citrix Analytics から削除します。コマンドを実行しなかった場合、Citrix Analytics は引き続きイベントを受信し、次のイベントプールサイクルでStoreFront 展開環境が再び追加されます。
HTTPプロキシを使用するWebサーバーでホストされるStoreFront 展開環境を構成する
StoreFront がWebプロキシを使用してインターネットに接続するWebサーバー上でホストされている場合は、Citrix Analyticsに登録するようにストアを手動で構成する必要があります。この設定では、store web.configファイルに<system.net>
セクションを追加する必要があります。Citrix Analytics にイベントを送信するStoreFront 展開環境のすべてのストアを構成する必要があります。
store web.configファイルに<system.net>
セクションを追加する方法は 2 つあります。
-
1 つ以上のストアのストアプロキシ構成を PowerShell 経由で設定します (推奨される方法)。
-
ストア web.configファイルに
<system.net>
セクションを手動で追加します。
これらの方法について詳しくは、 StoreFront ドキュメントの「Webプロキシを使用してCitrix Cloudに接続し、Citrix Analytics に登録するようにStoreFront を構成する 」を参照してください。