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

この記事は、次のセクションで構成されています。

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

Citrix Virtual Apps and Desktopsインストーラーを使用したSession Recordingのインストール

インストールの自動化

Session Recordingのアップグレード

Session Recordingのアンインストール

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

Citrix Virtual Apps and Desktopsインストーラーを使用してSession Recordingのコンポーネントをインストールできます。

インストールを始める前に、以下のリストに記載されている作業を行います：

注：

• 録画ポリシーに基づいて、公開アプリケーションを個別のデリバリーグループに分割することをお勧めします。公開アプリケーションのセッション共有は、同じデリバリーグループ内のアクティブなポリシーと競合する可能性があります。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 Virtual Apps and Desktopsインストーラーを使用したSession Recordingのインストール

Session Recording Administration、Session Recording Agent、およびSession Recording Playerの各コンポーネントを別々のサーバーにインストールすることをお勧めします。次の手順では、これらのコンポーネントのインストール方法を詳しく説明します：

Session Recording Administrationコンポーネントのインストール

Session Recording Agentのインストール

Session Recording Playerのインストール

Session Recording Administrationコンポーネントのインストール

Session Recording Administrationコンポーネントは、Session Recordingデータベース、Session Recordingサーバー、およびSession Recordingポリシーコンソールから構成されています。コンポーネントを選択してサーバーにインストールできます。

手順1：製品ソフトウェアをダウンロードしてウィザードを起動する

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

手順2：インストールする製品を選択する

インストールする製品（Citrix Virtual AppsまたはCitrix Virtual Desktops）の横にある ［開始］ をクリックします。

手順3：Session Recordingを選択する

Session Recordingエントリを選択します。

手順4：ライセンス契約書を読み、同意する

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

手順5：インストールするコンポーネントおよびインストール場所を選択する

［コアコンポーネント］ ページで次の作業を行います：

• 場所： デフォルトでは、C:\Program Files\Citrixに各コンポーネントがインストールされます。ほとんどの展開ではこれで十分です。任意のインストール場所を指定することもできます。
• コンポーネント： デフォルトでは、インストールするコンポーネントの隣のすべてのチェックボックスがオンになっています。インストーラーは、実行されているのがシングルセッションOS上なのかマルチセッションOS上なのかを検知します。Session Recording Administrationコンポーネントがインストールできるのは、マルチセッションOSのみです。Session Recording Agentがインストールできるのは、VDAがインストールされているマシンのみです。事前にVDAがインストールされていないマシンにSession Recording Agentをインストールする場合、Session Recording Agentのオプションは利用できません。

［Session Recording Administration］ を選択して ［次へ］ をクリックします。

手順6：インストールする機能を選択する

［機能］ ページで次の作業を行います：

• デフォルトでは、インストールする機能の隣のすべてのチェックボックスがオンになっています。概念実証では、これらすべての機能を1つのサーバーにインストールしても構いません。ただし、大規模な実稼働環境の場合は、Session Recordingポリシーコンソールをインストールしたサーバーとは別のサーバーに、Session Recordingサーバー、Session Recording管理者ログ、およびSession Recordingデータベースをインストールすることをお勧めします。Session Recording管理者ログは、Session Recordingサーバーのオプションのサブ機能です。Session Recording管理者ログを選択する前に、Session Recordingサーバーを選択します。
• 選択した機能をインストールしたサーバーに別の機能を追加するには、MSIパッケージを実行する必要があり、インストーラーを再実行することはできません。

インストールする機能を選択して ［次へ］ をクリックします。

手順6.1：Session Recordingデータベースのインストール

注：

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

• Session Recordingデータベースは、Azure SQL Managed Instance、Azure仮想マシン（VM）上のSQL Server、AWS RDSに展開できます。Azure SQL Managed InstanceとAWS RDSでは、SessionRecordingAdministrationx64.msiパッケージを使用した場合にのみSession Recordingデータベースを展開できます。詳しくは、「Azure SQL Managed InstanceまたはAWS RDSでのSession Recordingデータベースの展開」を参照してください。Azure VM上のSQL Serverでは、msiパッケージとCitrix Virtual Apps and Desktopsインストーラーの両方を使用してSession Recordingデータベースを展開できます。詳しくは、「Azure VM上のSQL ServerでのSession Recordingデータベースの展開」を参照してください。

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

