Session Recording

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

注:

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

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

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

Session Recordingコンポーネントは、以下のファイルを使用してインストールします。

  • Broker_PowerShellSnapIn_x64.msi

  • SessionRecordingAdministrationx64.msi

  • SessionRecordingAgentx64.msi

  • SessionRecordingPlayer.msi

  • SessionRecordingWebPlayer.msi

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

手順
  インストールを開始する前に、前提条件をインストールします。システム要件およびCitrixスクリプトを使用してWindowsの役割と機能の前提条件をインストールするを参照してください。
  各Session Recordingコンポーネントをインストールするマシンを選択します。各マシンが、インストールするコンポーネントのハードウェアおよびソフトウェア要件を満たしていることを確認してください。
  Citrixアカウントの資格情報を使用して、Citrix Virtual Apps and Desktops™のダウンロードページにアクセスし、製品ファイルをダウンロードします。ファイルを解凍します。
  Session Recordingコンポーネント間の通信にTLSプロトコルを使用するには、環境に適切な証明書をインストールします。
  Session Recordingコンポーネントに必要なホットフィックスをインストールします。ホットフィックスはCitrixサポートから入手できます。
  Director を構成して、セッション録画ポリシーを作成およびアクティブ化します。詳細については、「Director を構成してセッション録画サーバーを使用する」を参照してください。

注:

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

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

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

  • InstallPrereqsforSessionRecordingAdministration.ps1

     <#
     .Synopsis
         Installs Prereqs for Session Recording Administration
     .Description
         Supports Windows Server 2022, Windows Server 2019 and Windows Server 2016.
         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 2022*') -or ($system -Like '*Microsoft Windows Server 2019*') -or ($system -Like '*Microsoft Windows Server 2016*')))
     {
         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
     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
     <!--NeedCopy-->
    
  • InstallPrereqsforSessionRecordingAgent.ps1

     <#
     .Synopsis
         Installs Prereqs for Session Recording Agent
     .Description
         Supports  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 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') #Message Queuing
         AddFeatures('MSMQ-HTTP-Support')#MSMQ HTTP Support
     }
     else
     {
         try
         {
             dism /online /enable-feature /featurename:MSMQ-HTTP /all
         }
         catch
         {
             Write-Host "Addition of Windows feature MSMQ HTTP Support failed"
             Exit 1
         }
         write-Host "Addition of Windows feature MSMQ HTTP Support succeeded"
     }
     <!--NeedCopy-->
    

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

  1. セッション録画管理コンポーネントをインストールする予定のマシンで、次の操作を行います。

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

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

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

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

  2. セッション録画エージェントコンポーネントをインストールする予定のマシンで:

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

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

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

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

セッション録画管理コンポーネントをインストールする

注:

2110以降、TLS 1.0が無効になっているWindows Server 2016にセッション録画管理コンポーネントをインストールする前に、次の手順を完了してください:

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

  3. 再起動します。

セッション録画管理、セッション録画エージェント、およびセッション録画プレーヤーの各コンポーネントは、別々のサーバーにインストールすることをお勧めします。

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

注記:

2110以降、TLS 1.0が無効になっているWindows Server 2016にSession Recording管理コンポーネントをインストールする前に、次の手順を実行してください。

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

  3. ウィンドウズ サーバー 2016 を再起動します。
  1. Install Broker_PowerShellSnapIn_x64.msi.

    重要:

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

  2. Windowsコマンドプロンプトを管理者として起動し、次にmsiexec /i SessionRecordingAdministrationx64.msiコマンドを実行するか、.msiファイルをダブルクリックします。

  3. インストールUIで、次へをクリックし、ライセンス契約に同意します。

  4. Session Recording管理セットアップ画面で、インストールするSession Recording管理コンポーネントを選択します。

    セッションレコーディング管理セットアップ画面

    注記:

    すべてのSession Recording管理コンポーネントを単一のサーバーにインストールすることは、概念実証には問題ありません。ただし、大規模な本番環境では、Session Recordingポリシーコンソールを別のサーバーに、Session Recordingサーバー、Session Recording管理者ログ、およびSession Recordingデータベースをさらに別のサーバーにインストールすることをお勧めします。Session Recording管理者ログは、Session Recordingサーバーのオプションのサブ機能です。Session Recording管理者ログを選択する前に、Session Recordingサーバーを選択してください。

セッション記録データベースのインストール

