インストール、アップグレード、アンインストール
この記事には、次のセクションが含まれています。
インストールチェックリスト
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 Supportから入手できます。 | |
| Directorを構成して、Session Recordingポリシーを作成およびアクティブ化します。詳しくは、Directorを構成してSession Recording Serverを使用するを参照してください。 |
注：
- 公開アプリケーションは、記録ポリシーに基づいて個別のデリバリーグループに分割することをお勧めします。アプリケーションが同じデリバリーグループにある場合、公開アプリケーションのセッション共有はアクティブなポリシーと競合する可能性があります。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フォルダーへの書き込み権限を持っていることを確認してください。
Windowsの役割と機能の前提条件をインストールするためにCitrixスクリプトを使用する
Session Recordingが適切に機能するためには、必要なWindowsの役割と機能の前提条件をインストールするために、以下のCitrixスクリプトを Session Recordingをインストールする前に使用してください:
-
InstallPrereqsforSessionRecordingAdministration.ps1<# .Synopsis Installs Prereqs for Session Recording Administration .Description Supports Windows Server 2012 R2, Windows Server 2016, Windows Server 2019. 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 2012 R2*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows Server 2019*'))) { 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 2012 R2, Windows Server 2016, Windows Server 2019, Windows 7, Windows 8, Windows 8.1 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 2012 R2*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows Server 2019*')-or ($system -Like '*Microsoft Windows 7*')-or ($system -Like '*Microsoft Windows 8*')-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 { if($system -Like '*Microsoft Windows 7*') { dism /online /enable-feature /featurename:IIS-WebServerRole /featurename:IIS-WebServer /featurename:IIS-IIS6ManagementCompatibility /featurename:IIS-Metabase /featurename:IIS-ManagementConsole /featurename:IIS-ApplicationDevelopment /featurename:IIS-NetFxExtensibility /featurename:IIS-ISAPIExtensions /featurename:IIS-CommonHttpFeatures /featurename:IIS-DefaultDocument /featurename:IIS-DirectoryBrowsing /featurename:IIS-HttpErrors /featurename:IIS-HttpRedirect /featurename:IIS-StaticContent /featurename:IIS-HealthAndDiagnostics /featurename:IIS-RequestMonitor /featurename:IIS-Performance /featurename:IIS-HttpCompressionStatic /featurename:IIS-Security /featurename:IIS-RequestFiltering /featurename:IIS-LoggingLibraries /featurename:IIS-HttpTracing dism /online /enable-feature /featurename:MSMQ-Container dism /online /enable-feature /featurename:MSMQ-Server dism /online /enable-feature /featurename:MSMQ-HTTP } else { 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コマンドを実行します。スクリプトは、正常に追加された機能を表示し、その後停止します。
-
スクリプトの実行後、会社のポリシーに基づいて実行ポリシーが適切な値に設定されていることを確認します。
-
セッション録画管理コンポーネントをインストールする
セッション録画管理、セッション録画エージェント、およびセッション録画プレーヤーの各コンポーネントは、別々のサーバーにインストールすることをお勧めします。
セッション録画管理コンポーネントには、セッション録画データベース、セッション録画サーバー、およびセッション録画ポリシーコンソールが含まれます。サーバーにインストールするコンポーネントを選択できます。
-
Install 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で、次へをクリックし、使用許諾契約に同意します。
-
Session Recording Administration Setup画面で、インストールするセッション録画管理コンポーネントを選択します。
注:
すべてのセッションレコーディング管理コンポーネントを単一のサーバーにインストールすることは、概念実証としては問題ありません。ただし、大規模な本番環境では、セッションレコーディングポリシーコンソールを別のサーバーに、セッションレコーディングサーバー、セッションレコーディング管理者ログ、およびセッションレコーディングデータベースをさらに別のサーバーにインストールすることをお勧めします。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
Session Recordingデータベースをインストールする
注：
Session Recordingデータベースは実際のデータベースではありません。これは、インストール中に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へのセッションレコーディングデータベースの展開およびAzure VM上のSQL Serverへのセッションレコーディングデータベースの展開を参照してください。
Session RecordingデータベースとMicrosoft SQL Serverには、通常、次の3種類の展開方法があります。
- 展開1: セッションレコーディングサーバーとセッションレコーディングデータベースを同じマシンにインストールし、Microsoft SQL Server はリモートマシンにインストールします。（推奨）
- 展開2：セッションレコーディングサーバー、セッションレコーディングデータベース、およびMicrosoft SQL Serverを同じマシンにインストールします。
- 展開3：セッションレコーディングサーバーを1台のマシンにインストールし、セッションレコーディングデータベースとMicrosoft SQL Serverの両方を別のマシンにインストールします。（非推奨）
-
データベースとサーバーの構成ページで、Session Recordingデータベースのインスタンス名とデータベース名、および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 をクリックしてインストールを続行します。
インストールにより、セッションレコーディングデータベースが作成され、セッションレコーディングサーバーのコンピューターアカウントが db_owner として追加されます。
- データベースのsecurityadminおよびdbcreatorサーバーロール権限が必要です。これらの権限がない場合は、次のことができます。
-
セッションレコーディングサーバーコンピューターアカウント:
-
展開1および2: Session Recording Serverコンピューターアカウント テキストボックスに localhost と入力します。
-
展開3: セッションレコーディングサーバーをホストするマシンの名前を domain\computer-name の形式で入力します。セッションレコーディングサーバーコンピューターアカウントは、セッションレコーディングデータベースにアクセスするためのユーザーアカウントです。
注:
Session Recording Serverコンピューターアカウント テキストボックスにドメイン名が設定されている場合、Session Recording Administrationコンポーネントのインストールがエラーコード1603で失敗することがあります。回避策として、Session Recording Serverコンピューターアカウント テキストボックスに localhost またはNetBIOSドメイン名\マシン名を入力します。NetBIOSドメイン名を取得するには、Session Recording Serverがインストールされているマシンで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をインストールします。
- 「セッションレコーディングエージェント構成」ページで：セッションレコーディングサーバーを事前にインストールしている場合は、セッションレコーディングサーバーをインストールしたマシンのコンピューター名と、セッションレコーディングサーバーへの接続プロトコルおよびポート情報を入力します。セッションレコーディングをまだインストールしていない場合は、後でセッションレコーディングエージェントプロパティでこの情報を変更できます。
- 指示に従ってインストールを完了します。
注記：
Machine Creation Services (MCS)またはProvisioning Services (PVS)が、構成済みのマスターイメージとMicrosoft Message Queuing (MSMQ)がインストールされた複数のVDAを作成する場合、特定の条件下で、それらのVDAが同じQMIdを持つことがあります。この場合、次のようなさまざまな問題が発生する可能性があります。
- 記録契約が承認されていても、セッションが記録されない場合があります。
- セッションレコーディングサーバーはセッションログオフ信号を受信できない場合があり、そのため、セッションは常にライブ状態になる可能性があります。
回避策として、各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をレジストリから削除します。
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-->
セッションレコーディングプレイヤーとウェブプレイヤーをインストールする
セッションレコーディングプレイヤーは、セッションレコーディングサーバーまたはドメイン内のワークステーションにインストールします。ウェブプレイヤーは、セッションレコーディングサーバーにのみインストールします。
SessionRecordingPlayer.msiとSessionRecordingWebPlayer.msiをダブルクリックし、指示に従ってインストールを完了します。
インストールの自動化
Session Recordingは、オプション付きのサイレントインストールをサポートしています。サイレントインストールを使用するスクリプトを作成し、関連するコマンドを実行します。
Session Recording管理コンポーネントのインストールの自動化
単一のコマンドを使用してSession Recording管理コンポーネントの完全なセットをインストールする
たとえば、以下のいずれかのコマンドは、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-->
注：
The
SessionRecordingAdministrationx64.msifile 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 Managed Instance を使用している場合は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サーバーを他の多くのマシンに簡単に展開するためのマスターイメージを作成できます。マスターイメージを使用してターゲットマシンにサーバーを展開した後、各マシンでコマンドを実行して、既存の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管理コンポーネントをインストールします。
Set the IGNOREDBCHECK parameter to True and use random values for DATABASEINSTANCE, DATABASENAME, and LOGGINGDATABASENAME.
-
操作しているマシン上にマスターイメージを作成します。
-
Session Recordingサーバーを展開するために、マスターイメージを他のマシンに展開します。
-
各マシンで、次のようなコマンドを実行します。
.\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME iisreset /noforce <!--NeedCopy-->これらのコマンドは、以前にインストールされたSession Recordingサーバーを既存のSession Recordingデータベースおよび管理ログデータベースに接続します。
The
SsRecUtils.exefile resides in\Citrix\SessionRecording\Server\bin\. Set the DATABASEINSTANCE, DATABASENAME, and LOGGINGDATABASENAME parameters as needed.
Session Recording管理コンポーネントをアンインストールする際にデータベースを保持する
KEEPDBをTrueに設定すると、Session Recording管理コンポーネントをアンインストールする際に、次のコマンドによってSession Recordingデータベースと管理ログデータベースが保持されます。
msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"
<!--NeedCopy-->
セッションレコーディングプレーヤーおよびウェブプレーヤーのインストールを自動化する
たとえば、次のコマンドは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ファイルは、Citrix Virtual Apps and Desktops ISO の\layout\image-full\x86\Session Recordingにあるディレクトリ内に配置されています。」「
SessionRecordingWebPlayer.msiファイルは、Citrix Virtual Apps and Desktops 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-->
注:
The
SessionRecordingAgentx64.msifile is located on the Citrix Virtual Apps and Desktops ISO under\layout\image-full\x64\Session Recording.
32ビットシステムの場合:
msiexec /i SessionRecordingAgent.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->
注:
SessionRecordingAgent.msiファイルは、Citrix Virtual Apps and Desktops ISO の\layout\image-full\x86\Session Recordingにある場所で見つけることができます。
説明:
- yourservername は、Session Recording Server をホストするマシンの 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 のプロパティにある Graphics Adjustment オプションは、Desktop Composition Redirection モードとの互換性を維持するために、新規インストールまたはアップグレード後にデフォルトで有効になります。新規インストールまたはアップグレード後に、このオプションを手動で無効にすることができます。
- The Administrator Logging feature is not installed after you upgrade Session Recording from a previous release where the feature is unavailable. To add the feature, modify the installation after the upgrade.
- アップグレードプロセスが開始されたときにライブ記録セッションがある場合、記録が完了する可能性はほとんどありません。
- 潜在的な停止を計画し、軽減できるように、以下のアップグレードシーケンスを確認してください。
アップグレードシーケンス
- セッションレコーディングデータベースとセッションレコーディングサーバーが異なるサーバーにインストールされている場合、セッションレコーディングサーバーでセッションレコーディングストレージマネージャーサービスを手動で停止します。その後、まずセッションレコーディングデータベースをアップグレードします。
- 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 インスタンスを作成します。
-
(For Azure SQL only) Keep a record of the Server strings that appear in the properties panel. The strings are the instance name of the Session Recording Database. For an example, see the following screen capture.
-
（AWS RDSのみ）EndpointとPortの情報を記録しておきます。これは、データベースのインスタンス名として、<Endpoint, Port>の形式で使用します。
-
SessionRecordingAdministrationx64.msiを実行して、セッション録画データベースをインストールします。
Enable cloud SQLチェックボックスをオンにし、クラウドSQL管理者のユーザー名とパスワードを入力します。その他の必要な構成を行います。
注：クラウドSQL管理者のパスワードを変更した場合は、Session Recording Server Propertiesでパスワードを更新する必要があります。Session Recording Server Propertiesを開くと、エラーメッセージが表示されます。OKをクリックして続行し、Cloud DBタブを選択して、新しいクラウドSQL管理者のパスワードを入力します。Citrix Session Recording Analyticsサービス、Citrix Session Recording Storage Managerサービス、およびIISサービスを再起動します。
クラウドSQL管理者パスワードを更新する(/ja-jp/session-recording/2104/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 -
セッションレコーディングサーバーで、シトリックス セッションレコーディング アナリティクス サービス、シトリックス セッションレコーディング ストレージマネージャー サービス、およびアイアイエス サービスを再起動します。
実稼働データベースを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 -
セッションレコーディングサーバーで、シトリックス セッションレコーディング アナリティクス サービス、シトリックス セッションレコーディング ストレージマネージャー サービス、およびIISサービスを再起動します。
Azure VM上のSQL Serverにセッションレコーディングデータベースを展開する
Azure VM上のSQL Serverでは、セッションレコーディングデータベースを展開できます。
- Azure SQL VM の準備を行います。
- VMを構成し、Session Recordingコンポーネントをインストールするドメインに追加します。
- VMのFQDNを、Session Recording Databaseのインストール時のインスタンス名として使用します。 注: SessionRecordingAdministrationx64.msiを使用してインストールする場合、Enable cloud SQLチェックボックスをオフにしてください。
- インストールを完了するには、指示に従ってください。
セッションレコーディングのアンインストール
サーバーまたはワークステーションからSession Recordingコンポーネントを削除するには、Windowsのコントロールパネルにあるプログラムのアンインストールまたは変更オプションを使用します。 Session Recording Databaseを削除するには、インストール時と同じsecurityadminおよびdbcreatorのSQL Serverロール権限が必要です。
セキュリティ上の理由から、コンポーネントのアンインストール後も管理者ログデータベースは削除されません。