• 展開1： Session RecordingサーバーとSession Recordingデータベースを同じマシンにインストールし、Microsoft SQL Serverをリモートマシンにインストールする （推奨）。
• 展開2：Session Recordingサーバー、Session Recordingデータベース、およびMicrosoft SQL Serverを同じマシンにインストールする。
• 展開3：Session Recordingサーバーをあるサーバーにインストールし、Session RecordingデータベースとMicrosoft SQL Serverの両方を、Session Recordingサーバーをインストールしたマシンとは別のマシンにインストールする（推奨されません）。

1.［機能］ ページで ［Session Recordingデータベース］ を選択して ［次へ］ をクリックします。

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

［データベースおよびサーバーの構成］ ページで、次の作業を行います：

• インスタンス名： データベースインスタンスが、インスタンスのセットアップ時に構成した名前付きインスタンスでない場合、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サーバー役割権限は不要になり、安全に削除できます。

  • または、Citrix Virtual Apps and Desktops ISOイメージの\layout\image-full\x64\Session RecordingにあるSessionRecordingAdministrationx64.msiパッケージを使用します。msiのインストール中、securityadminおよびdbcreatorサーバー役割権限と共に、データベース管理者の資格情報を求めるダイアログボックスが表示されます。資格情報を正確に入力して、［OK］ をクリックし、インストールを続行します。

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

• Session Recordingサーバーのコンピューターアカウント：
  • 展開1と展開2：［Session Recordingサーバーのコンピューターアカウント］ テキストボックスで、「localhost」と入力します。
  • 展開3：Session Recordingサーバーをホストするマシンの名前を、「ドメイン\コンピューター名」の形式で入力します。Session Recordingサーバーのコンピューターアカウントは、Session Recordingデータベースにアクセスするためのユーザーアカウントです。

  注：

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

3. インストール前に前提条件を確認します。

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

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

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

［完了］ をクリックしてSession Recordingデータベースのインストールを完了します。

手順6.2：Session Recordingサーバーのインストール

1.［機能］ ページで、［Session Recordingサーバー］ と ［Session Recording管理者ログ］ を選択します。［Next］ をクリックします。

注：

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

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

［データベースおよびサーバーの構成］ ページで、次の作業を行います：

• インスタンス名： ［インスタンス名］ にSQL Serverの名前を入力します。名前付きインスタンスを使用している場合は、「ドメイン\コンピューター名」を入力します。使用していない場合は、「コンピューター名」だけを入力します。SQL Serverがカスタムポート（デフォルトポート1433以外）でリスンするように構成されている場合は、インスタンス名にコンマを追加してカスタムリスナーポートを設定します。たとえば、［インスタンス名］ テキストボックスで「DXSBC-SRD-1,2433」と入力します。コンマの後の「2433」は、カスタムリスナーポートを示します。
• データベース名： ［データベース名］ テキストボックスで任意のデータベース名を入力するか、またはテキストボックスに事前設定されているデフォルトのデータベース名CitrixSessionRecordingを使用します。
• データベースのsecurityadminおよびdbcreatorサーバー役割権限が必要です。権限がない場合は、次を行います：
  • データベース管理者にインストールの権限を割り当ててもらいます。インストールの完了後は、securityadminおよびdbcreatorサーバー役割権限は不要になり、安全に削除できます。
  • または、SessionRecordingAdministrationx64.msiパッケージを使用してSession Recordingサーバーをインストールします。msiのインストール中、securityadminおよびdbcreatorサーバー役割権限と共に、データベース管理者の資格情報を求めるダイアログボックスが表示されます。資格情報を正確に入力して、［OK］ をクリックし、インストールを続行します。
• 正しいインスタンス名とデータベース名を入力したら、［接続のテスト］ をクリックしてSession Recordingデータベースへの接続をテストします。
• Session Recordingサーバーのコンピューターアカウントを入力して、［次へ］ をクリックします。

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

［管理者ログの構成］ ページで、次の作業を行います：

• 管理者ログデータベースはSQL Serverインスタンスにインストールされます： このテキストボックスは編集できません。管理者ログデータベースのSQL Serverインスタンス名は、［データベースおよびサーバーの構成］ ページで入力したインスタンス名が自動的に適用されます。
• 管理者ログデータベース名： Session Recording管理者ログ機能をインストールするには、このテキストボックスで管理者ログデータベースの任意のデータベース名を入力するか、またはテキストボックスに事前設定されたデフォルトのデータベース名CitrixSessionRecordingLoggingを使用します。

  注：

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

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

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

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

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

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

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