注:

Session RecordingデータベースとMicrosoft SQL Serverの展開には、通常、次の3つの種類があります。

  • 展開1:Session RecordingサーバーとSession Recordingデータベースを同じマシンにインストールし、Microsoft SQL Serverをリモートマシンにインストールします。(推奨)
  • 展開2:セッションレコーディングサーバー、セッションレコーディングデータベース、およびMicrosoft SQL Serverを同じマシンにインストールします。
  • 展開3:Session Recordingサーバーを1台のマシンにインストールし、Session RecordingデータベースとMicrosoft SQL Serverの両方を別のマシンにインストールします。(非推奨)
  1. データベースとサーバーの構成」ページで、Session Recordingデータベースのインスタンス名とデータベース名、およびSession Recordingサーバーのコンピューターアカウントを指定します。「次へ」をクリックします。

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

    • データベース名: 「データベース名」テキストボックスにカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名を使用します。「接続のテスト」をクリックして、SQL Serverインスタンスへの接続とデータベース名の有効性をテストします。

      重要:

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

      • データベースのsecurityadminおよびdbcreatorサーバーロール権限が必要です。これらの権限がない場合は、次のいずれかの方法で対応できます。
        • データベース管理者に、インストールに必要な権限を割り当てるよう依頼します。インストールが完了すると、securityadminおよびdbcreatorサーバーロール権限は不要になり、安全に削除できます。
        • または、msiインストール中に、securityadminおよびdbcreatorサーバーロール権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、「OK」をクリックしてインストールを続行します。

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

    • Session Recordingサーバーコンピューターアカウント:

      • 展開1および2: Session Recordingサーバーコンピューターアカウントテキストボックスに「localhost」と入力します。

      • 展開3: Session Recordingサーバーをホストするマシンの名前をdomain\computer-nameの形式で入力します。Session Recordingサーバーコンピューターアカウントは、Session Recordingデータベースにアクセスするためのユーザーアカウントです。

      注:

      Session Recordingサーバーコンピューターアカウントテキストボックスにドメイン名が設定されている場合、Session Recording管理コンポーネントのインストールがエラーコード1603で失敗することがあります。回避策として、Session Recordingサーバーコンピューターアカウントテキストボックスに「localhost」またはNetBIOSドメイン名\マシン名を入力します。NetBIOSドメイン名を取得するには、Session RecordingサーバーをインストールしたマシンでPowerShellで$env:userdomainを実行するか、コマンドプロンプトでecho %UserDomain%を実行します。

  2. 指示に従ってインストールを完了します。

セッション記録サーバーをインストールする

  1. セッションレコーディングサーバーセッションレコーディング管理者ログを選択します。

    注:

    • セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
    • Session Recording Administrator Loggingは、Session Recordingサーバーと同時にインストールすることをお勧めします。Administrator Logging機能を有効にしたくない場合は、後のページで無効にできます。
  2. データベースとサーバー構成」ページで、設定を指定します。

    • インスタンス名: インスタンス名テキストボックスにSQL Serverの名前を入力します。名前付きインスタンスを使用している場合は、computer-name\instance-nameと入力します。それ以外の場合は、computer-nameのみを入力します。SQL Serverがデフォルトポート1433以外のカスタムポートでリッスンしている場合は、インスタンス名にコンマを追加してカスタムリスナーポートを設定します。たとえば、インスタンス名テキストボックスに「DXSBC-SRD-1,2433」と入力します。ここで、コンマに続く2433はカスタムリスナーポートを示します。
    • データベース名: データベース名テキストボックスにカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名CitrixSessionRecordingを使用します。 データベースのsecurityadminおよびdbcreatorサーバーロール権限が必要です。権限がない場合は、次のことができます。
      • データベース管理者にインストールのアクセス許可を割り当てるよう依頼します。インストールが完了すると、securityadminおよびdbcreatorサーバーロールのアクセス許可は不要になり、安全に削除できます。
      • または、MSIインストール中に、securityadminおよびdbcreatorサーバーロールのアクセス許可を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、OKをクリックしてインストールを続行します。
    • 正しいインスタンス名とデータベース名を入力したら、Test connectionをクリックしてSession Recordingデータベースへの接続をテストします。

    • Session Recordingサーバーのコンピューターアカウントを入力し、Nextをクリックします。
  3. 管理ログ構成ページで、管理ログ機能の構成を指定します。

    • Logging database is installed on the SQL Server instance:このテキストボックスは編集できません。管理ログデータベースのSQL Serverインスタンス名は、Database and Server Configurationページで入力したインスタンス名から自動的に取得されます。
    • ログデータベース名:このテキストボックスに管理者ログデータベースのカスタムデータベース名を入力するか、テキストボックスにプリセットされているデフォルトのデータベース名CitrixSessionRecordingLoggingを使用します。

      注:

      管理ログデータベース名は、前のDatabase and Server ConfigurationページのDatabase nameテキストボックスで設定されているSession Recordingデータベース名とは異なる必要があります。

    • Use default database name:このオプションを選択すると、デフォルトのログデータベース名が使用されます。
    • Enable Logging service:デフォルトでは、管理ログ機能は有効になっています。チェックボックスをオフにすると無効にできます。
    • Enable mandatory blocking:デフォルトでは、強制ブロックは有効になっています。ログ記録に失敗した場合、通常の機能がブロックされる可能性があります。チェックボックスをオフにすると、強制ブロックを無効にできます。
  4. Nextをクリックしてインストールを完了します。

