Citrixライセンステレメトリデータのアップロードのお願い（2）

こんにちは。Citrix製品のサポートをしている宇津見です。

日本時間 2023年2月8日に、Citrix オンプレミス ライセンス サーバーソフトウェアのアップデート実施についての文書「CTX477636」が公開されました。

今回は、Citrix Virtual Apps and Desktopsで使用するCitrixライセンスサーバーの内容を中心に説明します。

　※NetScaler Consoleを使用しているお客様は、「（１２）NetScaler Console の対応について」をご参照ください。

　※弊社のCitrixヘルプデスク契約があるお客様は本記事についてお問い合わせいただくことも可能です。
本記事は、弊社サポートセンターのFAQ:65122、69696と同様の内容です。

以下の2部構成の記事になります。

１．Citrixライセンステレメトリデータの概要とアップグレード・新規インストール手順
２．Citrixライセンステレメトリデータの自動・手動送信の手順

今回は、上記「2」に関する内容です。
（目次の（８）～（１２）になります）

※下記（１）～（７）の内容は「Citrixライセンステレメトリデータのアップロードのお願い（1） 」記事をご参照ください。
（１）Citrixライセンステレメトリデータのアップロードについて
　　Citrix社のドキュメント概要
　　対応が必要となる製品
　　必要な対応について
　　未対応の場合の影響度
　　補足説明
（２）Citrixライセンステレメトリデータに含まれる内容
（３）対応の流れとチェックポイント
　　対応の流れ
　　アップロードする場合のチェックポイント
（４）Citrixライセンスサーバーソフトウェアのダウンロード方法
（５）アップグレード前の確認
　　製品バージョンの確認
　　ライセンスサーバーのバージョン確認
　　ライセンスサーバーのシステム要件を確認
（６）ライセンスサーバーのアップグレード手順の一例
（７）ライセンスサーバーの新規インストール手順の一例

ライセンステレメトリデータの初回アップロードは、ライセンスサーバーを最初に起動、または再起動した約5分後に実行されます。
それ以降のアップロードは、1日に1回実行されます。

・ライセンステレメトリデータの自動アップロード機能は「ver11.17.2 ビルド 40000」から有効です。
それ以前のバージョンをお使いの場合は、ライセンスサーバーのアップグレードをお願いします。

・ライセンスサーバーから「https://cis.citrix.com/」への送信接続ができている必要があります。
上記サイトへの接続ができない場合、アンチウィルスソフトウェアやファイアウォールの設定についてご確認ください。
　※必要に応じて、アンチウィルスソフトウェアは一旦停止してから事象の確認をお願いします。

・プロキシサーバをご利用の場合、下記ファイルにプロキシ設定を入力し、上記等の接続問題が改善するかご確認ください。
　　該当ファイル：
　　C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml

ライセンステレメトリデータが正常にアップロードされたかどうかを確認するには、下記ファイルをご参照ください。

【エラー内容１】
CTX_UPLOADER_ERROR_NETWORK_OPENSocketOpen(cis.citrix.com:443)
exception: {GetAddrInfoW(cis.citrix.com) failed: WSAHOST_NOT_FOUND :
code 0x00002af9: No such host is known.}cis.citrix.com:
4431679283245CTX_UPLOAD_TYPE_COMPLIANCE

【対応方法】
ライセンスサーバーがポート443経由でcis.citrix.comに接続できることを確認してください。
また、下記ファイルでプロキシを設定している場合は、正しく設定されているか確認してください。

　C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml


【エラー内容２】
CTX_UPLOADER_ERROR_NETWORK_SSL_OPEN
SSLOpen() failed: doClientHandshake() failed! SSL_STATUS_X509ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY (OpenSSL specific) a root cert to match the identity received could not be found locally You have not chosen to trust "Baltimore CyberTrust Root", the issuer of the server's security certificate.doHandshake() failed! You have not chosen to trust "Baltimore CyberTrust Root", the issuer of the server's security certificate.

【対応方法】
1. こちらのサイト より、証明書をダウンロードします。
（「DigiCert Baltimore TLS RSA SHA256 2020 CA1」でページ内を検索し、「Download DER/CRT」のほうをクリックしてダウンロードしてください）。

2. 証明書をダブルクリックし、「証明書のインストール」をクリックします。

3. 保存場所を「ローカルコンピュータ」にして次に進みます。

4. 「証明書をすべて次のストアに配置する」を選択し、参照から「信頼されたルート証明機関」を選択して次に進み、完了をクリックします。

5. 「コントロールパネル」＞「システムとセキュリティ」＞「管理ツール」＞「サービス」より、「Citrix Webservice for Licensing」と「Citrix Licensing」の再起動を行います。

6. 24時間以上待ってから、下記のファイルをご確認ください。

　・該当ファイル：
　　C:\Program Files (x86)\Citrix\Licensing\LS\resource\cache\upload_compliance_result.xml

※上記以外のエラーが発生している場合は、弊社サポートまでお問い合わせください。