［完了］ をクリックしてSession Recordingサーバーのインストールを完了します。

注：

Session Recordingサーバーのデフォルトのインストールでは、通信をセキュリティで保護するためHTTPS/TLSを使用します。Session Recordingサーバーのデフォルトのインターネットインフォメーションサービス（IIS）サイトでTLSが構成されていない場合は、HTTPを使用します。これを実行するには、Session Recording Brokerサイトに移動してIIS管理コンソールでSSLを選択解除し、SSL設定を開き、［SSLを必要とする］ ボックスをオフにします。

手順6.3：Session Recordingポリシーコンソールのインストール

1.［機能］ ページで ［Session Recordingデータベース］ を選択して ［次へ］ をクリックします。

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

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

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

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

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

手順7：Broker_PowerShellSnapIn_x64.msiをインストールする

重要：

Session Recordingポリシーコンソールを使用するには、Broker PowerShellスナップイン（Broker_PowerShellSnapIn_x64.msi）をインストールする必要があります。スナップインは、インストーラーによって自動的にインストールされません。Citrix Virtual Apps and DesktopsのISO（\layout\image-full\x64\Citrix Desktop Delivery Controller）でスナップインを検索し、指示に従って手動でインストールする必要があります。従わない場合、エラーが発生する可能性があります。

Session Recording Agentのインストール

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

手順1：製品ソフトウェアをダウンロードしてウィザードを起動する

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

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

手順2：インストールする製品を選択する

インストールする製品（Citrix Virtual AppsまたはCitrix Virtual Desktops）の横にある ［開始］ をクリックします。

手順3：Session Recordingを選択する

Session Recordingエントリを選択します。

手順4：ライセンス契約書を読み、同意する

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

手順5：インストールするコンポーネントおよびインストール場所を選択する

［Session Recording Agent］ を選択して ［次へ］ をクリックします。

手順6：Agentの構成を指定する

［Agentの構成］ ページで、次の作業を行います：Session Recordingサーバーを事前にインストールしている場合は、Session Recordingサーバーをインストールしたマシンのコンピューター名と、Session Recordingサーバーとの接続のプロトコルとポート情報を入力します。Session Recordingのインストールが済んでいない場合は、後で ［Session Recording Agentのプロパティ］ でこれらの情報を変更できます。

注：

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

手順7：インストール前に前提条件を確認する

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

手順8：インストールを完了する

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

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

注：

Machine Creation Services（MCS）またはProvisioning Services（PVS）で、構成済みのマスターイメージとインストール済みのMicrosoft Message Queuing（MSMQ）を使用して複数のVDAを作成すると、一定の状況下において、これらのVDAのQMIdが同じになる可能性があります。この場合、次のようなさまざまな問題が発生する可能性があります：

• 録画契約が承認されていても、セッションが録画されない場合があります。
• セッションのログオフ信号がSession Recordingサーバーによって受信されず、セッションのステータスが常に［ライブ］になってしまう可能性があります。

解決策はVDAごとに固有のQMIdを作成することですが、方法は展開方法によって異なります。

Session Recording AgentがインストールされたシングルセッションOS VDAを、PVS 7.7以降またはMCS 7.9以降のバージョンを使用して静的デスクトップモードで作成する場合（たとえば、すべての変更が別のPersonal vDiskまたはVDAのローカルディスクで永続的になるように構成する場合）、追加の操作は不要です。

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

GenRandomQMID.ps1スクリプトを使用するには、以下の手順に従ってください：

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

Set-ExecutionPolicy RemoteSigned

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

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

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

GenRandomQMID.ps1スクリプトの概要：

1. レジストリから現在のQMIdを削除します。
2. SysPrep = 1をHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parametersに追加します。
3. CitrixSmAudAgentやMSMQなどの関連サービスを停止します。
4. ランダムなQMIdを生成するために、先ほど停止したサービスを開始します。
   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サーバーまたはドメイン内のワークステーションにSession Recording Playerをインストールします。

手順1：製品ソフトウェアをダウンロードしてウィザードを起動する

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

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

