インストール、アップグレード、アンインストール

注:

負荷分散によるサーバーの高可用性を構成するには、既存の展開で負荷分散を構成するおよびAzureでSession Recordingを展開して負荷分散するを参照してください。

「Citrix セッションレコーディング」および「Citrix セッションレコーディングサービス」を迅速にセットアップおよび構成する方法の詳細については、Citrix Tech Zoneの記事「POCガイド:Citrix セッションレコーディング」を参照してください。

Session RecordingサーバーとエージェントをAzure AD参加済みマシンにインストールし、それらのAzure ADサポートを有効にできます。後でクラウドからさまざまなポリシーと再生権限を構成する際に、Azure AD参加済みマシンからセッションを起動するAzure ADユーザーとグループを指定できます。Citrix Virtual Apps and Desktops™インストーラーを使用してSession Recordingサーバーをインストールする場合、Azure ADサポートを有効にするオプションはGUIでは利用できません

この記事には、次のセクションが含まれています。

インストールチェックリスト

Citrix®スクリプトを使用してWindowsの役割と機能の前提条件をインストールする

Citrix Virtual Apps and Desktopsインストーラーを使用してセッションレコーディングをインストールする

インストールの自動化

クラウドSQLデータベースサービスにSession Recordingデータベースをインストールする

セッションレコーディングのアップグレード

セッションレコーディングのアンインストール

シトリックス アナリティクス フォー セキュリティとの統合

インストールチェックリスト

インストールを開始する前に、このリストを完了してください:

手順
  各Session Recordingコンポーネントをインストールするマシンを選択します。各コンピューターが、インストールされるコンポーネントのハードウェアおよびソフトウェア要件を満たしていることを確認してください。
  Citrixアカウントの資格情報を使用して、Citrix Virtual Apps and Desktopsのダウンロードページにアクセスし、製品のISOファイルをダウンロードします。ISOファイルを解凍するか、DVDに書き込みます。
  Session Recordingコンポーネント間の通信にTLSプロトコルを使用するには、環境に適切な証明書をインストールします。
  Session Recordingコンポーネントに必要なホットフィックスをインストールします。ホットフィックスはCitrix Supportから入手できます。
  Citrix Directorを構成して、Session Recordingポリシーを作成およびアクティブ化します。詳しくは、Directorを構成してSession Recordingサーバーを使用するを参照してください。

注:

  • 公開アプリケーションは、レコーディングポリシーに基づいて個別のDelivery Groupに分割することをお勧めします。アプリケーションが同じDelivery Groupにある場合、公開アプリケーションのセッション共有はアクティブなポリシーと競合する可能性があります。Session Recordingは、ユーザーが最初に開く公開アプリケーションとアクティブなポリシーを照合します。7.18リリース以降、動的セッションレコーディング機能を使用して、セッション中にいつでもレコーディングセッションを開始または停止できます。この機能は、アクティブなポリシーとの競合の問題を軽減するのに役立ちます。詳しくは、「Dynamic session recording」を参照してください。
  • Machine Creation Services™ (MCS) または Provisioning Services を使用する予定がある場合は、一意のQMIdを準備してください。これに従わない場合、レコーディングデータが失われる可能性があります。
  • SQLサーバーには、TCP/IP、実行中のSQL Server ブラウザー サービス、および有効なWindows認証が必要です。
  • HTTPSを使用するには、TLS/HTTPS用のサーバー証明書を構成します。
  • ローカルユーザーとグループ > グループ > ユーザーのユーザーが、C:\windows\Tempフォルダーへの書き込み権限を持っていることを確認してください。

(msiインストールにのみ必要) Citrixスクリプトを使用してWindowsの役割と機能の前提条件をインストールする

