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

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

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

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

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

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

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

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

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

• インストールの自動化

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

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

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

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

• Broker_PowerShellSnapIn_x64.msi

• SessionRecordingAdministrationx64.msi

• SessionRecordingAgentx64.msi

• SessionRecordingPlayer.msi

• SessionRecordingWebPlayer.msi

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

注記：

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

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

Session Recording が正しく機能するように、以下の Citrix スクリプトを使用して必要な Windows の役割と機能の前提条件をインストールする前に 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. Session Recording Administration コンポーネントをインストールする予定のマシンで、次の操作を行います。

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

      Set-ExecutionPolicy RemoteSigned
      <!--NeedCopy-->
      

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

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

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

2. Session Recording Agent コンポーネントをインストールする予定のマシンで、次の操作を行います。

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

      Set-ExecutionPolicy RemoteSigned
      <!--NeedCopy-->
      

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

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

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

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

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

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

注：

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

1. Install Microsoft OLE DB Driver for SQL Server.

2. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319 レジストリキーの下に、SchUseStrongCrypto DWORD (32ビット) 値を追加し、値のデータを 1 に設定します。

3. 再起動します。

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. 「セッションレコーディング管理セットアップ」画面で、インストールするセッションレコーディング管理コンポーネントを選択します。

   セッションレコーディング管理セットアップ画面(/ja-jp/session-recording/2107/media/session-recording-administration-setup.png)

   注：

   Installing all the Session Recording Administration components on a single server is fine for a proof of concept. However, for a large production environment, we recommend that you install the Session Recording Policy Console on a separate server and the Session Recording Server, Session Recording Administrator Logging, and Session Recording Database on another separate server. The Session Recording Administrator Logging is an optional subfeature of the Session Recording Server. Select the Session Recording Server before you can select the Session Recording Administrator Logging.

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

注：

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

• セッションレコーディングデータベースは、Azure SQL マネージドインスタンス、Azure Virtual Machines (VM) 上のSQL Server、およびAWS RDSに展開できます。詳細については、Azure SQL マネージドインスタンスまたはAWS RDSへのセッションレコーディングデータベースの展開およびAzure VM上のSQL Serverへのセッションレコーディングデータベースの展開を参照してください。

セッションレコーディングデータベースとMicrosoft SQL Serverには、通常、次の3種類の展開があります。

• 展開1：セッションレコーディングサーバーとセッションレコーディングデータベースを同じマシンにインストールし、Microsoft SQL Serverをリモートマシンにインストールします。（推奨）
• 展開2：セッションレコーディングサーバー、セッションレコーディングデータベース、およびマイクロソフト SQL Server を同じマシンにインストールします。
• 展開3：セッションレコーディングサーバーを1台のマシンにインストールし、セッションレコーディングデータベースとMicrosoft SQL Serverの両方を別のマシンにインストールします。（非推奨）

1. データベースとサーバーの構成ページで、Session Recording Databaseのインスタンス名とデータベース名、およびSession Recording Serverのコンピューターアカウントを指定します。次へをクリックします。

   • インスタンス名：データベースインスタンスが、インスタンスのセットアップ時に構成した名前付きインスタンスではない場合、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 Serverのコンピューターアカウントがdb_ownerとして追加されます。

   • セッションレコーディングサーバーコンピューターアカウント：

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

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

     注：

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

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

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

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

   注：

   • Session Recording 管理者ログは、Session Recording サーバーのオプションのサブ機能です。Session Recording 管理者ログを選択する前に、Session Recording サーバーを選択してください。
   • Session Recording 管理者ログは、Session Recording サーバーと同時にインストールすることをお勧めします。管理者ログ機能を有効にしたくない場合は、後で別のページで無効にできます。

2. 「データベースおよびサーバー構成」ページで、設定を指定します。

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

   • 正しいインスタンス名とデータベース名を入力したら、Test connectionをクリックしてSession Recording Databaseへの接続をテストします。

   • Session Recording Serverのコンピューターアカウントを入力し、Nextをクリックします。

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

   • SQL Serverインスタンスにログデータベースがインストールされています：このテキストボックスは編集できません。管理ログデータベースのSQL Serverインスタンス名は、Database and Server Configurationページで入力したインスタンス名から自動的に取得されます。
   • ログデータベース名：Session Recording Administrator Logging機能をインストールするには、このテキストボックスにAdministrator Loggingデータベースのカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名CitrixSessionRecordingLoggingを使用します。

     注：

     管理者ログデータベース名は、前のデータベースとサーバーの構成ページで設定されたセッション記録データベース名とは異なる必要があります。

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

4. 次へをクリックして、インストールを完了します。

注:

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

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

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

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

注:

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

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

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

Session Recording AgentがインストールされたシングルセッションOS VDAが、PVS 7.7以降およびMCS 7.9以降を使用して、たとえば個別のPersonal vDiskまたは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-->

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

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

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

注：

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 は、セッションレコーディングデータベースのインスタンス名です。たとえば、.\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name または Azure SQL マネージドインスタンスを使用している場合は 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 Serverを展開するためのマスターイメージを作成する

既存の展開から、Session Recordingデータベースと管理ログデータベースがすでに配置されている場合があります。このようなシナリオでは、SessionRecordingAdministrationx64.msiを使用してSession Recording管理コンポーネントをインストールする際に、データベースチェックを省略できるようになりました。Session Recording Serverを他の多くのマシンに簡単に展開するためのマスターイメージを作成できます。マスターイメージを使用してターゲットマシンにサーバーを展開した後、各マシンでコマンドを実行して、既存の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 Serverを展開するために、マスターイメージを他のマシンに展開します。

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

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

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

   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は、インストールログファイルの場所です。

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

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

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 AgentがSession Recording Brokerと通信するために使用するポート番号です。指定しない場合、この値はデフォルトでゼロになり、Session Recording Agentは選択したプロトコルのデフォルトポート番号（HTTPの場合は80、HTTPSの場合は443）を使用するように指示されます。
• /qはサイレントモードを指定します。
• /l*vは詳細ログを有効にします。
• yourinstallationlogは、インストールログファイルの場所です。

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

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

注：

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

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

要件、準備、および制限

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

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

1. セッションレコーディングデータベースとセッションレコーディングサーバーが異なるサーバーにインストールされている場合は、セッションレコーディングサーバーでセッションレコーディングストレージマネージャーサービスを手動で停止します。次に、セッションレコーディングデータベースを最初にアップグレードします。
2. Internet Information Services（IIS）マネージャーを通じて、セッションレコーディングブローカーが実行されていることを確認します。セッションレコーディングサーバーをアップグレードします。セッションレコーディングデータベースとセッションレコーディングサーバーが同じサーバーにインストールされている場合、セッションレコーディングデータベースもアップグレードされます。
3. Session Recording Serverのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
4. Session Recording Agentをアップグレードします（マスターイメージ上）。
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にセッションレコーディングデータベースを展開することもできます。詳細については、この記事の前のインストールを自動化するセクションを参照してください。

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 のみ) プロパティパネルに表示されるサーバー文字列を記録しておきます。これらの文字列は、セッションレコーディングデータベースのインスタンス名です。例については、次のスクリーンショットを参照してください。

   

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

   

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

   クラウド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マネージドインスタンスに移行する

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. 移行後に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 セッションレコーディングアナリティクスサービス、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ロール権限が必要です。

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