注:

Session Recordingサーバーのデフォルトインストールでは、HTTPS/TLSを使用して通信を保護します。Session RecordingサーバーのデフォルトのInternet Information Services (IIS)サイトでTLSが構成されていない場合は、HTTPを使用します。これを行うには、IIS管理コンソールでSSLの選択をキャンセルします。Session Recording Brokerサイトに移動し、SSL設定を開き、Require SSLチェックボックスをオフにします。

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

セッションを記録するVDAまたはVDIマシンにSession Recordingエージェントをインストールします。

  1. Session Recording Agent Configurationページで、Session Recordingサーバーを事前にインストールしている場合は、Session Recordingサーバーをインストールしたマシンのコンピューター名を入力します。Session Recordingサーバーへの接続のプロトコルとポート情報を入力します。Session Recordingをまだインストールしていない場合は、後でSession Recording Agent Propertiesでこの情報を変更できます。
  2. 指示に従ってインストールを完了します。

注:

Machine Creation Services (MCS)またはCitrix Provisioning™ Services (PVS)がMicrosoft Message Queuing (MSMQ)がインストールされたVDAを作成すると、特定の条件下でそれらのVDAが同じQMIdを持つことがあります。この場合、次のようなさまざまな問題が発生する可能性があります。

  • 録画契約が承認されていても、セッションが記録されない場合があります。
  • Session Recordingサーバーがセッションログオフ信号を受信せず、その結果、セッションが常にライブ状態になる可能性があります。

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

静的デスクトップモードでPVS 7.7以降およびMCS 7.9以降を使用して作成されたシングルセッションOS VDAの場合、追加のアクションは必要ありません。

MCSまたはPVSを使用して作成されたマルチセッションOS VDA、およびユーザーがログオフしたときにすべての変更を破棄するように構成されたシングルセッションOS VDAの場合、システム起動時にQMIdを変更するには、GenRandomQMID.ps1スクリプトを使用します。ユーザーログオン前に十分な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. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\ParametersSysPrep = 1を追加します。
  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-->

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

セッションレコーディングプレイヤーは、セッションレコーディングサーバーまたはドメイン内のワークステーションにインストールします。Webプレイヤーは、セッションレコーディングサーバーにのみインストールします。

SessionRecordingPlayer.msiSessionRecordingWebPlayer.msiをダブルクリックし、指示に従ってインストールを完了します。

インストールを自動化する

セッションレコーディングは、オプションを指定したサイレントインストールをサポートしています。サイレントインストールを使用するスクリプトを作成し、関連するコマンドを実行します。

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

単一のコマンドを使用してセッションレコーディング管理コンポーネントの完全なセットをインストールする

たとえば、以下のいずれかのコマンドは、セッションレコーディング管理コンポーネントの完全なセットをインストールし、インストール情報をキャプチャするためのログファイルを作成します。

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="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->

「注:」

SessionRecordingAdministrationx64.msiファイルは、シトリックス バーチャル アプリケーションズ アンド デスクトップ ISOの\layout\image-full\x64\Session Recordingにあります。

