インストール、アップグレード、およびアンインストール
注:
負荷分散によりサーバーの高可用性を構成する方法については、「既存の環境での負荷分散の構成」および「AzureでのSession Recordingの展開と負荷分散」を参照してください。
この記事は、次のセクションで構成されています。
インストールチェックリスト
次のファイルを使用して、Session Recordingコンポーネントをインストールします:
-
Broker_PowerShellSnapIn_x64.msi
-
SessionRecordingAdministrationx64.msi
-
SessionRecordingAgentx64.msi
-
SessionRecordingPlayer.msi
-
SessionRecordingWebPlayer.msi
インストールを始める前に、以下のリストに記載されている作業を行います:
✔ | 手順 |
---|---|
インストールを開始する前に、前提条件をインストールします。「システム要件」および「Citrixスクリプトを使用したWindowsの役割と機能の前提条件のインストール」を参照してください。 | |
Session Recordingの各コンポーネントをインストールするマシンを選択します。各マシンがインストールするコンポーネントのハードウェアおよびソフトウェアの要件を満たしていることを確認してください。 | |
Citrixアカウント資格情報を使用して、Citrix Virtual Apps and Desktopsのダウンロードページにアクセスして、製品ファイルをダウンロードします。ファイルを解凍します。 | |
Session Recordingコンポーネント間の通信にTLSプロトコルを使用するには、正しい証明書を環境にインストールします。 | |
Session Recordingコンポーネントに必要なHotfixをインストールします。HotfixはCitrixサポートから入手できます。 | |
Directorを構成して、Session Recordingポリシーを作成およびアクティブ化します。詳しくは、「Directorを構成してSession Recordingサーバーを使用する」を参照してください。 |
注:
- 録画ポリシーに基づいて、公開アプリケーションを個別のデリバリーグループに分割することをお勧めします。公開アプリケーションのセッション共有は、同じデリバリーグループ内のアクティブなポリシーと競合する可能性があります。Session Recordingでは、アクティブなポリシーとユーザーが最初に開いた公開アプリケーションを照合します。バージョン7.18リリース以降、動的なセッションの録画機能を使用して、セッション中いつでもセッションの録画を開始または停止できます。詳しくは、「動的なセッションの録画」を参照してください。
- Machine Creation Services(MCS)またはCitrix Provisioningを使用する計画がある場合は、一意な
QMId
を準備します。この手順の実行に失敗すると、録画データが損失する可能性があります。- SQL ServerではTCP/IPを有効にする必要があり、SQL Server Browserサービスが実行中で、またWindows認証の使用が必要です。
- HTTPSを使用するには、TLS/HTTPSのサーバー証明書を構成します。
Local Users and Groups > Groups > Users
のユーザーがC:\windows\Temp
フォルダーへの書き込み権限があることを確認してください。
Citrixスクリプトを使用したWindowsの役割と機能の前提条件のインストール
以下のCitrixスクリプトを使用して、Session Recordingが正しく動作するために必要な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の役割と機能の前提条件をインストールするには、次の手順を完了します:
-
Session Recording Administrationコンポーネントをインストールする予定のマシンで以下を行います:
-
PowerShellの実行ポリシーがRemoteSignedかUnrestrictedに設定されていることを確認してください。
Set-ExecutionPolicy RemoteSigned <!--NeedCopy-->
-
コマンドプロンプトを管理者として起動し、
powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1
コマンドを実行します。正常に追加されている機能が表示され、スクリプトは停止します。
-
スクリプトの実行後、実行ポリシーが社内ポリシーに基づく適切な値に設定されていることを確認します。
-
-
Session Recording Agentコンポーネントをインストールする予定のマシンで以下を行います:
-
PowerShellの実行ポリシーがRemoteSignedかUnrestrictedに設定されていることを確認してください。
Set-ExecutionPolicy RemoteSigned <!--NeedCopy-->
-
コマンドプロンプトを管理者として起動し、
powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1
コマンドを実行します。正常に追加されている機能が表示され、スクリプトは停止します。
-
スクリプトの実行後、実行ポリシーが社内ポリシーに基づく適切な値に設定されていることを確認します。
-
Session Recording Administrationコンポーネントのインストール
注:
2110以降、TLS 1.0が無効になっているWindows Server 2016にSession Recording Administrationコンポーネントをインストールする前に、次の手順を実行します。
- OLE DB Driver for SQL Serverをインストールします。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319
レジストリキーで、SchUseStrongCrypto
DWORD(32ビット)値を追加して、値を1に設定します。- 再起動します。
Session Recording Administration、Session Recording Agent、およびSession Recording Playerの各コンポーネントを別々のサーバーにインストールすることをお勧めします。
Session Recording Administrationコンポーネントは、Session Recordingデータベース、Session Recordingサーバー、およびSession Recordingポリシーコンソールから構成されています。コンポーネントを選択してサーバーにインストールできます。
注:
2110以降、TLS 1.0が無効になっているWindows Server 2016にSession Recording Administrationコンポーネントをインストールする前に、次の手順を実行します。
- OLE DB Driver for SQL Serverをインストールします。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319
レジストリキーで、SchUseStrongCrypto
DWORD(32ビット)値を追加して、値を1に設定します。- Windows Server 2016を再起動します。
-
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
)でスナップインを検索し、インストール手順に従います。従わない場合、エラーが発生する可能性があります。 -
Windowsコマンドプロンプトを管理者として起動し、
msiexec /i SessionRecordingAdministrationx64.msi
コマンドを実行するか、この.msiファイルをダブルクリックします。 -
インストールUIで [次へ] を選択して、ライセンス契約に同意します。
-
Session Recording Administration Setup画面で、インストールするSession Recording Administrationコンポーネントを選択します。
注:
概念実証では、すべてのSession Recording Administrationコンポーネントを1つのサーバーにインストールしても構いません。ただし、大規模な実稼働環境の場合は、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つのソリューションをサポートしています。詳しくは、「データベースの高可用性」を参照してください。
Session Recordingデータベースは、Azure SQL Managed Instance、Azure仮想マシン(VM)上のSQL Server、AWS RDSに展開できます。詳しくは、「Azure SQL Managed Instanceまたは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:Session Recordingサーバー、Session Recordingデータベース、およびMicrosoft SQL Serverを同じマシンにインストールする。
- 展開3:Session Recordingサーバーをあるサーバーにインストールし、Session RecordingデータベースとMicrosoft SQL Serverの両方を、Session Recordingサーバーをインストールしたマシンとは別のマシンにインストールする(推奨されません)。
-
[データベースおよびサーバーの構成] ページで、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として追加されます。
- データベースのサーバーの役割権限であるsecurityadminおよびdbcreatorが必要です。権限がない場合は、次を行います:
-
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%
」を実行します。 -
-
-
手順に従ってインストールを完了します。
Session Recordingサーバーのインストール
-
[機能] ページで、[Session Recordingサーバー] と [Session Recording管理者ログ] を選択します。
注:
- Session Recording管理者ログは、Session Recordingサーバーのオプションのサブ機能です。Session Recording管理者ログを選択する前に、Session Recordingサーバーを選択します。
- Session Recording管理者ログとSession Recordingサーバーを同時にインストールすることをお勧めします。管理者ログ機能を有効にしない場合は、後のページで無効にできます。
-
[データベースおよびサーバーの構成] ページで、設定を指定します。
- インスタンス名: [インスタンス名] にSQL Serverの名前を入力します。名前付きインスタンスを使用している場合は、「コンピューター名\インスタンス名」を入力します。使用していない場合は、「コンピューター名」だけを入力します。SQL Serverがカスタムポート(デフォルトポート1433以外)でリスンする場合は、インスタンス名にコンマを追加してカスタムリスナーポートを設定します。たとえば、[インスタンス名] テキストボックスで「DXSBC-SRD-1,2433」と入力します。コンマの後の「2433」は、カスタムリスナーポートを示します。
-
データベース名: [データベース名] テキストボックスで任意のデータベース名を入力するか、またはテキストボックスに事前設定されているデフォルトのデータベース名CitrixSessionRecordingを使用します。
データベースのサーバーの役割権限であるsecurityadminおよびdbcreatorが必要です。権限がない場合は、次を行います:
- データベース管理者にインストールの権限を割り当ててもらいます。インストールの完了後は、securityadminおよびdbcreatorサーバー役割権限は不要になり、安全に削除できます。
- または、msiのインストール中、securityadminおよびdbcreatorサーバー役割権限とともに、データベース管理者の資格情報を求めるダイアログボックスが表示されます。資格情報を正確に入力して、[OK] をクリックし、インストールを続行します。
-
正しいインスタンス名とデータベース名を入力したら、[接続のテスト] をクリックしてSession Recordingデータベースへの接続をテストします。
- Session Recordingサーバーのコンピューターアカウントを入力して、[次へ] をクリックします。
-
[管理者ログの構成] ページで、管理者ログ機能の構成を指定します。
- ログデータベースはSQL Serverインスタンスにインストールされます: このテキストボックスは編集できません。管理者ログデータベースのSQL Serverインスタンス名は、[データベースおよびサーバーの構成] ページで入力したインスタンス名が自動的に適用されます。
-
ログデータベース名: このテキストボックスで管理者ログデータベースの任意のデータベース名を入力するか、またはテキストボックスに事前設定されたデフォルトのデータベース名CitrixSessionRecordingLoggingを使用します。
注:
管理者ログデータベース名は [データベースとサーバーの構成] ページの [データベース名] テキストボックスで設定したSession Recordingデータベース名と異なるものにする必要があります。
- デフォルトのデータベース名を使用します:このオプションを選択すると、デフォルトのログデータベース名が使用されます。
- ロギングサービスを有効にする:デフォルトでは、管理者ログ機能は有効になっています。チェックボックスをオフにしてこの機能を無効にできます。
- 強制ブロッキングを有効にする:デフォルトでは強制ブロッキングが有効になっているため、ログが失敗すると通常の機能がブロックされることがあります。チェックボックスをオフにして強制ブロッキング(必須のブロック)を無効にできます。
-
[次へ] をクリックしてインストールを完了します。
注:
Session Recordingサーバーのデフォルトのインストールでは、通信をセキュリティで保護するためHTTPS/TLSを使用します。Session Recordingサーバーのデフォルトのインターネットインフォメーションサービス(IIS)サイトでTLSが構成されていない場合は、HTTPを使用します。これを行うには、IIS管理コンソールでSSLの選択をキャンセルします。Session Recording Brokerサイトに移動し、SSL設定を開き、[Require SSL] チェックボックスをオフにします。
Session Recording Agentのインストール
Session Recording Agentは、セッションを録画するVDAまたはVDIマシンにインストールします。
- [Session Recording Agent構成] ページで、次の作業を行います:Session Recordingサーバーを事前にインストールしている場合は、Session Recordingサーバーをインストールしたマシンのコンピューター名を入力します。Session Recordingサーバーとの接続のプロトコルとポート情報を入力します。Session Recordingのインストールが済んでいない場合は、後で [Session Recording Agentのプロパティ] でこれらの情報を変更できます。
- 手順に従ってインストールを完了します。
注:
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は、
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スクリプトの概要:
- レジストリから現在の
QMId
を削除します。SysPrep = 1
をHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters
に追加します。- CitrixSmAudAgentやMSMQなどの関連サービスを停止します。
- ランダムな
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とWeb Playerのインストール
Session Recordingサーバーまたはドメイン内のワークステーションにSession Recording Playerをインストールします。Session RecordingサーバーでのみWeb Playerをインストールします。
SessionRecordingPlayer.msi
とSessionRecordingWebPlayer.msi
をダブルクリックし、手順に従ってインストールを完了します。
インストールの自動化
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データベースと管理者ログデータベースに接続します。このマスターイメージのサポートにより展開が容易になり、人的エラーによって影響を受ける可能性が最小限に抑えられます。これは新規インストールにのみ適用され、次の手順で実行します:
-
コマンドプロンプトを起動し、次のようなコマンドを実行します:
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でランダムな値を使用します。
-
操作しているマシン上にマスターイメージを作成します。
-
Session Recordingサーバーを展開するために、マスターイメージを他のマシンに展開します。
-
各マシンで、次のようなコマンドを実行します:
.\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をインストールし、インストール情報を取得するためにログファイルを作成します。
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にあります。
各項目の意味は次のとおりです:
- 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のアップグレード
新しいバージョンのマシンやサイトをセットアップせずに、一部の環境をアップグレードすることができます。Session Recording 7.15 LTSRの最新のCUおよび以降のバージョンからSession Recordingの最新バージョンにアップグレードできます。
注:
Session Recording Administrationを7.6から7.13以降にアップグレードし、[変更] を選択して管理者ログサービス追加した場合、[管理者ログの構成] ページに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 7.6.0以降は最新バージョンのSession Recordingサーバーと互換性があります。ただし、一部の新機能やバグ修正は反映されない可能性があります。
- Session Recordingサーバーのアップグレード中に開始されたセッションは録画されません。
- デスクトップコンポジションリダイレクトモードとの互換性を維持するために、新規インストールまたはアップグレード後に [Session Recording Agentのプロパティ] の [グラフィック調整] オプションがデフォルトで有効になっています。このオプションは、新規インストールまたはアップグレード後に手動で無効にできます。
- 管理者ログ機能は、この機能を使用できない以前のバージョンからSession Recordingをアップグレードした後はインストールされません。この機能を追加するには、アップグレード後にインストールを修正します。
- アップグレードプロセスの開始時にライブ録画セッションが実行されていた場合、録画を完了できる可能性はほとんどありません。
- サイトが停止する場合に備えて影響を軽減するために、以下のアップグレードの順序を確認してください。
アップグレードの順序
- Session RecordingデータベースとSession Recordingサーバーが別々のサーバーにインストールされている場合、Session RecordingサーバーでSession Recordingストレージマネージャーサービスを手動で停止します。次に、まずSession Recordingデータベースをアップグレードします。
- インターネットインフォメーションサービス(IIS)マネージャーで、Session Recording Brokerが実行されていることを確認します。Session Recordingサーバーをアップグレードします。Session RecordingデータベースとSession Recordingサーバーが同じサーバーにインストールされている場合、Session Recordingデータベースもアップグレードされます。
- Session Recordingサーバーのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
- (マスターイメージの)Session Recording Agentをアップグレードします。
- Session Recordingサーバーと一緒に、またはSession Recordingサーバーの後に、Session Recordingポリシーコンソールをアップグレードします。
- 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-->
-
Azure SQL Managed Instanceを作成するか、Amazon RDSコンソールからSQL Serverインスタンスを作成します。
-
(Azure SQLの場合のみ)プロパティパネルに表示されるServerの文字列を記録しておきます。この文字列は、Session Recordingデータベースのインスタンス名です。例として、以下のスクリーンショットを参照してください。
-
(AWS RDSの場合のみ)エンドポイントとポートの情報を記録します。これはデータベースのインスタンス名として、<エンドポイント, ポート>という形式で使用します。
-
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へのオンプレミスデータベースの移行
-
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に従って、オンプレミスデータベースを移行します。
-
移行後に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
-
Session Recordingサーバーで、Citrix Session Recording Analyticsサービス、Citrix Session Recordingストレージマネージャーサービス、およびIISサービスを再起動します。
Azure SQL Managed Instanceからオンプレミスデータベースへの実稼働データベースの移行
-
https://docs.microsoft.com/en-us/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
-
Session Recordingサーバーで、Citrix Session Recording Analyticsサービス、Citrix Session Recordingストレージマネージャーサービス、およびIISサービスを再起動します。
Azure VM上のSQL ServerでのSession Recordingデータベースの展開
Azure VM上のSQL ServerでSession Recordingデータベースを展開できます。
- Azure SQL VMを確認します。
- VMを構成し、Session Recordingコンポーネントをインストールするドメインに追加します。
- Session Recordingデータベースのインストール時に、VMのFQDNをインスタンス名として使用します。 注: インストールにSessionRecordingAdministrationx64.msiを使用している場合は、[クラウドSQLを有効にする] チェックボックスをオフにします。
- 手順に従ってインストールを完了します。
Session Recordingのアンインストール
サーバーやワークステーションからSession Recordingコンポーネントを削除するには、Windowsのコントロールパネルのプログラムのアンインストールまたは削除オプションを使用します。Session Recordingデータベースを削除するには、インストール時と同じSQL Serverの役割権限securityadminおよびdbcreatorが必要です。
セキュリティ上の理由により、コンポーネントがアンインストールされた後には管理者ログデータベースは削除されません。
Citrix Analytics for Securityとの統合
Session Recordingサーバーを構成して、ユーザーイベントをCitrix Analytics for Securityに送信できます。Citrix Analytics for Securityは、このユーザーイベントを処理して、ユーザーの動作に関する実用的な分析情報を提供します。
前提条件
開始前に、次の前提条件が満たされていることを確認してください:
-
Session Recordingサーバーが、次のアドレスに接続できます:
-
Session Recording展開では、送信インターネット接続用にポート443が解放されています。ネットワーク上のすべてのプロキシサーバーは、このCitrix Analytics for Securityとの通信を許可する必要があります。
-
Citrix Virtual Apps and Desktops 7 1912 LTSRを使用している場合、サポートされているSession Recordingのバージョンは2103以降です。
Session RecordingサーバーをCitrix Analytics for Securityに接続する
-
Citrix Cloudにサインインします。
-
Citrix Analytics for Securityを見つけて、[Manage] をクリックします。
-
トップバーから [Settings]>[Data Sources] をクリックします。
-
[Virtual Apps and Desktops- Session Recording] サイトカードで、[Connect Session Recording server] をクリックします。
-
[Connect Session Recording Server] ページで、チェックリストを確認し、すべての必須要件を選択します。必須要件を選択しない場合、[Download File] オプションは無効になります。
-
ネットワークにプロキシサーバーがある場合は、Session RecordingサーバーのSsRecStorageManager.exe.configファイルにプロキシアドレスを入力します。
構成ファイルは次の場所にあります:
<Session Recording server installation path>\bin\SsRecStorageManager.exe.config
たとえば、次のようになります:
C:\Program Files\Citrix\SessionRecording\Server\Bin\SsRecStorageManager.exe.config
-
[Download File] をクリックして、SessionRecordingConfigurationFile.jsonファイルをダウンロードします。
注:
このファイルには機密情報が含まれています。ファイルを安全な場所に保存します。
-
Citrix Analytics for Securityに接続するSession Recordingサーバーにファイルをコピーします。
展開に複数のSession Recordingサーバーがある場合は、接続する各サーバーにファイルをコピーし、手順に従って各サーバーを構成する必要があります。
-
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-->
-
次のサービスを再起動します:
-
Citrix Session Recording Analyticsサービス
-
Citrix Session Recordingストレージマネージャー
-
-
構成が正常に完了したら、Citrix Analytics for Securityに移動して、接続されているSession Recordingサーバーを表示します。[Turn On Data Processing] クリックして、Citrix Analytics for Securityがデータを処理できるようにします。
注:
Session Recordingサーバーバージョン2103または2104を使用している場合は、最初にVirtual Apps and Desktopsセッションを起動して、Citrix Analytics for Securityで接続されているSession Recordingサーバーを表示する必要があります。こうしないと、接続されているSession Recordingサーバーが表示されません。この要件は、Session Recordingサーバーバージョン2106以降には適用されません。
接続された展開を表示する
サーバーの展開は、構成が成功した場合にのみSession Recordingサイトカードに表示されます。サイトカードには、Citrix Analytics for Securityとの接続を確立した構成済みサーバーの数が表示されます。
構成が成功した後もSession Recordingサーバーが表示されない場合は、「構成済みSession Recordingサーバーが接続に失敗する」のトラブルシューティングのセクションを参照してください。
サイトカードで展開の数をクリックして、Citrix Analytics for Securityで接続されているサーバーグループを表示します。たとえば、1 Session Recording Deploymentをクリックして、接続されている1つまたは複数のサーバーグループを表示します。各Session Recordingサーバーは、ベースURLとServerGroupIDで表示されます。
受信したイベントを表示する
サイトカードには、接続されたSession Recording展開と、これらの展開から過去1時間に受信したイベントが表示されます。これは、デフォルトの時間の選択肢です。1週間(1 W)を選択して、データを表示することもできます。受信したイベントの数をクリックして、セルフサービス検索ページにイベントを表示します。
データ処理を有効にすると、サイトカードに No data receivedステータスが表示される場合があります。このステータスは、次の2つの理由で表示されます:
-
初めてデータ処理をオンにした場合、イベントがCitrix Analyticsのイベントハブに到達するまでに時間がかかります。Citrix Analyticsがイベントを受信すると、ステータスがData processing onに変わります。しばらく経ってもステータスが変わらない場合は、[Data Sources]ページを更新してください。
-
Citrix Analyticsは、過去1時間にデータソースからイベントを受信していません。
Session Recordingサーバーを追加する
Session Recordingサーバーを追加するには、次のいずれかを実行します:
-
[Connected Session Recording Deployments] ページで、[Session Recording Serverへの接続] をクリックします。
-
[Virtual Apps and Desktops- Session Recording] サイトカードで、縦の省略記号(⋮)をクリックして [Session Recording Serverへの接続] を選択します。
手順に従って構成ファイルをダウンロードし、Session Recordingサーバーを構成します。
Session Recordingサーバーを削除する
Session Recordingサーバーを削除するには:
-
Citrix Analytics for Securityで、[Connected Session Recording Deployments] ページに移動し、削除するサーバー展開を選択します。
-
縦の省略記号(⋮)をクリックし、[Remove Session Recording server from Analytics] を選択します。
-
Citrix Analyticsから削除したSession Recordingサーバーで、次のコマンドを実行します:
<Session Recording server installation path>\bin\SsRecUtils.exe -Remove_SRCasConfigurations <!--NeedCopy-->
例:
C:\Program Files\Citrix\SessionRecording\Server\bin\ SsRecUtils.exe -Remove_SRCasConfigurations <!--NeedCopy-->
データソースのデータ処理をオンまたはオフにする
特定のデータソース(DirectorおよびWorkspaceアプリ)のデータ処理をいつでも停止できます。データソースのサイトカードで縦の省略記号(⋮)をクリックし、[Turn off data processing] を選択します。Citrix Analyticsは、そのデータソースのデータの処理を停止します。Virtual Apps and Desktopsサイトカードからデータ処理を停止することもできます。このオプションは、DirectorとWorkspaceアプリの両方のデータソースで使用できます。 データ処理を再度有効にするには、[Turn On Data Processing] をクリックします。
構成されたSession Recordingサーバーが接続に失敗する
構成後、Session RecordingサーバーがCitrix Analyticsに接続できません。したがって、Session Recordingサイトカードに構成済みのサーバーが表示されません。
この問題のトラブルシューティングを行うには、次の手順を実行します:
-
構成済みのSession Recordingサーバーで、次のPowerShellコマンドを実行してクライアントマシンのID(CMID)を確認します:
```` Get-WmiObject -class SoftwareLicensingService | select Clientmachineid ```
-
CMIDが空の場合は、指定したパスに次のレジストリファイルを追加します:
レジストリ名 レジストリのパス キー型 値 AuditorUniqueID
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server\
文字列 UUIDを入力します。 EnableCASUseAuditorUniqueID
Computer/HKEY_LOCAL_MACHINE/SOFTWARE/Citrix/SmartAuditor/Server/
REG_DWORD 1 -
次のサービスを再起動します:
-
Citrix Session Recording Analyticsサービス
-
Citrix Session Recordingストレージマネージャー
-
この記事の概要
- インストールチェックリスト
- Citrixスクリプトを使用したWindowsの役割と機能の前提条件のインストール
- Session Recording Administrationコンポーネントのインストール
- Session Recording Agentのインストール
- Session Recording PlayerとWeb Playerのインストール
- インストールの自動化
- Session Recordingのアップグレード
- クラウドSQLデータベースサービスでのSession Recordingデータベースの展開
- Session Recordingのアンインストール
- Citrix Analytics for Securityとの統合