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

注：

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

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

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

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

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

  • Session Recordingデータベースをインストールする

  • セッションレコーディングサーバーをインストールする

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

• セッションレコーディングプレーヤーおよびウェブプレーヤーをインストールする

• インストールの自動化

• セッションレコーディングをアップグレードする

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

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

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

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

• Broker_PowerShellSnapIn_x64.msi

• SessionRecordingAdministrationx64.msi

• SessionRecordingAgentx64.msi

• SessionRecordingPlayer.msi

• SessionRecordingWebPlayer.msi

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

注:

• 公開アプリケーションは、記録ポリシーに基づいて個別のデリバリーグループに分割することをお勧めします。公開アプリケーションのセッション共有は、アプリケーションが同じデリバリーグループにある場合、アクティブなポリシーと競合する可能性があります。セッション記録は、ユーザーが最初に開いた公開アプリケーションとアクティブなポリシーを照合します。バージョン 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 の役割と機能の前提条件をインストールする

For Session Recording to work properly, use the following Citrix scripts to install the necessary Windows roles and features prerequisites before installing Session Recording:

• 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. SQL Server 用マイクロソフト OLE DB ドライバーをインストールします。

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 ドライバー フォー SQL サーバー をインストールします。

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

• セッションレコーディングデータベースは、Azure SQL マネージドインスタンス、Azure Virtual Machines (VM) 上のSQL Server、およびAWS RDSに展開できます。詳細については、Azure SQL マネージドインスタンスまたはAWS RDSへのSession Recordingデータベースの展開およびAzure VM上のSQL Serverへの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のコンピューター名のみを使用できます。インスタンスに名前を付けた場合は、データベースインスタンス名としてコンピューター名\インスタンス名を使用します。使用しているサーバーインスタンス名を特定するには、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 Serverコンピューターアカウントテキストボックスに「localhost」と入力します。

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

     注:

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

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

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

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

   注:

   • Session Recording管理者ログは、Session Recordingサーバーのオプションのサブ機能です。Session Recording管理者ログを選択する前に、Session Recordingサーバーを選択してください。
   • 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\ParametersにSysPrep = 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-->

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

Session Recordingプレーヤーは、Session Recordingサーバーまたはドメイン内のワークステーションにインストールします。Webプレーヤーは、Session Recordingサーバーにのみインストールします。

SessionRecordingPlayer.msiとSessionRecordingWebPlayer.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" /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 ファイルは、Citrix Virtual Apps and Desktops ISO の \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 は、Session Recording サーバーのコンピュータのユーザーアカウントです。
• 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-->
   

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

   IGNOREDBCHECKパラメーターをTrueに設定する必要があります。また、DATABASEINSTANCE、DATABASENAME、およびLOGGINGDATABASENAMEにはランダムな値を使用するようにしてください。

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

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

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

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

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

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

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

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

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

注：

SessionRecordingPlayer.msi ファイルは、Citrix Virtual Apps and Desktops ISO の \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エージェントが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 のプロパティ の グラフィック調整 オプションは、デスクトップコンポジションリダイレクトモードとの互換性を維持するために、新規インストールまたはアップグレード後にデフォルトで有効になります。このオプションは、新規インストールまたはアップグレード後に手動で無効にできます。
• 管理者ログ機能が利用できない以前のバージョンからSession Recordingをアップグレードした場合、管理者ログ機能はインストールされません。この機能を追加するには、アップグレード後にインストールを変更してください。
• アップグレードプロセスが開始されたときにライブ録画セッションがある場合、録画が完了する可能性はほとんどありません。
• 潜在的な停止を計画し、軽減できるように、以下のアップグレードシーケンスを確認してください。

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

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

クラウドSQLデータベースサービスへのセッション録画データベースの展開

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

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

ヒント:

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

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データベースのインスタンス名です。例については、次のスクリーンショットを参照してください。

   

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

   

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

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

Azure VM上のSQL Serverへのセッションレコーディングデータベースの展開

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

1. Azure SQL VM の確認をお願いします。
2. VMを構成し、セッションレコーディングコンポーネントをインストールするドメインにVMを追加します。
3. セッションレコーディングデータベースのインストール中に、VMのFQDNをインスタンス名として使用します。 注：インストールにSessionRecordingAdministrationx64.msiを使用している場合は、Enable cloud SQLチェックボックスをオフにします。
4. 指示に従ってインストールを完了します。

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

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

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

Citrix Analytics for Security™ との統合機能の利用に関する詳細な情報について

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

前提条件

開始する前に、以下の前提条件を満たしてください。

• Session Recordingサーバーは、次のアドレスに接続できます。

  • https://*.cloud.com

  • https://*.citrixdata.com

  • https://api.analytics.cloud.com

• 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. 上部のバーから、［Settings］>［Data Sources］ をクリックします。

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

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

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

   セッション録画チェックリスト(/ja-jp/session-recording/2204/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/2204/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サーバーが接続に失敗する のトラブルシューティングセクションを参照してください。

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

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

サイトカードには、接続されている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/	レグディーワード	1

3. 次のサービスを再起動します。

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

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