手順2：インストールする製品を選択する

インストールする製品（Citrix Virtual AppsまたはCitrix Virtual Desktops）の横にある ［開始］ をクリックします。

手順3：Session Recordingを選択する

Session Recordingエントリを選択します。

手順4：ライセンス契約書を読み、同意する

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

手順5：インストールするコンポーネントおよびインストール場所を選択する

［Session Recording Player］ を選択して ［次へ］ をクリックします。

手順6：インストール前に前提条件を確認する

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

手順7：インストールを完了する

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

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

インストールの自動化

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

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

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

たとえば、次のいずれかのコマンドを実行すると、Session Recording Administrationコンポーネントの完全なセットをインストールし、インストール情報を取得するためにログファイルを作成します。

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ファイルは\layout\image-full\x64\Session RecordingのCitrix Virtual Apps and Desktops ISOにあります。

各項目の意味は次の通りです：

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

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

Session Recordingデータベースおよび管理者ログデータベースが既存の展開に存在する可能性があります。このような場合は、SessionRecordingAdministrationx64.msiを使用してSession Recording Administrationコンポーネントをインストールするときに、データベースチェックを省略できるようになりました。マスターイメージを作成することで、Session Recordingサーバーを他の多くのマシン上で簡単に作成できます。マスターイメージを使用してターゲットマシンにサーバーを展開後、各マシンでコマンドを実行して、既存のSession Recordingデータベースと管理者ログデータベースに接続します。マスターイメージのサポートにより展開が容易になり、人的エラーによって影響を受ける可能性が最小限に抑えられます。これは新規インストールにのみ適用され、次の手順で実行します：

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

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

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

   IGNOREDBCHECKパラメーターをTrueに設定し、DATABASEINSTANCE、DATABASENAME、LOGGINGDATABASENAMEでランダムな値を使用します。

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

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

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

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

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

   SsRecUtils.exeファイルは\Citrix\SessionRecording\Server\bin\にあります。必要に応じて、DATABASEINSTANCE、DATABASENAME、およびLOGGINGDATABASENAMEパラメーターを設定します。

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

KEEPDBをTrueに設定すると、Session Recording Administrationコンポーネントのアンインストール時に次のコマンドでSession Recordingデータベースおよび管理者ログデータベースを保持します。

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

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

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

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

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

注：

SessionRecordingPlayer.msiファイルは\layout\image-full\x86\Session RecordingのCitrix Virtual Apps and Desktops ISOにあります。

SessionRecordingWebPlayer.msiファイルは\layout\image-full\x64\Session RecordingのCitrix Virtual Apps and Desktops ISOにあります。

各項目の意味は次の通りです：

• /qは、サイレントモードを指定します。
• /l*vスイッチにより詳細モードでログが記録されます。
• yourinstallationlog は、セットアップログを作成する場所です。

Session Recording Agentのインストールを自動化する

たとえば、次のコマンドでは、Session Recording Agentをインストールし、インストール情報を取得するためにログファイルを作成します。

64ビットシステム：

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

注：

SessionRecordingAgentx64.msiファイルは\layout\image-full\x64\Session RecordingのCitrix Virtual Apps and Desktops ISOにあります。

32ビットシステム：

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

注：

SessionRecordingAgent.msiファイルは\layout\image-full\x86\Session RecordingのCitrix Virtual Apps and Desktops ISOにあります。

各項目の意味は次の通りです：

• yourservernameは、Session RecordingサーバーをホストするマシンのNetBIOS名またはFQDNです。指定しない場合のデフォルト値はlocalhostです。
• yourbrokerportは、Session Recording Brokerとの通信にSession Recording Agentで使用されるポートを表すHTTPまたはHTTPSです。指定しない場合のデフォルト値はHTTPSです。
• yourbrokerportは、Session Recording Brokerとの通信にSession Recording Agentで使用されるポートを表す整数です。指定しない場合のデフォルト値は0で、選択したプロトコルのデフォルトのポート番号を使用するようSession Recording Agentに指示します。具体的には、HTTPでは80、HTTPSでは443です。
• /qは、サイレントモードを指定します。
• /l*vスイッチにより詳細モードでログが記録されます。
• yourinstallationlog は、セットアップログを作成する場所です。

Session Recordingのアップグレード