以下の２つの対応を行います。

・ライセンステレメトリデータの自動送信を無効化
・ライセンステレメトリデータを手動でアップロード

※詳細は、Citrix社ドキュメントの「Citrixライセンステレメトリ 」をご参照ください。

以下の手順で自動送信を無効化できます。
また、90日を超えない周期での定期的な手動アップロードをお願いします。

1. Citrixライセンスサーバー上で、管理者権限でコマンドプロンプトを実行します。

2. 以下のコマンドを順に実行します。

　cd ”C:\Program Files (x86)\Citrix\Licensing\LS”
　ctx_license_management_service.exe -disable

　※１行で実行もできます。
　　”C:\Program Files (x86)\Citrix\Licensing\LS\ctx_license_management_service.exe” -disable

3. ”Do you still want to disable License Management Service [y/n]” の入力にて”y”を入力して
Enterキーを押します。

＜コマンド実行例＞

4. 設定された値は以下のコマンドにて確認できます。

　cd ”C:\Program Files (x86)\Citrix\Licensing\LS”
　ctx_license_management_service.exe -query

　※１行で実行もできます。
　　”C:\Program Files (x86)\Citrix\Licensing\LS\ctx_license_management_service.exe” -query

＜コマンド実行例＞

ライセンスサーバーがインターネットに接続されていない場合、手動でライセンスサーバーのテレメトリデータをアップロードしてください。
テレメトリデータは、90日を超えない周期でアップロードが必要です。

　※11.17.2ビルド45000以降、Citrixへデータを手動アップロードする場合は、ライセンスサーバーとCitrix Virtual Apps and Desktopsの両方のデータ要素をアップロードする必要があります。

【アップロード手順】

1. 上記表のパスを開き、「upload_compliance_<数値>.zip」「upload_usage_<数値>.zip」を
インターネットに接続されているPCへコピーします。
　※それぞれ複数ファイルがある場合は、１つのzipファイルにパッケージ化してください。

2. https://cis.citrix.com にアクセスし、ご利用環境に紐づくMyAccountでログインします。
　※https://cis.citrix.com のページは、MyAccountが多要素認証（MFA）設定されている場合にログインができます。

3. 「Getting Started」の画面が表示された場合は、「Do not show this again, Opt-in」にチェックを入れ、「Get Started」をクリックしてください。

4. Citrix Insight Serviceのページが開きます。

5. 「Tools」タブから「Upload Data」をクリックします。

6. 「Upload License Telemetry Data」を選択し、「Upload File」をクリックします。

7. ライセンスサーバーからコピーしたupload_compliance_<数値>.zipを選択し、アップロードします。

8. 作業完了後、ライセンスサーバーのupload_compliance_<数値>.zipを削除します。

【Q1】Citrix ライセンスサーバーの新ビルドがリリースされたことを確認する方法

【A1】以下の方法にて確認してください。

　・こちらのサイト にあるRSSフィードを利用する
　
　・毎月25日(休日の場合は翌営業日)に発行している「弊社のCitrixヘルプデスクメールマガジン」をご確認いただく
　　※ライセンスサーバーの新しいバージョン・ビルドがリリースされている場合は、メールマガジンに記載させていただきます。


【Q2】以下のライセンステレメトリデータが生成されるタイミングについて
　C:\Program Files (x86)\Citrix\Licensing\LS\resource\usage\upload_compliance_<数値>.zip

【A2】ライセンスサーバーの開始時刻に基づいて24時間毎に生成される記載がこちらのドキュメント に記載されています。

Citrix社の以下のドキュメントをご参照ください。

いかがでしたでしょうか。
Citrixライセンステレメトリデータのアップロード手順のご参考にしていただけますと幸いです。

いつもCitrixサポートブログをご覧いただきありがとうございます。

アシストとCitrix保守契約を締結されている方は、Webサポートセンター「AWSC」をご利用いただけます。本ブログサイトではご紹介しきれないFAQや過去のCitrixヘルプデスクメールマガジンを公開していますので、是非ご利用ください。

また、アシストではCitrixユーザ企業様向けの無償セミナーを多数ご提供しています。Citrix製品を利用するうえで必要となる情報やトラブルシューティング時のノウハウをご紹介するセミナーなどご用意していますので、貴社の課題解決へとお役立てください。アシストと保守契約を締結されていないお客様にもご参加いただけます。

Citrix Virtual Apps and Desktopsに関する「入門編の情報」や「トラブルシューティングの情報」をお探しの場合、以下の動画をご視聴いただけますと幸いです。効率よく情報収集をしていただけます。

・Citrix Virtual Apps and Desktops入門動画
・Citrixトラブルシューティングセミナー

アシストのCitrixサポートセンターに良くある設定・トラブル対処方法のFAQ10選の資料を無料プレゼント中です。また、Citrix XenApp/XenDesktopの問題発生時に原因を切り分ける方法も掲載しております。以下のバナーからお気軽にダウンロードください。