ここで、

  • ADDLOCALは、選択できる機能を提供します。複数のオプションを選択できます。SsRecServerはセッションレコーディングサーバーです。PolicyConsoleはセッションレコーディングポリシーコンソールです。SsRecLoggingは管理者ログ機能です。StorageDatabaseはセッションレコーディングデータベースです。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
  • DATABASEINSTANCEは、セッションレコーディングデータベースのインスタンス名です。たとえば、.\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name、またはAzure SQL Managed Instanceを使用している場合はtcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342です。
  • DATABASENAMEは、セッションレコーディングデータベースのデータベース名です。
  • LOGGINGDATABASENAMEは、管理者ログデータベースの名前です。
  • AZURESQLSERVICESUPPORTは、クラウドSQLがサポートされているかどうかを決定します。クラウドSQLを使用するには、1に設定します。
  • DATABASEUSERは、セッションレコーディングサーバーのコンピューターアカウントです。
  • AZUREUSERNAMEは、クラウドSQL管理者名です。
  • AZUREPASSWORDは、クラウドSQL管理者パスワードです。
  • /qはサイレントモードを指定します。
  • /l*vは詳細ログを指定します。
  • yourinstallationlogは、インストールログファイルの場所です。

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

既存の展開から、Session Recordingデータベースと管理者ログデータベースがすでに配置されている場合があります。このようなシナリオでは、SessionRecordingAdministrationx64.msiを使用して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管理コンポーネントをインストールします。

    Set the IGNOREDBCHECK parameter to True and use random values for DATABASEINSTANCE, DATABASENAME, and LOGGINGDATABASENAME.

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

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

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

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

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

    SsRecUtils.exeファイルは\Citrix\SessionRecording\Server\bin\に保存されます。必要に応じて、DATABASEINSTANCEDATABASENAME、およびLOGGINGDATABASENAMEパラメーターを適切に設定してください。

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

KEEPDBTrueに設定すると、Session Recording管理コンポーネントのアンインストール時に、次のコマンドによってSession Recordingデータベースと管理ログデータベースが保持されます。

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

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

たとえば、次のコマンドはSession Recording PlayerとWeb Playerをそれぞれインストールします。

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

注:

SessionRecordingPlayer.msiファイルは、シトリックス バーチャル アプリケーションズ アンド デスクトップス ISOの\layout\image-full\x86\Session Recordingにあります。

SessionRecordingWebPlayer.msiファイルは、シトリックス バーチャル アップス アンド デスクトップス ISOの\layout\image-full\x64\Session Recordingにあります。

説明:

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

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

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

msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->

注:

SessionRecordingAgentx64.msiファイルは、シトリックス バーチャル アップス アンド デスクトップス ISOの\layout\image-full\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)を使用するように指示されます。
  • /q はサイレントモードを指定します。
  • /l*v は詳細ログ記録を指定します。
  • yourinstallationlog は、インストールログファイルの場所です。

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

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

注:

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

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

要件、準備、および制限

  • 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 エージェント 7.6.0 以降は、Session Recording サーバーの最新バージョンと互換性があります。ただし、一部の新機能やバグ修正は有効にならない場合があります。
  • Session Recording サーバーのアップグレード中に開始されたセッションは記録されません。
  • Session Recording Agent のプロパティ[グラフィック調整] オプションは、新規インストールまたはアップグレード後に、Desktop Composition Redirection モードとの互換性を維持するためにデフォルトで有効になっています。新規インストールまたはアップグレード後に、このオプションを手動で無効にすることができます。
  • 管理者ログ機能は、その機能が利用できない以前のバージョンからSession Recordingをアップグレードした後にはインストールされません。この機能を追加するには、アップグレード後にインストールを変更してください。
  • アップグレードプロセスが開始されたときにライブ録画セッションがある場合、録画が完了する可能性はほとんどありません。
  • 潜在的な停止を計画し、軽減できるように、以下のアップグレードシーケンスを確認してください。

アップグレードシーケンス

  1. セッションレコーディングデータベースとセッションレコーディングサーバーが異なるサーバーにインストールされている場合は、セッションレコーディングサーバーでセッションレコーディングストレージマネージャーサービスを手動で停止します。次に、セッションレコーディングデータベースを最初にアップグレードします。
  2. Internet Information Services (IIS) マネージャーを使用して、Session Recording Broker が稼働していることを確認します。Session Recording サーバーをアップグレードしてください。Session Recording データベースと Session Recording サーバーが同一のサーバーにインストールされている場合、Session Recording データベースもアップグレードされます。
  3. Session Recordingサーバーのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
  4. Session Recordingエージェント(マスターイメージ上)をアップグレードします。
  5. Session Recordingサーバーと同時、またはそれ以降に、Session Recordingポリシーコンソールをアップグレードします。
  6. Session Recordingプレーヤーをアップグレードします。

