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. Session Recordingエージェントコンポーネントをインストールするマシンで:

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

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

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

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

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

注:

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

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

  3. 再起動します。

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

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

注:

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

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

  3. Windows サーバ 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インスタンスに必要なデータベースを作成および構成するためのコンポーネントです。Session Recordingは、Microsoft SQL Serverに基づいたデータベース高可用性の3つのソリューションをサポートしています。詳細については、「データベースの高可用性」(/ja-jp/session-recording/2210/configure/high-availability-and-load-balancing/session-recording-database-high-availability.html)を参照してください。

  • セッション記録データベースは、Azure SQL Managed Instance、Azure Virtual Machines (VM) 上のSQL Server、およびAWS RDSに展開できます。詳細については、「Azure SQL Managed InstanceまたはAWS RDSへのセッション記録データベースの展開」(/ja-jp/session-recording/2210/install-upgrade-uninstall.html#deploy-the-session-recording-database-on-azure-sql-managed-instance-or-on-aws-rds)および「Azure VM上のSQL Serverへのセッション記録データベースの展開」(/ja-jp/session-recording/2210/install-upgrade-uninstall.html#deploy-the-session-recording-database-on-sql-server-on-azure-vms)を参照してください。

セッション記録データベースと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のコンピューター名のみを使用できます。インスタンスに名前を付けた場合は、データベースインスタンス名として「コンピューター名\インスタンス名」を使用します。使用しているサーバーインスタンス名を特定するには、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および2Session 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管理者ログは、Session Recordingサーバーのオプションのサブ機能です。Session Recording管理者ログを選択する前に、Session Recordingサーバーを選択してください。
    • Session Recording管理者ログは、Session Recordingサーバーと同時にインストールすることをお勧めします。管理者ログ機能を有効にしたくない場合は、後のページで無効にできます。
  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 をクリックしてインストールを続行します。
    • 正しいインスタンス名とデータベース名を入力したら、接続テスト をクリックして、セッションレコーディングデータベースへの接続をテストします。

    • セッションレコーディングサーバーのコンピューターアカウントを入力し、次へ をクリックします。
  3. 管理ログ構成 ページで、管理ログ機能の構成を指定します。

    • ログデータベースはSQL Serverインスタンスにインストールされています: このテキストボックスは編集できません。管理ログデータベースのSQL Serverインスタンス名は、データベースとサーバーの構成 ページで入力したインスタンス名から自動的に取得されます。
    • ログデータベース名: このテキストボックスに管理者ログデータベースのカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名 CitrixSessionRecordingLogging を使用します。

      注:

      管理者ログデータベース名は、前の データベースとサーバーの構成 ページの データベース名 テキストボックスに設定されているセッションレコーディングデータベース名とは異なる必要があります。

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

注:

セッションレコーディングサーバーのデフォルトインストールでは、HTTPS/TLS を使用して通信を保護します。セッションレコーディングサーバーのデフォルトのインターネットインフォメーションサービス (IIS) サイトで TLS が構成されていない場合は、HTTP を使用します。これを行うには、IIS 管理コンソールで SSL の選択をキャンセルします。セッションレコーディングブローカーサイトに移動し、SSL 設定を開き、SSL を要求する チェックボックスをオフにします。

セッション録画エージェントをインストールする

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

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

注:

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

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

回避策として、各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

Summary of the GenRandomQMID.ps1 script:

  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 Playerは、Session Recordingサーバーまたはドメイン内のワークステーションにインストールします。Web Playerは、Session Recordingサーバーにのみインストールします。

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

インストールの自動化

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

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

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

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

msiexec /i "c:\SessionRecordingAdministrationx64.msi" AddLocal="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DatabaseInstance="WNBIO-SRD-1" DatabaseName="CitrixSessionRecording" LoggingDatabaseName="CitrixSessionRecordingLogging" DatabaseUser="localhost" AllowSession0Install="1" /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" AllowSession0Install="1" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->

注:

The SessionRecordingAdministrationx64.msi file is located on the Citrix Virtual Apps and Desktops ISO under \layout\image-full\x64\Session Recording.

説明:

  • AddLocal は、選択可能な機能を提供します。複数のオプションを選択できます。SsRecServer はセッションレコーディングサーバーです。PolicyConsole はセッションレコーディングポリシーコンソールです。SsRecLogging は管理者ログ機能です。StorageDatabase はセッションレコーディングデータベースです。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
  • DatabaseInstance は セッションレコーディング データベースのインスタンス名です。たとえば、Azure SQL Managed Instance を使用している場合は .\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name または tcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342 です。
  • DatabaseName は セッションレコーディング データベースのデータベース名です。
  • LoggingDatabaseName は管理者ログデータベースの名前です。
  • AzureSQLServiceSupport は、クラウド SQL がサポートされているかどうかを決定します。クラウド SQL を使用するには、1 に設定します。
  • DatabaseUser は、セッションレコーディングサーバーのコンピュータアカウントです。
  • AzureUsername はクラウド SQL 管理者名です。
  • AzurePassword はクラウド SQL 管理者パスワードです。
  • AllowSession0Install は、Session Recording 管理コンポーネントをセッション 0 にインストールするかどうかを決定します。Session Recording 管理コンポーネントをセッション 0 にインストールするには、この引数をコマンドに追加し、1 に設定します。コマンドを実行する前に、コンピューターアカウントを SQL Server のログインとして追加し、sysadmin ロールを割り当てていることを確認してください。
  • /q はサイレントモードを指定します。
  • /l*v は詳細ログ記録を指定します。
  • YourInstallationLog はインストールログファイルの場所です。

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

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

  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-->
    

    このコマンドは、セッション記録データベースと管理ログデータベースへの接続を構成およびテストせずに、セッション記録管理コンポーネントをインストールします。

    Set the IgnoreDBCheck parameter to True and use random values for DatabaseInstance, DatabaseName, and LoggingDatabaseName.

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

  3. セッション記録サーバーを展開するために、マスターイメージを他のマシンに展開します。

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

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

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

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

セッション記録管理コンポーネントのアンインストール時にデータベースを保持する

KeepDBTrue に設定すると、次のコマンドはセッション記録管理コンポーネントのアンインストール時にセッション記録データベースと管理ログデータベースを保持します。

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

セッション記録プレーヤーとWebプレーヤーのインストールを自動化する

たとえば、次のコマンドはセッション記録プレーヤーとWebプレーヤーをそれぞれインストールします。

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

注:

The SessionRecordingPlayer.msi file is located on the Citrix Virtual Apps and Desktops ISO under \layout\image-full\x86\Session Recording.

The SessionRecordingWebPlayer.msi file is located on the Citrix Virtual Apps and Desktops ISO under \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-->

注:

The SessionRecordingAgentx64.msi file is located on the Citrix Virtual Apps and Desktops ISO under \layout\image-full\x64\Session Recording.

ここで、

  • yourservernameは、Session RecordingサーバーをホストするマシンのNetBIOS名またはFQDNです。指定しない場合、この値はlocalhostにデフォルト設定されます。
  • yourbrokerprotocol は、セッションレコーディングエージェントがセッションレコーディングブローカーとの通信に使用するHTTPまたはHTTPSです。指定しない場合、この値はHTTPSに既定で設定されます。
  • yourbrokerportは、Session Recording Brokerとの通信にSession Recordingエージェントが使用するポート番号です。指定しない場合、この値はゼロにデフォルト設定され、Session Recordingエージェントは選択したプロトコルのデフォルトポート番号(HTTPの場合は80、HTTPSの場合は443)を使用するように指示されます。
  • /qはサイレントモードを指定します。
  • /l*vは詳細ログ記録を指定します。
  • yourinstallationlog は、インストールログファイルの場所です。

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

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

注:

Session Recording の管理を7.6から7.13以降にアップグレードし、Modify を選択して管理者ログサービスを追加すると、SQL Serverインスタンス名が Administrator Logging Configuration ページに表示されません。Next をクリックすると、次のエラーメッセージが表示されます: Database connection test failed. Please enter correct Database instance name. 回避策として、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をアップグレードした後にはインストールされません。この機能を追加するには、アップグレード後にインストールを変更してください。
  • アップグレードプロセスが開始されたときにライブ録画セッションがある場合、録画が完了する可能性はほとんどありません。
  • 潜在的な停止を計画し、軽減できるように、次のアップグレードシーケンスを確認してください。

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

  1. セッションレコーディングデータベースとセッションレコーディングサーバーが異なるサーバーにインストールされている場合は、セッションレコーディングサーバーでセッションレコーディングストレージマネージャーサービスを手動で停止します。その後、まずセッションレコーディングデータベースをアップグレードします。
  2. Internet Information Services (IIS) マネージャーを通じて、セッションレコーディングブローカーが実行されていることを確認します。セッションレコーディングサーバーをアップグレードします。セッションレコーディングデータベースとセッションレコーディングサーバーが同じサーバーにインストールされている場合、セッションレコーディングデータベースもアップグレードされます。
  3. セッションレコーディングサーバーのアップグレードが完了すると、セッションレコーディングサービスは自動的にオンラインに戻ります。
  4. セッションレコーディングエージェントをアップグレードします(マスターイメージ上)。
  5. セッションレコーディングポリシーコンソールを、セッションレコーディングサーバーと同時に、またはその後にアップグレードします。
  6. セッションレコーディングプレイヤーをアップグレードします。

クラウドSQLデータベースサービスへのセッションレコーディングデータベースの展開

このセクションでは、Azure SQL Managed Instance、AWS RDS、およびAzure VM上のSQL Serverにセッションレコーディングデータベースを展開する方法について説明します。

Azure SQL Managed Instanceまたは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 Managed Instance のインスタンスを作成するか、Amazon RDS コンソール経由で SQL Server のインスタンスを作成してください。

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

    Server文字列の例

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

    AWS RDSインスタンスの構成

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

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

    クラウドSQL管理者の資格情報を入力する

    注:

    クラウド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管理者のパスワードを更新する

オンプレミスデータベースをクラウド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. Session Recordingサーバーで、シトリックス セッション レコーディング アナリティクス サービス、シトリックス セッション レコーディング ストレージ マネージャー サービス、およびIISサービスを再起動します。

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. Session Recordingサーバーで、シトリックス セッション レコーディング アナリティクス サービス、シトリックス セッション レコーディング ストレージ マネージャー サービス、およびIISサービスを再起動します。

Azure仮想マシン上のSQLサーバーへのSession Recordingデータベースの展開

Azure仮想マシン上のSQLサーバーにSession Recordingデータベースを展開できます。

  1. Azure SQL VMをプロビジョニングします。
  2. VMを構成し、Session RecordingコンポーネントをインストールするドメインにVMを追加します。
  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 以降です。

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

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

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

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

  4. バーチャルアプリとデスクトップ - セッションレコーディング サイトカードで、Session Recordingサーバーの接続をクリックします。

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

  5. Session Recordingサーバーの接続ページで、チェックリストを確認し、すべての必須要件を選択します。必須要件を選択しない場合、ファイルのダウンロードオプションは無効になります。

    セッション記録チェックリスト(/ja-jp/session-recording/2210/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/2210/media/sr-config-file-path.png)

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

    注:

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

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

    展開環境に複数の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を使用している場合、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サーバーが接続に失敗する のトラブルシューティングセクションを参照してください。

セッションレコーディングの展開(/ja-jp/session-recording/2210/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サーバーで、次のコマンドを実行します。

    <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/ レグ_ディーワード 1
  3. 次のサービスを再起動します:

    • Citrix セッションレコーディング Analytics サービス

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