Session Recordingが適切に機能するように、必要なWindowsの役割と機能の前提条件をインストールするには、以下のCitrixスクリプトを使用してください。 Session Recordingをインストールする前に:

  • InstallPrereqsforSessionRecordingAdministration.ps1

     <#
     .Synopsis
         Installs Prereqs for Session Recording Administration
     .Description
         Supports Windows Server 2025, Windows Server 2022, Windows Server 2019.
         Install below windows feature on this machine:
         -Application Development
         -Security - Windows Authentication
         -Management Tools - IIS 6 Management Compatibility
             IIS 6 Metabase Compatibility
             IIS 6 WMI Compatibility
             IIS 6 Scripting Tools
             IIS 6 Management Console
         -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
     #>
     function AddFeatures($featurename)
     {
         try
         {
             $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
             Add-WindowsFeature $feature
         }
         catch
         {
             Write-Host "Addition of Windows feature $featurename failed"
             Exit 1
         }
         Write-Host "Addition of Windows feature $featurename succeeded"
     }
    
     $system= gwmi win32_operatingSystem | select name
    
     if (-not (($system -Like '*Microsoft Windows Server 2025*') -or ($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*')))
     {
         Write-Host("This is not a supported server platform. Installation aborted.")
         Exit
     }
    
     # Start to install Windows feature
     Import-Module ServerManager
    
     AddFeatures('Web-Asp-Net45') #ASP.NET 4.5
     AddFeatures('Web-Mgmt-Console') #IIS Management Console
     AddFeatures('Web-Windows-Auth') # Windows Authentication
     AddFeatures('Web-Metabase') #IIS 6 Metabase Compatibility
     AddFeatures('Web-WMI') #IIS 6 WMI Compatibility
     AddFeatures('Web-Lgcy-Scripting')#IIS 6 Scripting Tools
     if (($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*'))
     {
         AddFeatures('Web-Lgcy-Mgmt-Console') #IIS 6 Management Console
     }
    
     AddFeatures('MSMQ-HTTP-Support') #MSMQ HTTP Support
     AddFeatures('web-websockets') #IIS Web Sockets
     AddFeatures('NET-WCF-HTTP-Activation45') #http activate
     AddFeatures('Web-IP-Security')#IIS-IPSecurity
     <!--NeedCopy-->
    
  • InstallPrereqsforSessionRecordingAgent.ps1

     <#
     .Synopsis
         Installs Prereqs for Session Recording Agent
     .Description
         Supports  Windows Server 2025, Windows Server 2022, Windows Server 2019, Windows Server 2016, windows 11, and Windows 10.
         Install below windows feature on this machine:
         -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
     #>
     function AddFeatures($featurename)
     {
         try
         {
             $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
             Add-WindowsFeature $feature
         }
         catch
         {
             Write-Host "Addition of Windows feature $featurename failed"
             Exit 1
         }
         Write-Host "Addition of Windows feature $featurename succeeded"
     }
    
     # Start to install Windows feature
    
     $system= gwmi win32_operatingSystem | select name
    
     if (-not (($system -Like '*Microsoft Windows Server 2025*') -or ($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows 11*') -or ($system -Like '*Microsoft Windows 10*')))
     {
         Write-Host("This is not a supported platform. Installation aborted.")
         Exit
     }
    
     if ($system -Like '*Microsoft Windows Server*')
     {
         Import-Module ServerManager
         AddFeatures('MSMQ-Server') #Message Queuing
     }
     else
     {
         try
         {
             dism /online /enable-feature /featurename:MSMQ-Server /all
         }
         catch
         {
             Write-Host "Addition of Windows feature MSMQ failed"
             Exit 1
         }
         write-Host "Addition of Windows feature MSMQ succeeded"
     }
     <!--NeedCopy-->
    

Windowsの役割と機能の前提条件をインストールするには、次の手順を実行します。

  1. Session Recording管理コンポーネントをインストールする予定のマシンで、

    1. PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認します。

      Set-ExecutionPolicy RemoteSigned
      <!--NeedCopy-->
      
    2. 管理者としてコマンドプロンプトを起動し、powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1コマンドを実行します。

      スクリプトは、正常に追加された機能を表示し、その後停止します。

    3. スクリプトの実行後、会社のポリシーに基づいて、実行ポリシーが適切な値に設定されていることを確認します。

  2. Session Recordingエージェントコンポーネントをインストールする予定のマシンで、

    1. PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認します。

      Set-ExecutionPolicy RemoteSigned
      <!--NeedCopy-->
      
    2. 管理者としてコマンドプロンプトを起動し、powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1コマンドを実行します。

      スクリプトは、正常に追加された機能を表示し、その後停止します。

    3. スクリプトの実行後、会社のポリシーに基づいて、実行ポリシーが適切な値に設定されていることを確認します。

Citrix Virtual Apps and Desktopsインストーラーを使用してセッションレコーディングをインストールする

Citrix Session Recording は、次のコンポーネントで構成されています。

  • セッションレコーディング管理(セッションレコーディングデータベース、セッションレコーディングサーバー、およびセッションレコーディングポリシーコンソールを含む)
  • セッションレコーディングエージェント
  • セッションレコーディングプレーヤー
  • セッションレコーディングWebプレーヤー

すべてのコンポーネントを単一のサーバーにインストールすることは、概念実証としては許容されますが、次のように個別のサーバーにインストールすることをお勧めします。

  • マシン A に Microsoft SQL Server をインストールします。
  • マシン B にセッションレコーディングサーバー、セッションレコーディング管理者ログ、およびセッションレコーディングデータベースをインストールします。

    注:

    Session Recording データベースは実際のデータベースではありません。これは、インストール中に Microsoft SQL Server インスタンスに必要なデータベースを作成および構成するコンポーネントです。

    セッションレコーディングサーバーをインストールすると、セッションレコーディングWebプレーヤーが自動的にインストールされます。

  • マシン C に Session Recording ポリシーコンソールをインストールします。
  • Session Recording Player をマシン C またはマシン D のいずれかにインストールします。
  • VDA に Session Recording エージェントをインストールします。

セッションレコーディング管理コンポーネントをインストールする

セッションレコーディングエージェントをインストールする

セッションレコーディングプレイヤーをインストールする

セッションレコーディング管理コンポーネントをインストールする

注:

TLS 1.0が無効になっており、.NET Frameworkのバージョンが4.6より前のWindows Serverにセッションレコーディング管理コンポーネントをインストールする前に、次の手順を完了してください。

  1. マイクロソフト OLE DB ドライバー for SQL Server をインストールします。
  2. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319レジストリキーの下に、SchUseStrongCrypto DWORD (32ビット) 値を追加し、値のデータを1に設定します。

  3. ウィンドウズ サーバーを再起動します。

詳細については、[トランスポート層セキュリティ (TLS) のベストプラクティス (.NET Framework を使用)(https://learn.microsoft.com/ja-jp/dotnet/framework/network-programming/tls)]を参照してください。

セッションレコーディング管理コンポーネントには、セッションレコーディングデータベース、セッションレコーディングサーバー、セッションレコーディングポリシーコンソールが含まれます。サーバーにインストールするコンポーネントを選択できます。

ステップ1:製品ソフトウェアをダウンロードしてウィザードを起動する

  1. Citrixアカウントの資格情報を使用してCitrix Virtual Apps and Desktopsダウンロードページにアクセスし、製品のISOファイルをダウンロードします。ISOファイルを解凍するか、DVDに書き込みます。
  2. セッションレコーディング管理コンポーネントをインストールするマシンに、ローカル管理者アカウントを使用してログオンします。DVDをドライブに挿入するか、ISOファイルをマウントします。インストーラーが自動的に起動しない場合は、AutoSelectアプリケーションまたはマウントされたドライブをダブルクリックします。 インストールウィザードが起動します。

ステップ2:インストールする製品を選択する

インストールする製品を選択

製品の横にある「開始」をクリックして、Citrix Virtual Apps または Citrix Virtual Desktops™ をインストールします。

ステップ3: セッションレコーディングの選択

セッションレコーディングの選択(/ja-jp/session-recording/2509/media/select-session-recording.png)

セッションレコーディング エントリを選択します。

ステップ4: ライセンス契約を読んで同意する

インストール契約(/ja-jp/session-recording/2509/media/read-and-accept-the-license-agreement.png)

ソフトウェアライセンス契約」ページで、ライセンス契約を読み、同意して、「次へ」をクリックします。

ステップ5: インストールするコンポーネントとインストール場所を選択する

コンポーネントとインストールパスの選択(/ja-jp/session-recording/2509/media/4-select-the-components-to-install-and-the-installation-location.png)

コアコンポーネント」ページで:

  • 場所: デフォルトでは、コンポーネントはC:\Program Files\Citrixにインストールされます。ほとんどの展開で、デフォルトの場所で問題ありません。カスタムのインストール場所を指定できます。
  • コンポーネント: デフォルトでは、インストール可能なコンポーネントの横にあるすべてのチェックボックスが選択されています。インストーラーは、シングルセッションOSで実行されているか、マルチセッションOSで実行されているかを認識します。セッションレコーディング管理コンポーネントは、マルチセッションOSにのみインストールできます。セッションレコーディングエージェントは、VDAがインストールされているマシンにのみインストールできます。VDAが事前にインストールされていないマシンにセッションレコーディングエージェントをインストールした場合、「Session Recording Agent」オプションは使用できません。

セッションレコーディング管理」を選択し、「次へ」をクリックします。

セッションレコーディング管理が選択されている(/ja-jp/session-recording/2509/media/select-the-components-to-install-and-the-installation-location.png)

ステップ6: インストールする機能を選択する

インストールする機能を選択

機能ページで、次の操作を行います。

  • デフォルトでは、インストール可能な機能の横にあるすべてのチェックボックスが選択されています。概念実証の場合、これらすべての機能を単一のサーバーにインストールしても問題ありません。大規模な実稼働環境では、Session Recordingポリシーコンソールを別のサーバーにインストールします。Session Recordingサーバー、管理者ログ、およびデータベースは、さらに別のサーバーにインストールします。
  • Session Recording管理者ログは、Session Recordingサーバーのオプションのサブ機能です。Session Recording管理者ログを選択する前に、Session Recordingサーバーを選択してください。Session Recordingデータベースは、Session Recordingサーバーの必須サブ機能です。Session Recordingサーバーがインストール用に選択されると、Session Recordingデータベースも自動的に選択され、選択を解除することはできません。

    Session Recordingサーバーが選択されていません

    セッションレコーディングサーバーが選択されています

  • セッションレコーディングサーバーを選択すると、セッションレコーディングWeb Playerもインストールされます。
  • 機能を選択してインストールした後で、同じサーバーに機能を追加するには、msiパッケージのみを使用できます。インストーラーを再度実行することはできません。
  • セッションレコーディングサーバー

    Session Recordingサーバーは、次のものをホストするサーバーです。

    • ブローカー。IIS 6.0以降でホストされるWebアプリケーションで、次の目的を果たします。
      • Session Recording PlayerおよびWeb Playerからの検索クエリとファイルダウンロード要求の処理。
      • Session Recordingポリシーコンソールからのポリシー管理要求の処理。
      • 各シトリックス バーチャル アプリケーションズ アンド デスクトップまたはCitrix DaaS™(旧称シトリックス バーチャル アプリケーションズ アンド デスクトップ サービス)セッションの録画ポリシーを評価します。
    • ストレージマネージャー。各Session Recording対応VDAから受信した録画済みセッションファイルを管理するWindowsサービス。
    • 管理者ログ。管理アクティビティをログに記録するために、Session Recordingサーバーとともにインストールされるオプションのサブコンポーネントです。すべてのログデータは、デフォルトでCitrixSessionRecordingLoggingという名前の別のSQL Serverデータベースに保存されます。データベース名はカスタマイズできます。
  • セッション録画データベース

    • Session Recordingデータベースは、実際のデータベースではありません。これは、インストール中にMicrosoft SQL Serverインスタンスに必要なデータベースを作成および構成するコンポーネントです。Session Recordingは、Microsoft SQL Serverに基づいたデータベース高可用性の3つのソリューションをサポートしています。詳細については、「データベースの高可用性」を参照してください。

    • Session Recordingデータベースは、以下のクラウドSQLデータベースサービスにインストールできます。

      • アジュール SQL データベース
      • Azure SQL マネージド インスタンス
      • アジュール仮想マシン (VM) 上の SQL Server
      • エーダブリューエス アールディーエス
      • グーグル クラウド エスキューエル サーバー
  • セッションレコーディング管理者ログ

    Session Recording管理者ログは、Session Recordingサーバーと同時にインストールすることをお勧めします。管理者ログ機能を有効にしたくない場合は、後のページで無効にできます。ただし、この機能を最初にインストールしないことを選択し、後で追加したい場合は、SessionRecordingAdministrationx64.msiを使用して手動で追加するしかありません。

  • セッションレコーディングポリシーコンソール

    Session Recordingポリシーコンソールを使用して、ポリシーを構成できます。

手順6.1:Session Recordingサーバー、データベース、および管理者ログをインストールする

前述のとおり、Session RecordingデータベースはSession Recordingサーバーの必須サブ機能であり、Session Recording管理者ログはSession Recordingサーバーと同時にインストールすることをお勧めします。したがって、このセクションでは、これら3つのコンポーネントを同じマシンにインストールする手順を説明します。

  1. 機能」ページで、「セッションレコーディングサーバー」と「セッションレコーディング管理者ログ」を選択します。「セッションレコーディングサーバー」を選択すると、「セッションレコーディングデータベース」も自動的に選択されます。「次へ」をクリックします。

    セッションレコーディングサーバーが選択されました(/ja-jp/session-recording/2509/media/session-recording-server-selected.png)

  2. データベースとサーバーの構成」ページで、Session Recordingデータベースのインスタンス名とデータベース名を指定し、必要に応じて「SQL Server認証」を有効にして、「次へ」をクリックします。

    「データベースとサーバーの構成」ページ(/ja-jp/session-recording/2509/media/database-and-server-configuration-page.png)

    注:

    2507以降、Session RecordingはSQL Server認証に加えて、Entra ID(旧Azure Active Directory)パスワードおよびクラウド管理Entra IDアカウントを使用したサービスプリンシパル認証をサポートします。詳細については、「単一コマンドを使用してSession Recording管理コンポーネントの完全なセットをインストールする」を参照してください。

    データベースとサーバーの構成」ページで:

    • SQL Server認証を有効にする」:このオプションを使用すると、SQL Server認証を使用してSession Recordingデータベースに接続できます。

      「SQL Server認証を有効にする」(/ja-jp/session-recording/2509/media/enable-sql-server-authentication.png)

    • インスタンス名」:データベースインスタンスが名前付きインスタンスでない場合は、SQL Serverのコンピューター名のみを使用できます。インスタンスのセットアップ中にインスタンスに名前を付けた場合は、データベースインスタンス名としてcomputer-name\instance-nameを使用します。使用しているサーバーインスタンス名を特定するには、SQL Serverで「select @@servername」を実行します。戻り値は正確なデータベースインスタンス名です。SQL Serverがデフォルトの1433ではなくカスタムポートを使用している場合は、インスタンス名にコンマとカスタムポートを追加します。たとえば、「インスタンス名」テキストボックスに「DXSBC-SRD-1,2433」と入力します。ここで「2433」はカスタムポートを示します。
    • データベース名」:データベース名テキストボックスにカスタムデータベース名を入力するか、テキストボックスにプリセットされているデフォルトのデータベース名を使用します。「接続のテスト」をクリックして、SQL Serverインスタンスへの接続とデータベース名の有効性をテストします。

      注:

      Session Recordingサーバーのデフォルトインストールでは、通信を保護するためにHTTPS/TLSを使用します。Session Recordingサーバーのデフォルトのインターネットインフォメーションサービス(IIS)サイトでTLSが構成されていない場合は、HTTPを使用します。これを行うには、IIS管理コンソールでSession Recording Brokerサイトに移動し、SSL設定を開き、「Require SSL」チェックボックスをオフにして、SSLの選択を解除します。

      重要:

      カスタムデータベース名には、A~Z、a~z、0~9、およびアンダースコアのみを含めることができ、123文字を超えることはできません。

      SQL Serverインスタンスのsecurityadminおよびdbcreatorサーバーロール権限が必要です。権限がない場合は、次のいずれかの操作を実行できます。

      • データベース管理者に、インストール用の権限を割り当てるよう依頼します。インストールが完了したら、securityadminおよびdbcreatorサーバーロール権限は不要になり、安全に削除できます。
      • または、Citrix Virtual Apps and Desktops ISOの\x64\Session RecordingにあるSessionRecordingAdministrationx64.msiパッケージを使用します。msiインストール中に、securityadminおよびdbcreatorサーバーロール権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、OKをクリックしてインストールを続行します。

        インストールにより、Session Recordingデータベースが作成され、Session Recordingサーバーのマシンアカウントがdb_ownerとして追加されます。

  3. 管理ログ構成ページで、管理ログ機能の構成を指定します。

    管理ログ構成ページ

    管理ログ構成ページで:

    • 管理ログデータベースはSQL Serverインスタンスにインストールされます:このテキストボックスは編集できません。管理ログデータベースのSQL Serverインスタンス名は、データベースとサーバーの構成ページで入力したインスタンス名から自動的に取得されます。2411リリース以降、Session Recording管理ログデータベースをSession Recordingデータベースとは別のインスタンスにインストールできます。そのためには、インストールする前に次の手順を完了してください。

      1. Session Recordingサーバーをインストールするマシンに移動します。
      2. レジストリエディターを開きます。
      3. レジストリを変更します:
        • HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Serverに移動します。
        • SmAudDatabaseLoggingState DWORD(32ビット)値を追加し、値のデータを1に設定します。
        • SmAudDatabaseLoggingInstance値を追加し、値のデータをSession Recording管理ログデータベースをインストールするインスタンス名に設定します。

      後でデータベースをインストールすると、Session Recording管理ログデータベースは、SmAudDatabaseLoggingInstanceレジストリ値で指定された別のインスタンスにインストールされます。両方のデータベースで同じ認証モード(SQL Server認証、Windows認証、またはMicrosoft Entra ID認証)を構成し、同じユーザー権限を付与する必要があります。

    • 管理者ログデータベース名: Session Recording管理者ログ機能をインストールするには、このテキストボックスに管理者ログデータベースのカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名 CitrixSessionRecordingLogging を使用します。

      注:

      管理者ログデータベース名は、前の データベースとサーバーの構成 ページにある データベース名 テキストボックスで設定されたSession Recordingデータベース名とは異なる必要があります。

    • 管理者ログデータベース名を入力したら、接続のテスト をクリックして管理者ログデータベースへの接続をテストします。
    • 管理ログを有効にする: デフォルトでは、管理ログ機能は有効になっています。チェックボックスをオフにすることで無効にできます。
    • 強制ブロックを有効にする: デフォルトでは、強制ブロックは有効になっています。ログ記録に失敗した場合、通常の機能がブロックされる可能性があります。チェックボックスをオフにすることで強制ブロックを無効にできます。

    次へ をクリックしてインストールを続行します。

  4. 前提条件を確認し、インストールを確定します。

    インストールの概要

    概要 ページには、インストール選択が表示されます。戻る をクリックして以前のウィザードページに戻って変更を加えるか、インストール をクリックしてインストールを開始できます。

  5. インストールを完了します。

    インストールの完了

    インストールの完了 ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

    完了 をクリックして、Session Recordingサーバー、データベース、および管理者ログのインストールを完了します。

手順6.2:Session Recordingポリシーコンソールをインストールする

セッションレコーディングポリシーコンソールをインストールするには、次の手順を実行します。

  1. 機能」ページで、「Session Recording ポリシーコンソール」を選択し、「次へ」をクリックします。

    ポリシーコンソールが選択されていません(/ja-jp/session-recording/2509/media/session-recording-server-unselected.png)

  2. 前提条件を確認し、インストールを確定します。

    ポリシーコンソールのインストール概要(/ja-jp/session-recording/2509/media/install-policy-console-2.png)

    概要」ページには、インストール選択が表示されます。「戻る」をクリックして前のウィザードページに戻り変更を行うか、「インストール」をクリックしてインストールを開始できます。

  3. インストールを完了します。

    ポリシーコンソールのインストールを完了する(/ja-jp/session-recording/2509/media/install-policy-console-3.png)

    インストール完了」ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

    完了」をクリックして、Session Recordingポリシーコンソールのインストールを完了します。

Step 7: Install Broker_PowerShellSnapIn_x64.msi

重要:

Session Recordingポリシーコンソールを使用するには、Broker PowerShell Snap-in (Broker_PowerShellSnapIn_x64.msi) を手動でインストールします。Citrix Virtual Apps and Desktops ISO (\x64\Citrix Desktop Delivery Controller) でスナップインを見つけ、インストール手順に従ってください。これに従わない場合、エラーが発生する可能性があります。

Session Recordingエージェントをインストールする

Session Recordingエージェントは、マルチセッションOSまたはシングルセッションOS用の各VDAにインストールされ、記録を有効にするコンポーネントです。セッションデータの記録を担当します。

ステップ 1: 製品ソフトウェアをダウンロードしてウィザードを起動する

Session Recordingエージェントをインストールするマシンに、ローカル管理者アカウントを使用してログオンします。DVDをドライブに挿入するか、ISOファイルをマウントします。インストーラーが自動的に起動しない場合は、AutoSelectアプリケーションまたはマウントされたドライブをダブルクリックします。

インストールウィザードが起動します。

ステップ 2: インストールする製品を選択する

インストールする製品を選択してください。(/ja-jp/session-recording/2509/media/install-agent-1-choose.png)

Citrix Virtual AppsまたはCitrix Virtual Desktopsのいずれかをインストールする場合は、該当する製品の横にある開始をクリックします。

ステップ 3: セッションレコーディングを選択

インストールするSession Recordingエージェントを選択します。(/ja-jp/session-recording/2509/media/install-agent-2-select.png)

セッションレコーディング」エントリを選択します。

ステップ 4: ライセンス契約を読んで同意する

インストール契約(/ja-jp/session-recording/2509/media/install-agent-3-license-agreement.png)

ソフトウェアライセンス契約ページで、ライセンス契約を読み、同意して、次へをクリックします。

ステップ 5: インストールするコンポーネントとインストール場所を選択する

インストールするエージェントを選択します。(/ja-jp/session-recording/2509/media/install-agent-4-location.png)

Session Recording Agentを選択し、次へをクリックします。

ステップ 6: エージェント構成を指定する

エージェント構成(/ja-jp/session-recording/2509/media/agent-configuration.png)

エージェント構成」ページで、次の設定を完了します。

  • Session Recordingサーバーをインストールしたマシンのコンピューター名、およびSession Recordingサーバーに接続するためのプロトコルとポート情報を入力します。Session Recordingをまだインストールしていない場合は、後でSession Recording Agent Propertiesでこの情報を変更できます。
  • 後でSession RecordingメッセージキューまたはMSMQを手動でインストールする場合は、「MSMQのインストールをスキップ」をオンにできます。このオプションを使用すると、Microsoft Message Queuing (MSMQ) をインストールせずに続行できます。
  • Azure AD参加済みマシンにSession Recordingエージェントをインストールする場合は、Azure ADサポートを有効にするを選択します。クラウドから再生権限とさまざまなSession Recordingポリシーを構成するためのAzure AD IDサポートを完全に有効にするには、次の手順を完了してからVDAを再起動します。

    注:

    Azure ADサポートはプレビュー機能です。Session Recordingバージョン2402以降で利用できます。

    プレビュー機能は完全にローカライズされていない場合があり、非実稼働環境での使用が推奨されます。Citrixテクニカルサポートは、プレビュー機能で発見された問題についてはサポートしません。

    • Azure AD参加済みマシンにSession Recordingサーバーをインストールする場合も、MSIパッケージを使用します。MSIインストール中にAzure ADサポートを有効にするを選択します。

      サーバーMSIインストール中にAzure ADサポートを有効にする(/ja-jp/session-recording/2509/media/aad-support-in-server-msi.png)

    • シトリックスクラウドをAzure ADに接続する

    • フル構成インターフェイスのホームぺージに移動し、プレビュー機能セクションでSessionRecordingSupportAADSend User Identity Info In Prepare Sessionのトグルを有効にします。フル構成インターフェイスのホームぺージにアクセスするには、次の手順を完了します。

      1. Citrix Cloudにサインインします。
      2. 左上のメニューで、マイサービス > DaaSを選択します。デフォルトでは、フル構成インターフェイスのホームぺージが表示されます。

注:

インストーラーの接続テスト機能には制限があります。これは「HTTPS requires TLS 1.2」のシナリオをサポートしていません。このシナリオでインストーラーを使用すると、接続テストは失敗しますが、その失敗を無視して次へをクリックし、インストールを続行できます。これは通常の機能には影響しません。

ステップ7: 前提条件を確認し、インストールを確定する

エージェントインストールの概要

概要ページには、インストール選択が表示されます。戻るをクリックして以前のウィザードページに戻り変更を加えるか、インストールをクリックしてインストールを開始できます。

ステップ8: インストールを完了する

エージェントのインストールが完了しました

インストールの完了ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

完了をクリックして、Session Recording Agentのインストールを完了します。

注:

Machine Creation Services (MCS) またはCitrix Provisioning™がマスターイメージとMicrosoft Message Queuing (MSMQ) がインストールされた複数のVDAを作成する場合、VDAは同じQMIdを持つ可能性があります。同じQMIdは、たとえば次のようなさまざまな問題を引き起こす可能性があります。

  • 録画契約が承認されていても、セッションが録画されない場合があります。
  • Session Recording Serverがセッションログオフ信号を受信できないため、セッションが常にライブ状態になる可能性があります。

回避策として、各VDAに一意のQMIdを作成します。これは展開方法によって異なります。

Session RecordingエージェントがインストールされたシングルセッションOS VDAが、PVS 7.7以降およびMCS 7.9以降を使用して静的デスクトップモードで作成される場合(たとえば、個別のPersonal vDiskまたはVDAのローカルディスクを使用してすべての変更を永続化するように構成されている場合)、追加のアクションは必要ありません。

MCSまたはPVSで作成されたマルチセッションOS VDA、およびユーザーがログオフしたときにすべての変更を破棄するように構成されているシングルセッションOS VDAの場合、システム起動時にGenRandomQMID.ps1スクリプトを使用してQMIdを変更します。ユーザーのログオン試行前に十分なVDAが実行されていることを確認するために、電源管理戦略を変更します。

GenRandomQMID.ps1スクリプトを使用するには、次の手順を実行します。

  1. PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認します。

    Set-ExecutionPolicy RemoteSigned

  2. スケジュールされたタスクを作成し、トリガーをシステム起動時に設定し、PVSまたはMCSマスターイメージマシンでSYSTEMアカウントで実行します。

  3. コマンドをスタートアップタスクとして追加します。

    powershell .exe -file C:\\GenRandomQMID.ps1

GenRandomQMID.ps1スクリプトに関する概要:

  1. レジストリから現在のQMIdを削除します。
  2. SysPrep = 1HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parametersに追加します。
  3. CitrixSmAudAgentおよびMSMQを含む関連サービスを停止します。
  4. ランダムなQMIdを生成するには、以前に停止したサービスを開始します。

Example GENRANDOMQMID.PS1:

# Remove old QMId from registry and set SysPrep flag for MSMQ

Remove-Itemproperty -Path HKLM:Software\Microsoft\MSMQ\Parameters\MachineCache -Name QMId -Force

Set-ItemProperty -Path HKLM:Software\Microsoft\MSMQ\Parameters -Name "SysPrep" -Type DWord -Value 1

# Get dependent services

$depServices = Get-Service -name MSMQ -dependentservices | Select -Property Name

# Restart MSMQ to get a new QMId

Restart-Service -force MSMQ

# Start dependent services

if ($depServices -ne $null) {

    foreach ($depService in $depServices) {

        $startMode = Get-WmiObject win32_service -filter "NAME = '$($depService.Name)'" | Select -Property StartMode

         if ($startMode.StartMode -eq "Auto") {

             Start-Service $depService.Name
         }
}

}
<!--NeedCopy-->

Session Recordingプレイヤーをインストールする

Session Recording Playerは、ワークステーションからアクセスして記録されたセッションファイルを再生するためのユーザーインターフェイスです。Session Recording Playerは、Session Recordingサーバーまたはドメイン内のワークステーションにインストールします。

ヒント:

  • セッションレコーディングサーバーをインストールすると、セッションレコーディングWeb Playerを自動的にインストールできます。
  • セッションレコーディングPlayerをインストールする前または後に、VC_redist.x86.exeという名前のMicrosoft Visual C++再頒布可能パッケージをインストールします。このパッケージは、Citrix Virtual Apps and Desktops ISOの\Support\VcRedistにあります。

ステップ1:製品ソフトウェアをダウンロードし、ウィザードを起動します

Session Recording Playerコンポーネントをインストールするマシンに、ローカル管理者アカウントを使用してログオンします。DVDをドライブに挿入するか、ISOファイルをマウントします。インストーラーが自動的に起動しない場合は、AutoSelectアプリケーションまたはマウントされたドライブをダブルクリックします。

インストールウィザードが起動します。

ステップ2:インストールする製品を選択します

インストールする製品を選択します(/ja-jp/session-recording/2509/media/install-player-1.png)

製品の横にある[開始]をクリックして、Citrix Virtual AppsまたはCitrix Virtual Desktopsをインストールします。

ステップ3:セッションレコーディングを選択します

セッションレコーディングを選択します(/ja-jp/session-recording/2509/media/install-player-2.png)

セッションレコーディングエントリを選択します。

ステップ4:ライセンス契約を読み、同意します

インストール契約(/ja-jp/session-recording/2509/media/install-player-3.png)

[ソフトウェアライセンス契約]ページで、ライセンス契約を読み、同意して、[次へ]をクリックします。

ステップ5:インストールするコンポーネントとインストール場所を選択します

プレーヤーのインストールを選択します(/ja-jp/session-recording/2509/media/install-player-3-select.png)

セッションレコーディングプレイヤーを選択し、次へをクリックします。

ステップ6:前提条件を確認し、インストールを確定します

プレーヤーのインストール概要(/ja-jp/session-recording/2509/media/install-player-4-confirm-installation.png)

Summaryページには、インストールオプションが表示されます。Backをクリックして前のウィザードページに戻り変更を加えるか、Installをクリックしてインストールを開始できます。

ステップ7:インストールを完了します

プレーヤーのインストールが完了しました(/ja-jp/session-recording/2509/media/install-player-7-install-complete.png)

Finish Installationページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

Finishをクリックして、Session Recordingプレーヤーのインストールを完了します。

メッセージキューイングソリューションを選択する

Session Recordingのデフォルトのメッセージキューは、Microsoft Message Queue (MSMQ) です。Session Recordingは、MSMQの代替としてSession Recordingメッセージキューを提供します。そのインストールと構成については、このセクションで詳しく説明します。アクティブなメッセージキューは、レジストリ設定を使用して変更できます。

MSMQ (エムエスエムキュー)

MSMQのユーザーは、Session Recordingのインストール後にアクセス制御リスト (ACL) を構成することをお勧めします。詳細については、「セキュリティに関する推奨事項」を参照してください。

セッションレコーディングメッセージキュー

セッション録画メッセージキューソリューションは、以下の方法でセッション録画の機能を強化するように設計されています。

  • 最新の.NET環境をサポート: WebSocketとnats.io上に構築されており、MSMQで必要とされる.NET Frameworkへの依存関係を排除します。
  • 強化された機能を提供: 永続ストレージ、複数の認証方法、SSL暗号化、およびさまざまな構成オプションを提供します。
  • 認証の柔軟性を向上: Azure ADまたはその他の非ADシナリオに対して、より優れた認証オプションをサポートします。

セッション録画メッセージキューのインストールと構成

  1. セッション録画メッセージキューのインストールと構成を進めるには、以下の前提条件が満たされていることを確認してください。
    • 管理者権限が必要です。
    • セッション録画メッセージキューをインストールする前に、https://dotnet.microsoft.com/ja-jp/download/dotnet/8.0から.NET 8 Runtimeをインストールする必要があります。
    • デフォルトで2つの新しいTCPポート、8221と8223がファイアウォールを通過できるようにする必要があります。
    • SSL暗号化されたWebSocket通信には証明書が必要です。
  2. SessionRecordingAdministrationx64.msiを実行してセッション録画サーバーをインストールします。次に、セッション録画サーバーでservices.mscを実行し、セッション録画メッセージキューサービスのスタートアップの種類を自動に変更してサービスを開始します。

    セッション録画メッセージキューサービスのスタートアップの種類

  3. セッション録画サーバーで、wf.msc (セキュリティが強化されたWindows Defender ファイアウォール) を実行し、ポート8221および8223での受信TCPトラフィックを許可する受信規則を追加します。(ポート番号は、以下の「オプションの構成」セクションで説明されているように変更できます。)

    ポート8221および8223での受信TCPトラフィックを許可する

  4. VDAで、ISOファイルからのメタインストーラーを使用するか、SessionRecordingAgentx64.msiを直接実行して、セッション録画エージェントをインストールします。

    環境でSession Recordingメッセージキューのみを使用し、MSMQに切り替えない場合は、Session Recordingエージェントのインストール中に「MSMQのインストールをスキップ」オプションを選択できます。これにより、以下が保証されます。

    • メタインストーラーによってVDAにMSMQがインストールされません。

    • Session Recordingエージェントサービスは、MSMQの依存関係で構成されません。

    エージェントのインストールが完了したら、ISOファイルからSessionRecordingMsgQueue.msiを実行して、Session Recordingメッセージキューを展開します。

    注:

    SessionRecordingMsgQueue.msiをインストールする際は、デフォルトのインストールパスを使用することをお勧めします。カスタムパスに切り替えると、MSIのアップグレード機能が期待どおりに動作しない場合があります(アップグレード中にデフォルトパスに戻るなど)。カスタムパスでアップグレードする場合は、まずソフトウェアをアンインストールしてから再インストールする必要がある場合があります。

    セッションレコーディング メッセージキュー MSI(/ja-jp/session-recording/2509/media/session-recording-message-queue-msi.png)

  5. VDAを再起動します。
  6. Session Recordingの権限、ポリシー、およびその他の設定を構成します。記録されたセッションは、Session Recordingメッセージキューを介して送信できるようになります。

オプションの構成

SSL暗号化の使用
  1. Session Recordingサーバーで、証明書をポート8223にバインドします。たとえば、次のコマンドを使用して、証明書のサムプリントを入力し、ポート8223にバインドします。

    netsh http add sslcert ipport=0.0.0.0:8223 certhash=CertThumbprint appid={NewGuid}
    <!--NeedCopy-->
    

    注:

    appidのGUID値は、GUID形式に準拠し、中括弧で囲まれた大文字の文字列です。certhash値は、証明書の詳細にあるサムプリント値から取得され、大文字と小文字が区別されます。

  2. VDA上で、レジストリパスComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\MsgQueueにある設定について、OutboundPortの値を8223に、OutboundUseSSLの値を1に、そしてOutboundFQDNの値を証明書によってサポートされているFQDN(例:SessionRecordingServer.bvt.local)にそれぞれ変更してください。この項目が未入力のままの場合、Active Directoryドメイン内で解決されるIPアドレスが自動的に使用されます。

    VDA上のSession Recordingメッセージキューのレジストリキー値(/ja-jp/session-recording/2509/media/session-recording-message-queue-registry-key-values-on-vda.png)

  3. VDAを再起動するか、VDA上のCitrixSmAudMsgQueueサービスを再起動します。

ポート番号を変更する
  1. セッションレコーディングサーバーで、レジストリComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Serverに、HTTPポート用にSmAudMsgQueueServerPort、HTTPSポート用にSmAudMsgQueueServerHTTPSPortという名前のDWORD型キーを追加します。また、変更されたポートを介したトラフィックを許可するように、ファイアウォールの受信規則を追加します。キーを追加した後、セッションレコーディングサーバーを再起動するか、サーバー上のCitrixSsRecMsgQueueサービスを再起動します。

    セッションレコーディングメッセージキューのポート(/ja-jp/session-recording/2509/media/session-recording-message-queue-ports.png)

  2. VDA上で、レジストリパスComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\MsgQueueにあるOutboundPortキーの値を変更してください。OutboundUseSSLが0に設定されている場合はHTTPポートを、OutboundUseSSLが1に設定されている場合はHTTPSポートをそれぞれ構成します。このキーの値を変更した後は、VDAを再起動するか、VDA上で動作しているCitrixSmAudMsgQueueサービスを再起動してください。

認証モードを変更する
  1. デフォルトでは、セッションレコーディングのメッセージキューは、セッションレコーディングサーバーとVDAとの間でActive Directory (AD)ドメイン認証を利用します。

  2. Session Recordingサーバーで、次のレジストリパスに移動します。 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server 次のいずれかの値を持つSmAudMsgQueueServerAuthという名前の新しいDWORDキーを追加します。

    • 0:認証なし(検証なしですべてのメッセージを受け入れる)— 非推奨

    • 1:デフォルトのADドメイン認証

    • 2: シトリックスクラウド認証(アジュールADシナリオに必要)

    キーを追加した後、セッションレコーディングサーバーまたはCitrixSsRecMsgQueueサービスを再起動します。

  3. VDAで、レジストリComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\MsgQueue, modify the OutboundAuthMethodキーの値を、Session RecordingサーバーのSmAudMsgQueueServerAuthと同じ値に設定して変更します。キーを変更した後、VDAを再起動するか、VDA上のCitrixSmAudMsgQueueサービスを再起動します。

トラブルシューティング

通信の不具合
  1. セッションレコーディングサーバー上で、CitrixSsRecMsgQueueサービスおよびCitrixSsRecStorageManagerサービスが実行状態にあることを確認してください。
  2. Check whether the CitrixSmAudAgent, CitrixSmAudMsgQueue, and CitrixSmAudNatsServer services are in a running state on the VDA.
  3. Session Recordingサーバーのファイアウォールで、ポート8221と8223が許可されているか確認します。
  4. VDAでOutboundFQDNが構成されているか確認します。空の場合、サーバーのIPアドレスはADドメイン内で自動的に解決されます。Azure Active DirectoryシナリオおよびSSL暗号化シナリオでは、このフィールドにSession Recordingサーバーの実際のFQDNを入力する必要があります。
  5. VDAのOutboundUseSSLレジストリキーの値が1に設定されているか確認します。1に設定されている場合、Session Recordingサーバーにポート8223にバインドされた証明書があるか確認します。
  6. VDAおよびSession Recordingサーバーでデフォルトポートが変更されているか確認します。ポートが変更されている場合、変更されたポートがファイアウォールで許可されているか、および証明書がそれらにバインドされているか確認します。
  7. VDAおよびSession Recordingサーバーでデフォルトの認証モードが変更されているか確認します。認証モードが変更されている場合、OutboundAuthMethodの値とSmAudMsgQueueServerAuthの値が同じであるか確認します。
VDA の CitrixSmAudMsgQueue サービスが起動することができません
  1. VDAに.NET 8 Runtimeがインストールされているか確認します。
  2. SessionRecordingMsgQueue.msiのインストール時に管理者権限があるか確認します。
MSMQサービスを停止できない、またはMSMQ機能を無効にできない
  1. VDAで、レジストリComputer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixSmAudAgentDependOnServiceキーからMSMQを削除し、残りは変更せずにOKをクリックしてからVDAを再起動します。

    **デペンドオンサービス**キーから**エムエスエムキュー**を削除する

インストールの自動化

Session Recordingは、オプションを指定したサイレントインストールをサポートしています。

Session Recording管理コンポーネントのインストールを自動化する

単一のコマンドを使用して、Session Recording管理コンポーネントの完全なセットをインストールする

Session Recordingは、さまざまな種類のSQL認証をサポートするようになりました。詳細については、次の表を参照してください。

セッションレコーディング バージョン サポートされているSQL Serverの種類 サポートされているSQL認証方法
2411未満




  • オンプレミスSQL Server
  • アジュール エスキューエル データベース
  • Azure SQL マネージド インスタンス
  • アジュール仮想マシン上のSQL Server
SQLサーバー 認証




詳細については、「クラウドSQLデータベースサービスへのSession Recordingデータベースのインストール」を参照してください。




該当なし - AWS RDS
  • グーグルクラウド エスキューエルサーバー
  • 2411以降




    • オンプレミスSQL Server
    • アジュール SQL データベース
    • Azure SQL マネージド インスタンス
    • Azure 仮想マシン上の SQLサーバー
    • エスキューエルサーバー認証
    • クラウド管理Entra IDアカウントによるMicrosoft Entra IDパスワード認証



    Microsoft Entra ID パスワード認証は、Azure SQL データベース および Azure SQL マネージド インスタンス のみをサポートしています。詳細については、Azure SQL データベースへのSession RecordingデータベースのインストールおよびAzure SQL マネージド インスタンスまたはAWS RDSへのSession Recordingデータベースのインストールを参照してください。




    該当なし - AWS RDS
  • グーグル クラウド エスキューエル サーバー
  • 2507 以降




    • オンプレミス SQL Server
    • アジュール SQL データベース
    • Azure SQL マネージド インスタンス
    • アジュール仮想マシン上のエスキューエルサーバー
    • AWS アールディーエス
    • グーグル クラウド SQL サーバー
    • SQLサーバー認証
    • Microsoft Entra ID パスワード認証 (クラウド管理の Entra ID アカウントを使用)
    • Microsoft Entra ID サービスプリンシパル認証 (クラウド管理の Entra ID アカウントを使用)


    • Microsoft Entra ID パスワード認証は、Azure SQL データベース および Azure SQL マネージド インスタンス でのみサポートされます。
    • Microsoft Entra ID サービスプリンシパル認証 (Azure SQL マネージド インスタンスのみサポート)



    例えば、以下のいずれかのコマンドを実行すると、Session Recording管理コンポーネントの完全なセットがインストールされ、インストール情報をキャプチャするためのログファイルが作成されます。

    msiexec /i "c:\SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="WNBIO-SRD-1" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" DATABASEUSER="localhost" /q /l*vx "yourinstallationlog"
    <!--NeedCopy-->
    
    msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" DATABASEUSER="localhost" CLOUDDBSUPPORT="0" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1" SERVICEKEYAUTHENABLE="1" /qn+ /l*vx "yourinstallationlog"
    <!--NeedCopy-->
    
    msiexec /i "SessionRecordingAdministrationx64.msi"
    ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase"
    DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1"
    CLOUDDBSUPPORT="0"
    AZUREUSERNAME="ServicePrincipalClientId" AZUREPASSWORD="ServicePrincipalClientsecret"
    AADPASSWORD="0"
    AZURETENANTID="ServicePrincipalTenantId"
    SERVICEPRINCIPAL="1" /qn+ /l*vx "yourinstallationlog "
    <!--NeedCopy-->
    

    注:

    SessionRecordingAdministrationx64.msi ファイルは、シトリックス バーチャル アップス アンド デスクトップス アイエスオー の \x64\Session Recording にあります。

    ここでDATABASEINSTANCEで指定されたインスタンスに関わらず、2411リリース以降、Session Recording管理ログデータベースをSession Recordingデータベースとは別のインスタンスにインストールすることも選択できます。これを行うには、インストールコマンドのいずれかを実行する前に、以下の手順を完了してください。

    1. Session Recordingサーバーをインストールするマシンに移動します。
    2. レジストリエディターを開きます。
    3. レジストリを変更します。
      • HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Serverに移動します。
      • SmAudDatabaseLoggingState DWORD (32ビット) 値を追加し、値のデータを1に設定します。
      • SmAudDatabaseLoggingInstance値を追加し、値のデータを、Session Recording管理ログデータベースをインストールするインスタンス名に設定します。

      後でデータベースをインストールするときに、Session Recording 管理ログデータベースは、SmAudDatabaseLoggingInstance レジストリ値で指定された別のインスタンスにインストールされます。両方のデータベースに同じ認証モード(SQL Server 認証、Windows 認証、または Microsoft Entra ID 認証)を設定し、同じユーザー権限を付与する必要があります。

    各項目の説明:

    • ADDLOCAL は、選択可能な機能を提供します。複数のオプションを選択できます。SsRecServer はセッションレコーディング サーバーです。PolicyConsole はセッションレコーディング ポリシーコンソールです。SsRecLogging は管理者ログ機能です。StorageDatabase はセッションレコーディング データベースです。セッションレコーディング 管理者ログは、セッションレコーディング サーバーのオプションのサブ機能です。セッションレコーディング 管理者ログを選択する前に、セッションレコーディング サーバーを選択してください。
    • DATABASEINSTANCE は、Session Recording データベースのインスタンス名です。たとえば、Azure SQL Managed Instance を使用している場合は .\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name または tcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342 です。前述のとおり、Session Recording データベースと Session Recording 管理ログデータベースは、同じインスタンスまたは別のインスタンスにインストールできます。
    • DATABASENAME は、セッションレコーディング データベースのデータベース名です。
    • LOGGINGDATABASENAME は、管理者ログデータベースの名前です。
    • AZURESQLSERVICESUPPORT は、SQL Server 認証がサポートされているかどうかを決定します。SQL Server 認証を使用するには、1 に設定します。
    • DATABASEUSER は、Session Recording サーバーが使用するコンピュータアカウントです。
    • CLOUDDBSUPPORT は、Azure SQL Database がサポートされているかどうかを決定します。
    • AZUREUSERNAME は、SQL Server または Microsoft Entra ID の管理者名、あるいは Microsoft Entra ID サービスプリンシパル クライアント ID (アプリケーション ID) です。Microsoft Entra ID 認証を使用するには、次の手順を完了してください。

      1. Visual C++ Redistributable が Session Recording サーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/cpp/windows/latest-supported-vc-redist?view=msvc-170 からダウンロードしてインストールしてください。
      2. Microsoft ODBC Driver for SQL Server が Session Recording サーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16 からダウンロードしてインストールしてください。
      3. データベースインストールコマンドを実行するときに、AADPASSWORD パラメーターを含め、その値を 1 に設定します。
      4. Entra ID 管理者を作成し、SQL Server 管理権限を付与します。詳細については、Microsoft ドキュメントを参照してください: https://learn.microsoft.com/ja-jp/azure/azure-sql/database/authentication-aad-configure?view=azuresql&tabs=azure-powershell
    • AZUREPASSWORD は、SQLサーバー または Microsoft Entra ID の管理者パスワード、または Microsoft Entra ID のサービスプリンシパルのクライアントシークレットです。
    • AADPASSWORD は、Microsoft Entra ID 認証がサポートされているかどうかを決定します。Microsoft Entra ID 認証を使用するには、これを 1 に設定します。
    • AZURETENANTID は Azure のテナント識別子 (ディレクトリ識別子) です。
    • SERVICEPRINCIPAL は、Microsoft Entra ID ServicePrincipal 認証がサポートされているかどうかを決定します。この認証を使用するには、1 に設定します。
    • SERVICEKEYAUTHENABLE は、Session Recording エージェントと Session Recording サーバー間のサービスキー認証を有効にします。このパラメーターは、Azure AD サポートを有効にする場合にのみ必要であり、**1** に設定する必要があります。それ以外の場合は、このパラメーターを追加しないでください。
    • /q はサイレントモードを指定します。
    • /l*v は詳細ログを有効にします。
    • yourinstallationlog は、インストールログファイルの場所です。

    Session Recording サーバーを展開するためのマスターイメージを作成する

    既存の展開から Session Recording データベースと管理ログデータベースがすでに配置されている場合があります。このようなシナリオでは、SessionRecordingAdministrationx64.msi を使用して Session Recording 管理コンポーネントをインストールする際に、データベースチェックを省略できるようになりました。Session Recording サーバーを他の多くのマシンに簡単に展開するためのマスターイメージを作成できます。マスターイメージを使用してターゲットマシンに Session Recording サーバーを展開した後、各マシンでコマンドを実行して、既存の Session Recording データベースと管理ログデータベースに接続します。このマスターイメージのサポートにより、展開が容易になり、人為的ミスの潜在的な影響が最小限に抑えられます。これは新規インストールにのみ適用され、次の手順で構成されます。

    1. コマンドプロンプトを起動し、次のようなコマンドを実行します。

      msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="sqlnotexists" DATABASENAME="CitrixSessionRecording2" LOGGINGDATABASENAME="CitrixSessionRecordingLogging2" DATABASEUSER="localhost" /q /l*vx "c:\WithLogging.log" IGNOREDBCHECK="True"
      <!--NeedCopy-->
      

      このコマンドは、Session Recording データベースと管理ログデータベースへの接続を構成およびテストすることなく、Session Recording 管理コンポーネントをインストールします。

      IGNOREDBCHECK パラメーターの値を True に設定してください。そして、DATABASEINSTANCEDATABASENAME、および LOGGINGDATABASENAME には、それぞれ任意の値を指定するようにしてください。

    2. 操作しているマシン上にマスターイメージを作成します。

    3. Session Recording サーバーを展開するために、マスターイメージを他のマシンに展開します。

    4. 各マシンで、次のようなコマンドを実行します。

      .\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME
      
      iisreset /noforce
      <!--NeedCopy-->
      

      これらのコマンドは、以前にインストールされたSession Recordingサーバーを、既存のSession Recordingデータベースおよび管理ログデータベースに接続します。

      \Citrix\SessionRecording\Server\bin\SsRecUtils.exeファイルを見つけることができます。必要に応じて、DATABASEINSTANCEDATABASENAME、およびLOGGINGDATABASENAMEパラメーターを設定します。

    Session Recording管理コンポーネントをアンインストールする際にデータベースを保持する

    KEEPDBTrueに設定すると、Session Recording管理コンポーネントをアンインストールする際に、以下のコマンドがSession Recordingデータベースと管理ログデータベースを保持します。

    msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"
    <!--NeedCopy-->
    

    Session RecordingプレーヤーおよびWebプレーヤーのインストールを自動化する

    たとえば、以下のコマンドはSession RecordingプレーヤーとWebプレーヤーをそれぞれインストールします。

    msiexec /i "c:\SessionRecordingPlayer.msi" /q /l*\vx "yourinstallationlog"
    <!--NeedCopy-->
    
    msiexec /i "c:\SessionRecordingWebPlayer.msi" /q /l*vx "yourinstallationlog"
    <!--NeedCopy-->
    

    注:

    シトリックス バーチャル アプリケーションズ アンド デスクトップス ISOの\x86\Session RecordingSessionRecordingPlayer.msiがあります。

    シトリックス バーチャル アプリケーションズ アンド デスクトップス ISOの\x64\Session RecordingSessionRecordingWebPlayer.msiがあります。

    ここで、

    • /qはサイレントモードを指定します。
    • /l*vは詳細ログを有効にします。
    • yourinstallationlogは、インストールログファイルの場所です。

    Session Recordingエージェントのインストールを自動化する

    たとえば、以下のコマンドはSession Recordingエージェントをインストールし、インストール情報をキャプチャするためのログファイルを作成します。

    msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
    SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport SESSIONRECORDINGAUTHENTICATION="Citrix Cloud" SESSIONRECORDINGRPC="Websocket" SESSIONRECORDINGIDP="IDP"
    <!--NeedCopy-->
    

    注:

    SessionRecordingAgentx64.msiは、シトリックス バーチャルアプリおよびデスクトップ ISOの\x64\Session Recordingにあります。

    説明:

    • yourservernameは、Session RecordingサーバーをホストするマシンのNetBIOS名またはFQDNです。指定しない場合、この値はデフォルトでlocalhostになります。
    • yourbrokerprotocol は、セッションレコーディングエージェントがセッションレコーディングブローカーと通信するために使用するHTTPまたはHTTPSです。指定されていない場合、この値はHTTPSに既定で設定されます。
    • yourbrokerportは、Session RecordingエージェントがSession Recording Brokerと通信するために使用するポート番号です。指定しない場合、この値はデフォルトでゼロになり、Session Recordingエージェントは選択したプロトコルのデフォルトポート番号(HTTPの場合は80、HTTPSの場合は443)を使用するように指示されます。
    • SESSIONRECORDINGAUTHENTICATIONは、Session RecordingエージェントとSession Recordingサーバー間の認証タイプです。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要です。Azure ADサポートを有効にするには、このパラメーターを追加し、Citrix Cloudに設定します。
    • SESSIONRECORDINGRPCは、Session RecordingエージェントとSession Recordingサーバー間の通信方法です。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要です。Azure ADサポートを有効にするには、このパラメーターを追加し、Websocketに設定します。
    • SESSIONRECORDINGIDPは、IDタイプを指定します。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要です。Azure ADサポートを有効にするには、このパラメーターを追加し、IDPに設定します。
    • /qはサイレントモードを指定します。
    • /l*vは詳細ログ記録を指定します。
    • yourinstallationlogは、インストールログファイルの場所です。

    セッションレコーディングのアップグレード

    新しいマシンやサイトを最初にセットアップすることなく、特定の展開を新しいバージョンにアップグレードできます。XenAppおよびXenDesktop 7.6 LTSRの最新CUに含まれるSession Recordingのバージョン、およびそれ以降の任意のバージョンから、Session Recordingの最新リリースにアップグレードできます。

    注:

    Session Recording Administration を 7.6 から 7.13 以降にアップグレードし、Session Recording Administration で 「変更」 を選択して管理者ログサービスを追加すると、「管理者ログ構成」ページに SQL Server インスタンス名が表示されません。「次へ」 をクリックすると、次のエラーメッセージが表示されます: 「データベース接続テストに失敗しました。正しいデータベースインスタンス名を入力してください。」 回避策として、localhost ユーザーに次の SmartAuditor Server レジストリフォルダーへの 読み取り 権限を追加してください: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server

    テクニカルプレビューバージョンからアップグレードすることはできません。

    要件、準備、および制限事項

    • Session Recording コンポーネントをインストールしたマシンで、Session Recording インストーラーのグラフィカルインターフェイスまたはコマンドラインインターフェイスを使用して、Session Recording コンポーネントをアップグレードします。
    • アップグレード作業を行う前に、SQL Server インスタンス内の CitrixSessionRecording という名前のデータベースをバックアップしてください。これにより、データベースのアップグレード後に問題が発見された場合でも復元できます。
    • ドメインユーザーであることに加えて、Session Recording コンポーネントをアップグレードするマシンではローカル管理者である必要があります。
    • Session Recording サーバーと Session Recording データベースが同じサーバーにインストールされていない場合、Session Recording データベースをアップグレードするにはデータベースロール権限が必要です。そうでない場合は、次のいずれかの方法で対応できます。
      • データベース管理者に、アップグレードのために securityadmin および dbcreator サーバーロール権限を割り当てるよう依頼します。アップグレードが完了した後、securityadmin および dbcreator サーバーロール権限は不要になり、安全に削除できます。
      • または、SessionRecordingAdministrationx64.msi パッケージを使用してアップグレードします。msi アップグレード中に、securityadmin および dbcreator サーバーロール権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、「OK」 をクリックしてアップグレードを続行します。
    • すべての Session Recording エージェントを同時にアップグレードしないことを選択できます。Session Recording エージェント 7.6.0(およびそれ以降)は、Session Recording サーバーの最新(現行)リリースと互換性があります。ただし、一部の新機能やバグ修正は有効にならない場合があります。
    • Session Recording サーバーのアップグレード中に開始されたセッションは記録されません。
    • Session Recording エージェントのプロパティにある Graphics Adjustment オプションは、デスクトップコンポジションリダイレクトモードとの互換性を保つため、新規インストールまたはアップグレード後にデフォルトで有効になります。新規インストールまたはアップグレード後に、このオプションを手動で無効にすることができます。
    • 管理者ログ機能は、以前のリリースでこの機能が利用できなかった Session Recording をアップグレードした後にはインストールされません。この機能を追加するには、アップグレード後にインストールを変更してください。
    • アップグレードプロセス開始時にライブ記録セッションがある場合、記録が完了する可能性はほとんどありません。
    • 潜在的な停止を計画し、軽減できるように、次のアップグレードシーケンスを確認してください。

    アップグレードの順序

    既存のインストールをアップグレードするには、Session Recordingコンポーネントがインストールされている各マシンに移動し、Citrix Virtual Apps and Desktops ISOを実行します。

    ヒント:

    適切なバージョンのシトリックス バーチャル アプリ アンド デスクトップをダウンロードするには、Citrix Virtual Apps and Desktopsダウンロードページにアクセスしてください。

    既存のインストールをアップグレードする手順は、通常、次の順序で行われます。

    1. Session Recordingサーバーコンポーネントをアップグレードします。

      Session Recordingサーバーが複数ある場合は、まずSession Recordingデータベースコンポーネントがインストールされているサーバーをアップグレードします。その後、残りのSession Recordingサーバーをアップグレードします。

      そのためには、次の手順を実行します。

      1. セッション記録サーバーで、セッション記録ストレージ管理サービスを手動で停止します。
      2. Internet Information Services (IIS) マネージャーを通じて、セッション記録仲介が稼働していることを確認します。
      3. Citrix Virtual Apps and Desktops ISO を実行し、セッションレコーディング の項目を選択してアップグレードします。
    2. Session Recordingサーバーのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
    3. Session Recordingエージェントをアップグレードします(マスターイメージ上)。
    4. Session Recordingサーバーと同時に、またはその後にSession Recordingポリシーコンソールをアップグレードします。
    5. Session Recordingプレーヤーをアップグレードします。

    バージョン2511へのアップグレードに関する重要な注意点:

    Session Recordingエージェントの不完全なアップグレードによるセッション記録の失敗を防ぐため、2511にアップグレードする際は以下の手順に従ってください。

    各Session Recordingサーバーをバージョン2511にアップグレードします。

    次のコマンドを使用して、.NET Remotingによるリモートアクセスを有効にします。

    <SessionRecordingserverinstallationpath>\Bin\SsRecUtils.exe -EnableBrokerRemoting

    各Session Recordingエージェントをバージョン2511にアップグレードします。

    すべてのSession Recordingエージェントがアップグレードされたら、次のコマンドを使用して、.NET Remotingによるリモートアクセスを無効にします。

    <SessionRecordingserverinstallationpath>\Bin\SsRecUtils.exe -DisableBrokerRemoting

    クラウドSQLデータベースサービスへのSession Recordingデータベースのインストール

    このセクションでは、以下のクラウドSQLデータベースサービスにSession Recordingデータベースをインストールする方法について説明します。

    • アジュール SQL データベース
    • Azure SQL マネージド インスタンス
    • アジュール仮想マシン上のSQLサーバー
    • エーダブリューエス アールディーエス
    • グーグル クラウド SQL サーバー

    Azure SQL Database にセッション録画データベースをインストールする

    1. Azure SQL データベースを作成します。

      1. Azure アカウントを使用して Azure ポータルにサインインします。
      2. ポータルメニューから、[リソースの作成] を選択します。
      3. ポータルの検索ボックスに「SQL database」と入力します。
      4. 検索結果のリストから、[SQL databases] を選択します。
      5. [作成] をクリックして Azure SQL Database を作成します。
      6. [SQL Database の作成] セクションで、次の情報を入力します。

        • [サブスクリプション]: 目的の Azure サブスクリプションを選択します。
        • [リソースグループ]: [新規作成] を選択するか、既存のリソースグループを選択します。
        • [データベース名]: 一意の名前が必要です。
        • [サーバー]: [新規作成] を選択し、[新しいサーバー] フォームに次の値を入力します。
          • [サーバー名]: 一意の名前を入力します。サーバー名は、Azure 内のすべてのサーバーでグローバルに一意である必要があります。
          • [場所]: ドロップダウンリストから場所を選択します。
          • [認証方法]: SQL 認証、Entra ID 認証、またはその両方を使用することを選択します。
          • サーバー管理者ログイン: SQL ServerまたはMicrosoft Entra IDの管理者名を入力します。2411以降、Session RecordingはAzure SQL DatabaseおよびAzure SQL Managed Instanceを含むクラウドベースのSQLデータベースのEntra ID認証をサポートします。Microsoft Entra ID認証の詳細については、この記事のコマンドパラメーターの説明を参照してください。
          • パスワード: 要件を満たすSQL ServerまたはMicrosoft Entra IDの管理者パスワードを入力し、パスワードの確認フィールドにもう一度入力します。
          • OKを選択します。

        上記の情報を入力したら、確認 + 作成をクリックします。作成ボタンをクリックしてAzure SQL Databaseを完了します。

    2. 手順1を繰り返して、同じサーバー上に別のAzure SQL Databaseを作成します。
    3. 作成したAzure SQL Databaseのサーバー接続文字列を取得します。
      1. Azureポータルで、作成したAzure SQL Databaseのいずれかを検索してクリックします。
      2. 左側のナビゲーションから接続文字列をクリックします。
      3. 後でSession RecordingデータベースおよびSession Recordingログデータベースのインスタンス名として使用するサーバー文字列を記録しておきます。
    4. 以前に作成したAzure SQL DatabaseにSession Recordingデータベースをインストールするには、次のようなコマンドを実行します。

      注:

      Azure SQL Databaseでは、Session Recordingデータベースのインストールは、次のようなコマンドを実行することによってのみ行うことができます。

      msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" DATABASEUSER="localhost" CLOUDDBSUPPORT="1" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1" /qn+ /l*vx "yourinstallationlog"

      ここで、

      • ADDLOCAL は、選択できる機能を提供します。複数のオプションを選択できます。SsRecServer はセッションレコーディングサーバーです。PolicyConsole はセッションレコーディングポリシーコンソールです。SsRecLogging は管理者ログ機能です。StorageDatabase はセッションレコーディングデータベースです。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
      • DATABASEINSTANCE は、Azure SQL データベース接続文字列で指定されるセッションレコーディングデータベースのインスタンス名です。
      • DATABASENAME は、セッション記録データベースのデータベース名です。
      • LOGGINGDATABASENAME は、管理者ログデータベースの名前です。
      • AZURESQLSERVICESUPPORT は、SQL Server 認証がサポートされているかどうかを決定します。SQL Server 認証を使用するには、これを 1 に設定します。
      • CLOUDDBSUPPORT は、Azure SQL Database がサポートされているかどうかを決定します。
      • DATABASEUSER は、セッション記録サーバーのコンピューターアカウントです。
      • AZUREUSERNAME は、SQL Server または Microsoft Entra ID の管理者名です。2411 以降、セッションレコーディングは、Azure SQL Database および Azure SQL Managed Instance を含むクラウドベースのSQLデータベースにおけるEntra IDによる認証をサポートしています。Microsoft Entra IDによる認証を使用するには、次の手順を完了してください。

        1. Visual C++ Redistributable が Session Recording サーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/cpp/windows/latest-supported-vc-redist?view=msvc-170 からダウンロードしてインストールしてください。
        2. Microsoft ODBC Driver for SQL Server が Session Recording サーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16 からダウンロードしてインストールしてください。
        3. データベースインストールコマンドの実行時に、AADPASSWORD パラメーターを含め、1 に設定します。
        4. Entra ID 管理者を作成し、SQL Server 管理権限を付与します。詳細については、Microsoft ドキュメントを参照してください: https://learn.microsoft.com/ja-jp/azure/azure-sql/database/authentication-aad-configure?view=azuresql&tabs=azure-powershell
      • AZUREPASSWORD is the SQL Server or Microsoft Entra ID administrator password.
      • AADPASSWORD は、Microsoft Entra ID 認証がサポートされているかどうかを決定します。Microsoft Entra ID 認証を使用するには、これを 1 に設定します。
      • /q は、サイレントモードを指定します。
      • /l*v は、詳細ログを有効にします。
      • yourinstallationlog は、インストールログファイルの場所です。

    Azure SQL Managed Instance または AWS RDS に セッションレコーディング データベースをインストールする

    ヒント:

    Azure SQL Managed Instance および AWS RDS では、セッションレコーディング データベースを次の方法でインストールできます。

    • Double-clicking and running the SessionRecordingAdministrationx64.msi package.

    • 次のようなコマンドを実行する。

       msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString "DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" CLOUDDBSUPPORT="1" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1"/qn+ /l*vx "yourinstallationlog"
       <!--NeedCopy-->
      
    1. Azure SQL マネージド インスタンスを作成するか、Amazon RDS コンソール経由で SQL Server インスタンスを作成します。

    2. (Azure SQL のみ) プロパティパネルに表示される Server 文字列を記録しておきます。これらの文字列は、Session Recording データベースのインスタンス名です。例については、次のスクリーンショットを参照してください。

      Server 文字列の例

    3. (AWS RDS のみ) Endpoint および Port 情報を記録しておきます。これは、データベースのインスタンス名として、<Endpoint, Port> の形式で使用されます。

      AWS RDS インスタンスの構成

    4. セッションレコーディングデータベースをインストールするには、SessionRecordingAdministrationx64.msi を実行します。

      SQL Server 認証を有効にする チェックボックスをオンにし、SQL Server 管理者名とパスワードを入力します。その他の必要な構成を行います。

      SQL Server 管理者資格情報を入力する

      注:

      • SQL Server管理者パスワードを変更した場合は、Session Recordingサーバーのプロパティでパスワードを更新する必要があります。Session Recordingサーバーのプロパティを開くと、エラーメッセージが表示されます。OKをクリックして続行し、Cloud DBタブを選択して、新しいSQL Server管理者パスワードを入力します。Citrix Session Recording Analyticsサービス、Citrix Session Recording Storage Managerサービス、およびIISサービスを再起動します。 SQL Server管理者パスワードを更新

      • Session Recordingは、SQL Server認証に加えて、Azure SQL DatabaseやAzure SQL Managed InstanceなどのクラウドベースのSQLデータベースに対するEntra ID(旧Azure Active Directory)認証をサポートしています。Microsoft Entra ID認証を使用するには、コマンドラインからデータベースをインストールし、この記事で前述した手順に従ってください。

      • Azure AD認証はサポートされていません。

    オンプレミスデータベースをクラウドSQL Managed Instanceに移行する

    1. https://docs.microsoft.com/ja-jp/data-migration/またはhttps://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/migrate-an-on-premises-microsoft-sql-server-database-to-amazon-rds-for-sql-server.htmlに従って、オンプレミスデータベースを移行します。

    2. 移行後にセッションレコーディングが適切に機能するように、セッションレコーディングサーバーで SsRecUtils.exe を実行します。

      C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifyazuredbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} {AzureAdminName}{AzureAdminPassword} iisreset /noforce

    3. セッションレコーディング サーバー上で、Citrix セッションレコーディング アナリティクス サービス、Citrix セッションレコーディング ストレージ マネージャー サービス、および IIS サービスを再起動します。

    本番データベースをAzure SQL Managed Instanceからオンプレミスデータベースに移行する

    1. https://docs.microsoft.com/ja-jp/data-migration/に従ってデータベースを移行します。

    2. 移行後にセッションレコーディングが適切に動作するように、セッションレコーディングサーバーでSsRecUtils.exeを実行します。

      C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifydbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} iisreset /noforce

    3. Session Recordingサーバーで、Citrix セッションレコーディング分析サービス、Citrix セッションレコーディングストレージマネージャーサービス、およびIISサービスを再起動します。

    Azure仮想マシン上のSQL ServerにSession Recordingデータベースをインストールする

    Azure仮想マシン上のSQL Serverでは、SessionRecordingAdministrationx64.msiパッケージをダブルクリックして実行するか、Citrix Virtual Apps and Desktopsインストーラーを使用してセッションレコーディングデータベースをインストールできます。

    1. Azure SQL仮想マシンを確認します。
    2. VM を構成し、セッション録画コンポーネントをインストールするドメインに追加します。
    3. セッション録画データベースのインストール中に、VM の FQDN をインスタンス名として使用します。 注: SessionRecordingAdministrationx64.msi を使用してインストールする場合は、SQL Server 認証を有効にするチェックボックスをオフにします。
    4. インストールユーザーインターフェイスに従って、セッション録画データベースのインストールを完了します。

    Google Cloud SQL Server にセッション録画データベースをインストールする

    ヒント:

    Google Cloud SQL Server では、セッション録画データベースのインストールは、次のコマンドを実行するか、SessionRecordingAdministrationx64.msi パッケージをダブルクリックして実行することで行うことができます。コマンドパラメーターの説明については、この記事の前の自動インストールセクションを参照してください。

    msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
    <!--NeedCopy-->
    

    このセクションでは、シトリックス バーチャル アプリケーションズ アンド デスクトップ ISO の \x64\セッションレコーディング にある SessionRecordingAdministrationx64.msi を使用したインストール方法について詳しく説明します。

    1. グーグル クラウド で SQL Server インスタンスを作成します。

      1. Google Cloud コンソールに移動し、SQL インスタンスページを開きます。
      2. インスタンスを作成をクリックします。例:

        Google Cloud でインスタンスを作成

      3. データベースエンジンとして SQL Server を選択します。

        データベースエンジンとして SQL Server を選択

      4. インスタンス ID フィールドに入力し、ユーザーのパスワードを入力します。パスワードを記録しておきます。インスタンスの SQL Server バージョンを選択します。必要に応じてその他の構成を行います。例:

        インスタンスIDなどを構成する(/ja-jp/session-recording/2509/media/configure-instance-id-and-others.png)

      5. インスタンスにパブリックIPアドレスを割り当て、インスタンスに接続できる承認済みネットワークを設定します。ネットワークフィールドに、Session RecordingサーバーがインストールされているマシンのIPアドレスを入力します。例:

        パブリックIPアドレスとネットワークを割り当てる(/ja-jp/session-recording/2509/media/public-ip-address-and-network.png)

      6. CREATE INSTANCEをクリックして、数分間待ちます。

        インスタンスの概要(/ja-jp/session-recording/2509/media/instance-summary.png)

      7. 新しく作成したインスタンスのページで、パブリックIPアドレスを見つけて記録しておきます。

        パブリックIPアドレスを記録する(/ja-jp/session-recording/2509/media/generated-public-ip-address.png)

      8. SessionRecordingAdministrationx64.msi を実行して、セッションレコーディングデータベースをインストールします。

        インストール中の次のページで、以下の構成を行います。

        • SQL Server認証を有効にするチェックボックスをオンにします。
        • インスタンス名フィールドに、以前作成したSQL ServerインスタンスのパブリックIPアドレスを入力します。
        • SQL Server管理者の名前とパスワードを入力します。

        SQL Server管理者の資格情報を入力する(/ja-jp/session-recording/2509/media/cloud-sql-admin-credentials.png)

    セッションレコーディングのアンインストール

    サーバーまたはワークステーションからSession Recordingコンポーネントを削除するには、Windowsのコントロールパネルから利用できるアンインストールまたはプログラムの削除オプションを使用します。 Session Recordingデータベースを削除するには、インストール時と同じsecurityadminおよびdbcreator SQL Serverロール権限が必要です。

    セキュリティ上の理由から、コンポーネントのアンインストール後も管理者ログデータベースは削除されません。

    シトリックス アナリティクス フォー セキュリティ™ と統合する

    Session Recordingサーバーを構成して、ユーザーイベントをCitrix Analytics for Securityに送信できます。Citrix Analytics for Securityは、ユーザーイベントを処理して、ユーザーの行動に関する実用的な洞察を提供します。

    前提条件

    開始する前に、以下を確認してください。

    • Session Recordingサーバーは、次のアドレスに接続できる必要があります。

    • Session Recording展開では、送信インターネット接続用にポート443が開いている必要があります。ネットワーク上のプロキシサーバーは、Citrix Analytics for Securityとのこの通信を許可する必要があります。

    • シトリックス バーチャル アプリス アンド デスクトップ 7 1912 LTSR を使用している場合、サポートされるセッション レコーディングのバージョンは 2103 以降です。

    セッションレコーディングサーバーをシトリックス アナリティクス フォー セキュリティに接続する

    1. Citrix Cloudにサインインします。

    2. シトリックス アナリティクス フォー セキュリティを見つけて、[管理] をクリックします。

    3. 上部のバーから、[Settings]>[Data Sources] をクリックします。

    4. Virtual Apps and Desktops- セッションレコーディング サイトカードで、セッションレコーディングサーバーに接続 をクリックします。

      セッションレコーディング接続(/ja-jp/session-recording/2509/media/sr-connect-new-tenant.png)

    5. Connect Session Recording Server ページで、チェックリストを確認し、必須要件をすべて選択します。必須要件を選択しない場合、Download File オプションは無効になります。

      セッションレコーディングチェックリスト(/ja-jp/session-recording/2509/media/sr-checklist.png)

    6. ネットワークにプロキシサーバーがある場合は、Session Recordingサーバーの SsRecStorageManager.exe.config ファイルにプロキシアドレスを入力します。

      構成ファイルは<SessionRecordingserverinstallationpath>\bin\SsRecStorageManager.exe.configにあります。

      例: C:\Program Files\Citrix\SessionRecording\Server\Bin\SsRecStorageManager.exe.config

      構成ファイルのパス(/ja-jp/session-recording/2509/media/sr-config-file-path.png)

    7. ファイルをダウンロード をクリックして、SessionRecordingConfigurationFile.json ファイルをダウンロードします。

      注:

      このファイルには機密情報が含まれています。安全な場所に保管してください。

    8. Citrix Analytics for Security に接続するセッションレコーディングサーバーに、ファイルをコピーします。

    9. 展開環境に複数のSession Recordingサーバーがある場合は、接続する各サーバーにファイルをコピーし、各サーバーを構成する手順に従う必要があります。

    10. Session Recordingサーバーで、次のコマンドを実行して設定をインポートします。

      <SessionRecordingserverinstallationpath>\bin\SsRecUtils.exe -Import_SRCasConfigurations <configuration file path>
      <!--NeedCopy-->
      

      例えば:

      C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Import_SRCasConfigurations C:\Users\administrator\Downloads\SessionRecordingConfigurationFile.json
      <!--NeedCopy-->
      
    11. 次のサービスを再起動します。

      • シトリックス セッションレコーディング アナリティクスサービス

      • シトリックス セッションレコーディング ストレージマネージャー

    12. 構成が正常に完了したら、Citrix Analytics for Security に移動して、接続されているSession Recordingサーバーを表示します。データ処理をオンにするをクリックして、Citrix Analytics for Security がデータを処理できるようにします。

      注:

      Session Recordingサーバーバージョン2103または2104を使用している場合は、Citrix Analytics for Securityで接続されているSession Recordingサーバーを表示するために、まずVirtual Apps and Desktopsセッションを起動する必要があります。そうしないと、接続されているSession Recordingサーバーが表示されません。この要件は、Session Recordingサーバーバージョン2106以降には適用されません。

    接続されている展開を表示する

    サーバー展開は、構成が正常に完了した場合にのみSession Recordingサイトカードに表示されます。サイトカードには、Citrix Analytics for Securityとの接続を確立した構成済みサーバーの数が表示されます。

    構成が正常に完了した後もSession Recordingサーバーが表示されない場合は、構成済みSession Recordingサーバーが接続に失敗するのトラブルシューティングセクションを参照してください。

    セッションレコーディング 展開

    サイトカードで、展開の数をクリックして、Citrix Analytics for Securityに接続されているサーバーグループを表示します。たとえば、1 Session Recording展開をクリックして、接続されているサーバーまたはサーバーグループを表示します。各Session Recordingサーバーは、ベースURLとServerGroupIDで表されます。

    SR展開の詳細

    受信したイベントを表示する

    サイトカードには、接続されているSession Recording展開と、これらの展開から過去1時間(デフォルトの時間選択)に受信したイベントが表示されます。1週間(1 W)を選択してデータを表示することもできます。受信したイベントの数をクリックすると、セルフサービス検索ページでイベントを表示できます。

    データ処理を有効にすると、サイトカードにデータが受信されていませんというステータスが表示される場合があります。このステータスが表示される理由は2つあります。

    1. 初めてデータ処理をオンにした場合、イベントがCitrix Analyticsのイベントハブに到達するまでに時間がかかります。Citrix Analyticsがイベントを受信すると、ステータスはデータ処理オンに変わります。しばらくしてもステータスが変わらない場合は、データソースページを更新してください。

    2. Citrix Analyticsは、過去1時間、データソースからイベントを受信していません。

    セッション録画サーバーを追加する

    セッション録画サーバーを追加するには、次のいずれかを実行します。

    • 接続済みセッション録画展開」ページで、「セッション録画サーバーに接続」をクリックします。

      展開を接続(/ja-jp/session-recording/2509/media/sr-server-add.png)

    • Virtual Apps and Desktops - セッション録画」サイトカードで、縦の省略記号(⋮)をクリックし、「セッション録画サーバーに接続」を選択します。

      セッション録画接続(/ja-jp/session-recording/2509/media/sr-connect.png)

    手順に従って構成ファイルをダウンロードし、セッション録画サーバーを構成します。

    セッション録画サーバーを削除する

    セッション録画サーバーを削除するには:

    1. Citrix Analytics for Securityで、「接続済みセッション録画展開」ページに移動し、削除するサーバー展開を選択します。

    2. 縦の省略記号(⋮)をクリックし、「Analyticsからセッション録画サーバーを削除」を選択します。

      セッション録画サーバーを削除(/ja-jp/session-recording/2509/media/sr-remove.png)

    3. Citrix Analyticsから削除したセッション録画サーバーで、次のコマンドを実行します。

      <SessionRecordingserverinstallationpath>\bin\SsRecUtils.exe -Remove_SRCasConfigurations
      <!--NeedCopy-->
      

      例えば:

      C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Remove_SRCasConfigurations
      <!--NeedCopy-->
      

    データソースでのデータ処理のオン/オフを切り替える

    特定のデータソース(DirectorおよびWorkspaceアプリ)のデータ処理はいつでも停止できます。データソースサイトカードで、縦の省略記号(⋮)をクリックし、[データ処理をオフにする] を選択します。Citrix Analyticsは、そのデータソースのデータ処理を停止します。Virtual Apps and Desktopsサイトカードからデータ処理を停止することもできます。このオプションは、DirectorとWorkspaceアプリの両方のデータソースに適用されます。 データ処理を再度有効にするには、[データ処理をオンにする] をクリックします。

    構成済みのSession Recordingサーバーが接続に失敗する

    構成後、Session RecordingサーバーがCitrix Analyticsに接続できません。そのため、構成済みのサーバーがSession Recordingサイトカードに表示されません。

    この問題をトラブルシューティングするには、次の手順を実行します。

    1. 構成済みのSession Recordingサーバーで、次のPowerShellコマンドを実行してクライアントマシン識別子(CMID)を確認します。

      Get-WmiObject -class SoftwareLicensingService | select Clientmachineid
      <!--NeedCopy-->
      
    2. CMIDが空の場合、指定されたパスに次のレジストリファイルを追加します。

      レジストリ名 レジストリパス キーの種類
      AuditorUniqueID Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server\ 文字列 UUIDを入力してください。
      EnableCASUseAuditorUniqueID Computer/HKEY_LOCAL_MACHINE/SOFTWARE/Citrix/SmartAuditor/Server/ レグ_ディーワード 1
    3. 次のサービスを再起動します。

      • Citrix セッションレコーディング アナリティクスサービス

      • Citrix セッションレコーディング ストレージマネージャー

    インストール、アップグレード、アンインストール

    この記事の概要