インストール、アップグレード、アンインストール
この記事には、次のセクションが含まれています。
インストールチェックリスト
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を構成して、Session Recordingポリシーを作成およびアクティブ化します。詳しくは、Directorを構成して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スクリプトを使用してWindowsの役割と機能の前提条件をインストールする
Session Recordingが正常に機能するためには、 Session Recordingをインストールする前に、以下の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, 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 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の役割と機能の前提条件をインストールするには、次の手順を実行します。
-
Session Recording管理コンポーネントをインストールする予定のマシンで:
-
PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認してください。
Set-ExecutionPolicy RemoteSigned <!--NeedCopy--> -
管理者としてコマンドプロンプトを起動し、
powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1コマンドを実行します。スクリプトは、正常に追加された機能を表示し、その後停止します。
-
スクリプトの実行後、実行ポリシーが会社のポリシーに基づいて適切な値に設定されていることを確認してください。
-
-
Session Recordingエージェントコンポーネントをインストールする予定のマシンで:
-
PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認してください。
Set-ExecutionPolicy RemoteSigned <!--NeedCopy--> -
管理者としてコマンドプロンプトを起動し、
powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1コマンドを実行します。スクリプトは、正常に追加された機能を表示し、その後停止します。
-
スクリプトの実行後、会社のポリシーに基づいて実行ポリシーが適切な値に設定されていることを確認してください。
-
セッションレコーディング管理コンポーネントをインストールする
セッションレコーディング管理、セッションレコーディングエージェント、およびセッションレコーディングプレーヤーの各コンポーネントを別々のサーバーにインストールすることをお勧めします。
セッションレコーディング管理コンポーネントには、セッションレコーディングデータベース、セッションレコーディングサーバー、およびセッションレコーディングポリシーコンソールが含まれます。サーバーにインストールするコンポーネントを選択できます。
-
次のファイルをインストールしてください: Broker_PowerShellSnapIn_x64.msi。
重要:
セッションレコーディングポリシーコンソールを使用するには、Broker PowerShell Snap-in (
Broker_PowerShellSnapIn_x64.msi) がインストールされている必要があります。Citrix Virtual Apps and Desktops ISO (\layout\image-full\x64\Citrix Desktop Delivery Controller) でスナップインを見つけ、手動でインストールする手順に従ってください。これに従わない場合、エラーが発生する可能性があります。 -
管理者としてWindowsコマンドプロンプトを起動し、
msiexec /i SessionRecordingAdministrationx64.msiコマンドを実行するか、.msiファイルをダブルクリックします。 -
インストールUIで、Nextをクリックし、使用許諾契約に同意します。
-
Session Recording Administration Setup画面で、インストールするセッションレコーディング管理コンポーネントを選択します。
注:
すべてのセッションレコーディング管理コンポーネントを単一のサーバーにインストールすることは、概念実証としては問題ありません。ただし、大規模な本番環境では、セッションレコーディングポリシーコンソールを別のサーバーに、セッションレコーディングサーバー、セッションレコーディング管理者ログ、およびセッションレコーディングデータベースをさらに別のサーバーにインストールすることをお勧めします。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
セッションレコーディングデータベースをインストールする
注：
Session Recording Databaseは実際のデータベースではありません。インストール中にMicrosoft SQL Serverインスタンスで必要なデータベースを作成および構成する役割を担うコンポーネントです。Session Recordingは、Microsoft SQL Serverに基づいたデータベースの高可用性ソリューションを3つサポートしています。詳しくは、「データベースの高可用性」を参照してください。
セッションレコーディングデータベースは、Azure SQL Managed Instance、Azure Virtual Machines (VM) 上のSQL Server、およびAWS RDSに展開できます。詳しくは、「Azure SQL Managed InstanceまたはAWS RDSへのセッションレコーディングデータベースの展開」(/ja-jp/session-recording/2107/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/2107/install-upgrade-uninstall.html#deploy-the-session-recording-database-on-sql-server-on-azure-vms)を参照してください。
セッションレコーディングデータベースとMicrosoft SQL Serverの展開には、通常、次の3つのタイプがあります。
- 展開1：セッションレコーディングサーバーとセッションレコーディングデータベースを同じマシンにインストールし、Microsoft SQL Serverをリモートマシンにインストールします。（推奨）
- 展開2：セッションレコーディングサーバー、セッションレコーディングデータベース、およびMicrosoft SQL Serverを同じマシンにインストールします。
- 展開3：セッションレコーディングサーバーを1台のマシンにインストールし、セッションレコーディングデータベースとMicrosoft SQL Serverの両方を別のマシンにインストールします。（非推奨）
-
「Database and Server Configuration」ページで、セッションレコーディングデータベースのインスタンス名とデータベース名、およびセッションレコーディングサーバーのコンピューターアカウントを指定します。「Next」をクリックします。
-
インスタンス名：データベースインスタンスが、インスタンス設定時に構成した名前付きインスタンスではない場合、SQL Serverのコンピューター名のみを使用できます。インスタンスに名前を付けた場合は、データベースインスタンス名としてcomputer-name\instance-nameを使用します。使用しているサーバーインスタンス名を特定するには、SQL Serverでselect @@servernameを実行します。戻り値は正確なデータベースインスタンス名です。SQL Serverがカスタムポート（デフォルトのポート1433以外）でリッスンするように構成されている場合は、インスタンス名にコンマを追加してカスタムリスナーポートを設定します。たとえば、「Instance name」テキストボックスに「DXSBC-SRD-1,2433」と入力します。ここで、コンマに続く2433はカスタムリスナーポートを示します。
-
データベース名：「Database name」テキストボックスにカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名を使用します。「Test connection」をクリックして、SQL Serverインスタンスへの接続とデータベース名の有効性をテストします。
重要:
カスタムデータベース名には、A～Z、a～z、0～9、およびアンダースコアのみを含めることができ、123文字を超えることはできません。
- データベースのsecurityadminおよびdbcreatorサーバーロール権限が必要です。権限がない場合は、次のことができます:
- データベース管理者にインストールの権限を割り当てるよう依頼します。インストールが完了したら、securityadmin および dbcreator サーバーロールの権限は不要になり、安全に削除できます。
- または、MSIインストール中に、securityadmin および dbcreator サーバーロールの権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、OK をクリックしてインストールを続行します。
インストールにより、セッションレコーディングデータベースが作成され、セッションレコーディングサーバーのマシンアカウントが db_owner として追加されます。
- データベースのsecurityadminおよびdbcreatorサーバーロール権限が必要です。権限がない場合は、次のことができます:
-
セッションレコーディングサーバーのコンピューターアカウント：
-
展開1および2：セッションレコーディングサーバーのコンピューターアカウント テキストボックスに「localhost」と入力します。
-
展開3：セッションレコーディングサーバーをホストしているマシンの名前を、domain\computer-name の形式で入力します。セッションレコーディングサーバーのコンピューターアカウントは、セッションレコーディングデータベースにアクセスするためのユーザーアカウントです。
注：
セッションレコーディングサーバーのコンピューターアカウント テキストボックスにドメイン名が設定されている場合、セッションレコーディング管理コンポーネントのインストールがエラーコード1603で失敗することがあります。回避策として、セッションレコーディングサーバーのコンピューターアカウント テキストボックスに「localhost」またはNetBIOSドメイン名\マシン名を入力します。NetBIOSドメイン名を取得するには、セッションレコーディングサーバーがインストールされているマシンで、PowerShellで
$env:userdomainを実行するか、コマンドプロンプトでecho %UserDomain%を実行します。 -
-
-
指示に従ってインストールを完了します。
セッションレコーディングサーバーのインストール
-
セッションレコーディングサーバー と セッションレコーディング管理者ログ を選択します。
注：
- セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
- セッションレコーディング管理者ログは、セッションレコーディングサーバーと同時にインストールすることをお勧めします。管理者ログ機能を有効にしたくない場合は、後のページで無効にできます。
-
データベースとサーバーの構成 ページで、設定を指定します。
- インスタンス名: 「インスタンス名」テキストボックスにSQL Serverの名前を入力します。名前付きインスタンスを使用している場合は、コンピューター名\インスタンス名を入力します。それ以外の場合は、コンピューター名のみを入力します。SQL Serverがカスタムポート（デフォルトのポート1433以外）でリッスンするように構成されている場合は、インスタンス名にコンマを追加してカスタムリスナーポートを設定します。たとえば、「インスタンス名」テキストボックスに「DXSBC-SRD-1,2433」と入力します。ここで、コンマに続く2433はカスタムリスナーポートを示します。
-
データベース名: 「データベース名」テキストボックスにカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名「CitrixSessionRecording」を使用します。
データベースのsecurityadminおよびdbcreatorサーバーロール権限が必要です。権限がない場合は、次のことができます。
- データベース管理者に、インストール用の権限を割り当てるよう依頼します。インストールが完了すると、securityadminおよびdbcreatorサーバーロール権限は不要になり、安全に削除できます。
- または、MSIインストール中に、securityadminおよびdbcreatorサーバーロール権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、OKをクリックしてインストールを続行します。
-
正しいインスタンス名とデータベース名を入力したら、接続テストをクリックしてSession Recordingデータベースへの接続をテストします。
- Session Recording Serverのコンピューターアカウントを入力し、次へをクリックします。
-
「管理ログ構成」ページで、管理ログ機能の構成を指定します。
- ログデータベースはSQL Serverインスタンスにインストールされています: このテキストボックスは編集できません。管理ログデータベースのSQL Serverインスタンス名は、「データベースとサーバーの構成」ページで入力したインスタンス名から自動的に取得されます。
-
ログデータベース名：Session Recording管理者ログ機能をインストールするには、このテキストボックスに管理者ログデータベースのカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名「CitrixSessionRecordingLogging」を使用します。
注：
管理者ログデータベース名は、前の「データベースとサーバーの構成」ページの「データベース名」テキストボックスで設定されたSession Recordingデータベース名とは異なる必要があります。
- デフォルトのデータベース名を使用する: このオプションを選択すると、デフォルトのログデータベース名が使用されます。
- ログサービスを有効にする: デフォルトでは、管理ログ機能は有効になっています。チェックボックスをオフにすることで無効にできます。
- 強制ブロックを有効にする: デフォルトでは、強制ブロックは有効になっています。ログ記録に失敗した場合、通常の機能がブロックされる可能性があります。チェックボックスをオフにすることで強制ブロックを無効にできます。
-
次へをクリックして、インストールを完了します。
注：
Session Recording Serverのデフォルトインストールでは、通信を保護するためにHTTPS/TLSを使用します。Session Recording ServerのデフォルトのInternet Information Services (IIS) サイトでTLSが構成されていない場合は、HTTPを使用します。これを行うには、IIS管理コンソールでSession Recording Brokerサイトに移動し、SSL設定を開き、［Require SSL］チェックボックスをオフにして、SSLの選択をキャンセルします。
セッションレコーディングエージェントをインストールする
セッションを記録するVDAまたはVDIマシンにSession Recording Agentをインストールします。
- Session Recording Agentの構成ページで、Session Recording Serverを事前にインストールしている場合は、Session Recording Serverをインストールしたマシンのコンピューター名、およびSession Recording Serverへの接続のプロトコルとポート情報を入力します。Session Recordingをまだインストールしていない場合は、後でSession Recording Agentのプロパティでこの情報を変更できます。
- 指示に従ってインストールを完了します。
注：
Machine Creation Services（MCS）またはProvisioning Services（PVS）が、構成済みのマスターイメージとMicrosoft Message Queuing（MSMQ）がインストールされた複数のVDAを作成する場合、特定の条件下でそれらのVDAが同じQMIdを持つことがあります。このケースでは、次のようなさまざまな問題が発生する可能性があります。
- 記録契約が承認されていても、セッションが記録されない場合があります。
- Session Recording Serverがセッションログオフ信号を受信できず、そのためセッションが常にLive状態になる場合があります。
回避策として、各VDAに一意のQMIdを作成します。これは展開方法によって異なります。
Session Recording AgentがインストールされたシングルセッションOS VDAが、PVS 7.7以降およびMCS 7.9以降で、静的デスクトップモード（たとえば、すべての変更を個別のPersonal vDiskまたはVDAのローカルディスクに永続化するように構成されているもの）で作成されている場合、追加の操作は必要ありません。
MCSまたはPVSで作成されたマルチセッションOS VDA、およびユーザーがログオフしたときにすべての変更を破棄するように構成されたシングルセッションOS VDAの場合、GenRandomQMID.ps1スクリプトを使用してシステム起動時にQMIdを変更します。ユーザーのログオン試行前に十分なVDAが実行されていることを確認するために、電源管理戦略を変更します。
GenRandomQMID.ps1スクリプトを使用するには、次の手順を実行します。
1. PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認します。
Set-ExecutionPolicy RemoteSigned2. スケジュールされたタスクを作成し、トリガーをシステム起動時に設定し、PVSまたはMCSマスターイメージマシンでSYSTEMアカウントで実行します。
3. コマンドをスタートアップタスクとして追加します。
powershell .exe -file C:\\GenRandomQMID.ps1GenRandomQMID.ps1 スクリプトに関する概要:
- 現在のQMIdをレジストリから削除します。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\ParametersにSysPrep = 1を追加します。- CitrixSmAudAgentおよびMSMQを含む関連サービスを停止します。
- ランダムなQMIdを生成するには、以前に停止したサービスを開始します。
Example GENRANDOMQMID.PS1:
# Remove old QMId from registry and set SysPrep flag for MSMQ Remove-Itemproperty -Path >HKLM:Software\Microsoft\MSMQ\Parameters\MachineCache -Name QMId -Force Set-ItemProperty -Path HKLM:Software\Microsoft\MSMQ\Parameters -Name >"SysPrep" -Type DWord -Value 1 # Get dependent services $depServices = Get-Service -name MSMQ -dependentservices | Select -Property Name # Restart MSMQ to get a new QMId Restart-Service -force MSMQ # Start dependent services if ($depServices -ne $null) { foreach ($depService in $depServices) { $startMode = Get-WmiObject win32_service -filter "NAME = '$($depService.Name)'" | Select -Property StartMode if ($startMode.StartMode -eq "Auto") { Start-Service $depService.Name } } } <!--NeedCopy-->
セッションレコーディングプレイヤーとウェブプレイヤーをインストールする
セッションレコーディングプレイヤーは、セッションレコーディングサーバーまたはドメイン内のワークステーションにインストールします。Web Playerは、セッションレコーディングサーバーにのみインストールします。
SessionRecordingPlayer.msiとSessionRecordingWebPlayer.msiをダブルクリックし、指示に従ってインストールを完了します。
インストールの自動化
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ファイルは、シトリックス バーチャル アプリケーションズ アンド デスクトップ 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 は、セッションレコーディングサーバーのコンピューターアカウントです。
- AZUREUSERNAME は、クラウド SQL 管理者名です。
- AZUREPASSWORD は、クラウド SQL 管理者パスワードです。
- /q は、サイレントモードを指定します。
- /l*v は、詳細ログを有効にします。
- yourinstallationlog は、インストールログファイルの場所です。
セッションレコーディングサーバーを展開するためのマスターイメージを作成する
既存の展開から、セッションレコーディングデータベースと管理ログデータベースがすでに配置されている場合があります。このようなシナリオでは、SessionRecordingAdministrationx64.msiを使用してセッションレコーディング管理コンポーネントをインストールする際に、データベースチェックを省略できるようになりました。セッションレコーディングサーバーを展開するためのマスターイメージを、他の多くのマシンに簡単に作成できます。マスターイメージを使用してターゲットマシンにサーバーを展開した後、各マシンでコマンドを実行して、既存のセッションレコーディングデータベースと管理ログデータベースに接続します。このマスターイメージのサポートにより、展開が容易になり、人為的ミスの潜在的な影響が最小限に抑えられます。これは新規インストールにのみ適用され、次の手順で構成されます。
-
コマンドプロンプトを起動し、次のようなコマンドを実行します。
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には、ランダムな値を指定するようにしてください。
-
操作しているマシンでマスターイメージを作成します。
-
セッションレコーディングサーバーを展開するために、マスターイメージを他のマシンに展開します。
-
各マシンで、次のようなコマンドを実行します。
.\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ファイルは、シトリックス バーチャル アプリケーションズ アンド デスクトップス ISO の\layout\image-full\x86\Session Recordingにあります。
SessionRecordingWebPlayer.msiファイルは、シトリックス バーチャル アプリケーションズ アンド デスクトップス ISO の\layout\image-full\x64\Session Recordingにあります。
ここで、
- /q はサイレントモードを指定します。
- /l*v は詳細ログ記録を指定します。
- yourinstallationlog は、インストールログファイルの場所です。
セッションレコーディングエージェントのインストールを自動化する
たとえば、次のコマンドは Session Recording Agent をインストールし、インストール情報をキャプチャするためのログファイルを作成します。
64ビットシステムの場合:
msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->
注:
SessionRecordingAgentx64.msiファイルは、シトリックス バーチャル アプリケーションズ アンド デスクトップス ISO の\layout\image-full\x64\Session Recordingにあります。
32ビットシステムの場合:
msiexec /i SessionRecordingAgent.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->
注:
SessionRecordingAgent.msiファイルは、シトリックス バーチャル アプリ アンド デスクトップ ISO の\layout\image-full\x86\Session Recordingにあります。
ここで、
- yourservername は、セッションレコーディングサーバーをホストするマシンの NetBIOS 名または FQDN です。指定しない場合、この値はデフォルトで localhost になります。
- yourbrokerprotocol は、セッションレコーディングエージェントがセッションレコーディングブローカーと通信するために使用する HTTP または HTTPS です。指定しない場合、この値はデフォルトで HTTPS になります。
- yourbrokerport は、セッションレコーディングエージェントがセッションレコーディングブローカーと通信するために使用するポート番号です。指定しない場合、この値はデフォルトでゼロになり、セッションレコーディングエージェントは選択したプロトコルのデフォルトポート番号（HTTP の場合は 80、HTTPS の場合は 443）を使用するよう指示されます。
- /q はサイレントモードを指定します。
- /l*v は詳細ログ記録を指定します。
- yourinstallationlog は、インストールログファイルの場所です。
セッションレコーディングのアップグレード
特定の展開を、新しいマシンやサイトを最初にセットアップすることなく、新しいバージョンにアップグレードできます。セッションレコーディング 7.15 LTSR の最新の CU およびそれ以降のバージョンから、セッションレコーディングの最新リリースにアップグレードできます。
注:
セッションレコーディング管理を 7.6 から 7.13 以降にアップグレードし、セッションレコーディング管理で 変更 を選択して管理者ログサービスを追加すると、SQL Server インスタンス名が 管理者ログ構成 ページに表示されません。次へ をクリックすると、次のエラーメッセージが表示されます: データベース接続テストに失敗しました。正しいデータベースインスタンス名を入力してください。 回避策として、localhost ユーザーに次の SmartAuditor Server レジストリフォルダーへの読み取り権限を追加してください:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server。テクニカルプレビューバージョンからアップグレードすることはできません。
要件、準備、および制限
- セッションレコーディングインストーラーのグラフィカルインターフェイスまたはコマンドラインインターフェイスを使用して、コンポーネントをインストールしたマシン上のセッションレコーディングコンポーネントをアップグレードします。
- アップグレード作業を行う前に、SQL Server インスタンス内の CitrixSessionRecording という名前のデータベースをバックアップしてください。これにより、データベースのアップグレード後に問題が発見された場合でも復元できます。
- ドメインユーザーであることに加えて、セッションレコーディングコンポーネントをアップグレードするマシンではローカル管理者である必要があります。
- 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のプロパティにあるGraphics Adjustmentオプションは、デスクトップコンポジションリダイレクトモードとの互換性を保つため、新規インストールまたはアップグレード後にデフォルトで有効になります。新規インストールまたはアップグレード後に、このオプションを手動で無効にすることができます。
- この機能が利用できなかった以前のリリースからSession Recordingをアップグレードしても、管理者ログ機能はインストールされません。この機能を追加するには、アップグレード後にインストールを変更してください。
- アップグレードプロセス開始時にライブ録画セッションがある場合、録画が完了する可能性はほとんどありません。
- 潜在的な停止を計画し、軽減できるように、以下のアップグレードシーケンスを確認してください。
アップグレードシーケンス
- セッションレコーディングデータベースとセッションレコーディングサーバーが異なるサーバーにインストールされている場合は、セッションレコーディングサーバーでセッションレコーディングストレージマネージャーサービスを手動で停止します。その後、セッションレコーディングデータベースを最初にアップグレードします。
- Internet Information Services (IIS) マネージャーを通じて、セッションレコーディングブローカーが実行されていることを確認します。セッションレコーディングサーバーをアップグレードします。セッションレコーディングデータベースとセッションレコーディングサーバーが同じサーバーにインストールされている場合、セッションレコーディングデータベースもアップグレードされます。
- Session Recording Serverのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
- Session Recording Agent（マスターイメージ上）をアップグレードします。
- セッションレコーディングサーバーと同時に、またはその後にセッションレコーディングポリシーコンソールをアップグレードします。
- セッションレコーディングプレイヤーをアップグレードします。
クラウド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-->
-
Azure SQL マネージドインスタンスを作成するか、Amazon RDS コンソールを介して SQL Server インスタンスを作成します。
-
(Azure SQLのみ) プロパティパネルに表示されるサーバー文字列を記録しておきます。これらの文字列は、セッションレコーディングデータベースのインスタンス名です。例については、次のスクリーンショットを参照してください。
-
(AWS RDSのみ) エンドポイントとポートの情報を記録しておきます。これは、<エンドポイント, ポート>の形式でデータベースのインスタンス名として使用されます。
-
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サービスを再起動します。
クラウドSQL管理者パスワードを更新する(/ja-jp/session-recording/2107/media/updating-cloud-sql-admin-password.png)
オンプレミスデータベースをクラウドSQLマネージドインスタンスに移行する
-
オンプレミスデータベースを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に従って移行します。
-
移行後に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 -
セッションレコーディングサーバーで、Citrix セッションレコーディングアナリティクスサービス、Citrix セッションレコーディングストレージマネージャーサービス、およびIISサービスを再起動します。
Azure SQL Managed Instanceからオンプレミスデータベースに本番データベースを移行する
-
https://docs.microsoft.com/ja-jp/data-migration/に従ってデータベースを移行します。
-
移行後に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 -
セッションレコーディングサーバーで、Citrix セッションレコーディングアナリティクスサービス、Citrix セッションレコーディングストレージマネージャーサービス、およびIISサービスを再起動します。
Azure仮想マシン上のSQLサーバーにセッションレコーディングデータベースを展開する
Azure仮想マシン上のSQLサーバーにセッションレコーディングデータベースを展開できます。
- Azure SQL VMをチェックアウトします。
- VMを構成し、Session Recordingコンポーネントをインストールするドメインに追加します。
- セッションレコーディングデータベースのインストール時に、VMのFQDNをインスタンス名として使用します。 注： SessionRecordingAdministrationx64.msiを使用してインストールする場合、Enable cloud SQLチェックボックスをオフにします。
- インストールを完了するには、指示に従ってください。
セッションレコーディングのアンインストール
サーバーまたはワークステーションからセッションレコーディングコンポーネントを削除するには、Windowsのコントロールパネルにあるプログラムのアンインストールまたは削除オプションを使用します。 セッションレコーディングデータベースを削除するには、インストール時と同じsecurityadminおよびdbcreatorのSQL Serverロール権限が必要です。
セキュリティ上の理由から、コンポーネントのアンインストール後も管理者ログデータベースは削除されません。