クラウドSQLデータベースサービスにSession Recordingデータベースを展開する

このセクションでは、Azure SQL マネージド インスタンス、AWS RDS、およびAzure VM上のSQL ServerにSession Recordingデータベースを展開する方法について説明します。

Azure SQL マネージド インスタンスまたはAWS RDSにセッションレコーディングデータベースを展開する

ヒント:

Azure SQL Managed InstanceまたはAWS RDSにSession Recordingデータベースを展開するには、次のような単一のコマンドを実行することもできます。詳細については、この記事の前の「インストールを自動化する」セクションを参照してください。

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-->
  1. Azure SQL マネージド インスタンスを作成するか、Amazon RDS コンソールで SQL Server インスタンスを作成します。

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

    Server 文字列の例(/ja-jp/session-recording/2107/media/example-server-strings.png)

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

    AWS RDS インスタンスの構成(/ja-jp/session-recording/2107/media/aws-rds-instance-composition.png)

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

    Enable cloud SQL チェックボックスをオンにし、クラウド SQL 管理者のユーザー名とパスワードを入力します。その他の必要な構成を行います。

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

    注:

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

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

    クラウド SQL 管理者のパスワードを更新する(/ja-jp/session-recording/2107/media/updating-cloud-sql-admin-password.png)

オンプレミスデータベースをクラウド 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. 移行後に Session Recording が正常に動作するようにするには、Session Recording サーバーで 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. On the Session Recording server, restart the Citrix Session Recording Analytics service, the Citrix Session Recording Storage Manager service, and the IIS service.

Azure SQL Managed Instanceからオンプレミスデータベースへの本番データベースの移行

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

  2. 移行後にSession Recordingが正常に機能するように、Session Recordingサーバーで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. セッションレコーディングサーバーで、Citrix Session Recording アナリティクスサービス、Citrix Session Recording ストレージマネージャーサービス、およびIISサービスを再起動します。

Azure仮想マシン上のSQL Serverにセッションレコーディングデータベースを展開する

Azure仮想マシン上のSQL Serverに、セッションレコーディングデータベースを展開できます。

  1. Azure SQL VMをチェックアウトします。
  2. VMを構成し、Session Recordingコンポーネントをインストールするドメインに追加します。
  3. Session Recordingデータベースのインストール時に、VMのFQDNをインスタンス名として使用します。 注: SessionRecordingAdministrationx64.msiを使用してインストールする場合は、Enable cloud SQLチェックボックスをオフにします。
  4. 指示に従ってインストールを完了します。

セッションレコーディングの削除

サーバーまたはワークステーションから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とのこの通信を許可する必要があります。

  • Citrix Virtual Apps™ and Desktops 7 1912 LTSR を使用している場合、サポートされるセッションレコーディングのバージョンは2103以降です。

セッションレコーディングサーバーをCitrix Analytics for Securityに接続する

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

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

  3. 上部のバーから、[設定] > [データソース] をクリックします。

  4. 仮想アプリおよびデスクトップ - セッションレコーディング」サイトカードで、「セッションレコーディングサーバーに接続」をクリックします。

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

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

    セッション録画チェックリスト(/ja-jp/session-recording/2201/media/sr-checklist.png)

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

    構成ファイルは<Session Recording server installation path>\bin\SsRecStorageManager.exe.configにあります。

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

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

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

    注:

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

  8. ファイルを、シトリックス アナリティクス フォー セキュリティに接続するセッションレコーディングサーバーにコピーします。

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

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

    <Session Recording server installation path>\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-->
    
  10. 次のサービスを再起動します。

    • Citrix セッションレコーディング分析機能

    • Citrix セッションレコーディング ストレージ管理ツール

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

    注:

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

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

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

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

セッションレコーディングの展開(/ja-jp/session-recording/2201/media/sr-connected-server.png)

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

SR展開の詳細

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

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

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

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

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

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

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

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

    展開を接続

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

    セッション録画接続

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

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

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

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

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

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

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

    <Session Recording server installation path>\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/ レジストリ DWORD 1
  3. 次のサービスを再起動します。

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

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