新しいバージョンのマシンやサイトをセットアップせずに、一部の環境をアップグレードすることができます。XenAppおよびXenDesktop 7.6 LTSRの最新のCUに含まれるセッション録画のバージョンから、それ以降のバージョンからセッション録画の最新リリースにアップグレードできます。

注：

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

Technical Previewバージョンからはアップグレードできません。

要件、準備、および制限

• 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 Agentをアップグレードしない場合は、Session Recording Agent 7.6.0以降を、最新リリースのSession Recordingサーバーとともに使用できます。ただし、一部の新機能やバグ修正は反映されない可能性があります。
• Session Recordingサーバーのアップグレード中に開始されたセッションは録画されません。
• デスクトップコンポジションリダイレクトモードとの互換性を維持するために、新規インストールまたはアップグレード後に［Session Recording Agentのプロパティ］の ［グラフィック調整］ オプションがデフォルトで有効になっています。このオプションは、新規インストールまたはアップグレード後に手動で無効にできます。
• 管理者ログ機能は、この機能を使用できない以前のリリースからSession Recordingをアップグレードした後はインストールされません。この機能を追加するには、アップグレード後にインストールを修正します。
• アップグレードプロセスの開始時にライブ録画セッションが実行されていた場合、録画を完了できる可能性はほとんどありません。
• サイトが停止する場合に備えて影響を軽減するために、以下のアップグレードの順序を確認してください。

アップグレードの順序

1. Session RecordingデータベースとSession Recordingサーバーが別々のサーバーにインストールされている場合、Session RecordingサーバーでSession Recordingストレージマネージャーサービスを手動で停止します。次に、まずSession Recordingデータベースをアップグレードします。
2. インターネットインフォメーションサービス（IIS）マネージャーで、Session Recording Brokerが実行されていることを確認します。Session Recordingサーバーをアップグレードします。Session RecordingデータベースとSession Recordingサーバーが同じサーバーにインストールされている場合、Session Recordingデータベースもアップグレードされます。
3. Session Recordingサーバーのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
4. （マスターイメージの）Session Recording Agentをアップグレードします。
5. Session Recordingサーバーと一緒に、またはSession Recordingサーバーの後に、Session Recordingポリシーコンソールをアップグレードします。
6. Session Recording Playerをアップグレードします。

クラウドSQLデータベースサービスでのSession Recordingデータベースの展開

ここでは、Azure SQL Managed Instance、AWS RDS、Azure VM上のSQL Serverに、Session Recordingデータベースを展開する方法について説明します。

Azure SQL Managed InstanceまたはAWS RDSでのSession Recordingデータベースの展開

ヒント：

次のような単一のコマンドを実行して、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データベースのインスタンス名です。例として、以下のスクリーンショットを参照してください。

   

3. （AWS RDSの場合のみ）エンドポイントとポートの情報を記録します。これはデータベースのインスタンス名として、<エンドポイント, ポート>という形式で使用します。

   

4. SessionRecordingAdministrationx64.msiを実行して、Session Recordingデータベースをインストールします。

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

   

   注：

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

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

   

クラウドSQL Managed Instanceへのオンプレミスデータベースの移行

1. https://docs.microsoft.com/en-us/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サーバーで、Citrix Session Recording Analyticsサービス、Citrix Session Recordingストレージマネージャーサービス、およびIISサービスを再起動します。

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

1. https://docs.microsoft.com/en-us/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サーバーで、Citrix Session Recording Analyticsサービス、Citrix Session Recordingストレージマネージャーサービス、およびIISサービスを再起動します。

Azure VM上のSQL ServerでのSession Recordingデータベースの展開

Azure VM上のSQL Serverでは、msiパッケージとCitrix Virtual Apps and Desktopsインストーラーの両方を使用してSession Recordingデータベースを展開できます。

1. Azure SQL VMを確認します。
2. VMを構成し、Session Recordingコンポーネントをインストールするドメインに追加します。
3. Session Recordingデータベースのインストール時に、VMのFQDNをインスタンス名として使用します。 注： インストールにSessionRecordingAdministrationx64.msiを使用している場合は、［クラウドSQLを有効にする］ チェックボックスをオフにします。
4. インストールユーザーインターフェイスに従って、Session Recordingデータベースのインストールを完了します。

Session Recordingのアンインストール

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

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