録画を管理する

ICAログデータベース (ICLDB) は、セッション録画データベースレコードを操作するために使用されるデータベースコマンドラインユーティリティです。このユーティリティは、セッション録画のインストール中に、セッション録画サーバーをホストするサーバー上の <Session Recording Server installation path>\Bin フォルダーにインストールされます。

注:

Azureファイル共有に保存されているセッション録画ファイルを管理するためにICLDBを使用する場合は、SsRecUtils.exe -MountAzureFiles コマンドを実行します。SsRecUtils.exeとICLDBは同じフォルダーにあります。

クイックリファレンスチャート

次の表に、ICLDBユーティリティで利用可能なコマンドとオプションを示します。次の形式を使用してコマンドを入力します。

ICLDB [VERSION | LOCATE | DORMANT | IMPORT | ARCHIVE | REMOVE | REMOVEALL | REPAIR] command-options [/L] [/F] [/S] [/?]

注:

ユーティリティに関連付けられているヘルプには、より詳細な手順が記載されています。ヘルプにアクセスするには、コマンドプロンプトから \Program Files\Citrix\SessionRecording\Server\Bin フォルダーに移動し、 icldb /? と入力します。特定のコマンドのヘルプにアクセスするには、 icldb <specific command> /? と入力します。

ICLDB ARCHIVE および ICLDB REMOVE の各コマンドで利用される RULES パラメーターについて

RULES パラメーターは、複数のフィルターを /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"]; 形式に厳密に従って組み合わせることにより、高度なフィルターを設定します。ここで、

• 「FIELD」は、フィールドでフィルターを設定します。フィールドには、「path」、「user」、「group」、「deliverygroup」、「application」、「server」、「client」、または dbo.ICLFile というデータベーステーブル内のその他の列を指定できます。

• 「In」は、括弧内のフィルター条件の少なくとも1つが満たされた場合に、記録ファイルが操作オブジェクトになることを意味します。

• 「NotIn」は、括弧内のフィルター条件のいずれかを満たす記録ファイルが操作から除外されることを意味します。

• 「CONDITION」は、dbo.ICLFile というデータベーステーブル内のレコード（または行）でフィルター条件を設定します。

• ユーザーおよびグループのレコードは、<domain>.<name> の形式で入力する必要があります。

• パスレコードは、Windows ワイルドカードを使用してフィルターできます。

• 各「CONDITION」項目は二重引用符 ("") で囲み、2つの「CONDITION」項目はコンマ (,) で区切る必要があります。

• 「CONDITION」項目自体にスペースが含まれていない限り、「CONDITION」項目を入力する際にスペースを追加しないでください。

• 「CONDITION」項目に1つ以上のコンマが含まれている場合は、「CONDITION」項目を二重引用符で囲み、その後にエスケープされた二重引用符を続けます""" """。

• 複数のフィルターをさまざまな組み合わせで使用できます。各フィルターはセミコロンで終わります(;)。

• 複数のフィルターを計算するには、「AND」論理演算子が使用されます。フィルターの数に制限はありませんが、RULESの合計長は2,048バイトを超えてはなりません。

使用例:

• /RULES:group-In-["BUILTIN.Guests"];
• /RULES:path-In-["S:\SessionRecordings\2023*"];group-NotIn-["Mydomain.Suspicious","Mydomain.Persistence"];
• /RULES:deliverygroup-In-["RdsDesktopAndAppGroup"];user-In-["Mydomain.AdminA","""Mydomain.Admin,,,B"""];
• /RULES:EndReasonID-In-["1","2"];

セッション録画ファイルをアーカイブする

録画保存場所で十分な空きディスク容量を維持するため、セッション録画ファイルを定期的にアーカイブしてください。利用可能なディスク容量と録画ファイルの一般的なサイズによって、アーカイブ間隔は異なります。セッション録画ファイルは、アーカイブされる前に開始日から2日以上経過している必要があります。この規則は、ライブ録画が完了する前にアーカイブされるのを防ぐためのものです。

セッション録画をアーカイブする際には、2つの方法があります。録画ファイルのデータベースレコードをアーカイブ済みステータスに更新し、ファイルは録画保存場所に残すことができます。この方法は、プレーヤーでの検索結果を減らすために使用できます。もう1つの方法は、録画ファイルのデータベースレコードをアーカイブ済みステータスに更新し、ファイルを録画保存場所から別の場所に移動して、代替メディアにバックアップすることです。セッション録画ファイルを移動する場合、ICLDBユーティリティは、元のファイルフォルダー構造であるyear/month/dayが存在しない指定されたディレクトリにファイルを移動します。

Session Recordingデータベースのセッション録画レコードには、アーカイブに関連する2つのフィールド（アーカイブ時刻とアーカイブメモ）が含まれています。アーカイブ時刻は、録画がアーカイブされた現在の日付と時刻を表します。アーカイブメモは、アーカイブ中に追加できるオプションのテキストメモです。これら2つのフィールドは、録画がアーカイブされたこととアーカイブ時刻を示します。

Session Recordingプレーヤーでは、アーカイブされたセッション録画は「Archived」ステータスとアーカイブの日時を表示します。アーカイブされたセッション録画は、ファイルが移動されていない場合は再生できることがあります。セッション録画ファイルがアーカイブ中に移動された場合、「ファイルが見つかりません」エラーが表示されます。セッションを再生するには、セッション録画ファイルを復元する必要があります。セッション録画ファイルを復元するには、録画ファイルのFile IDとArchive Timeを指定します。アーカイブされたファイルの復元については、以下のセッション録画ファイルを復元するセクションで詳しく説明します。

ICLDBユーティリティのARCHIVEコマンドには、以下のいくつかのパラメーターがあります。

• /FILEID:<id> - ターゲットのセッション録画ファイルを指定できます。Session Recordingプレーヤー（Windows）でセッション録画ファイルのIDを確認できます。録画ファイル名をファイルIDとして使用することもできます。

• /RETENTION:<days> - セッションレコーディングの保持期間（日数）。指定された日数よりも古いレコーディングは、セッションレコーディングデータベースでアーカイブ済みとしてマークされます。保持期間は、2日以上の整数である必要があります。

• /FILTER:<filter>: *および?ワイルドカードを使用してファイルパスをフィルタリングできます。FILTERパラメーターはオプションです。FILTERパラメーターを追加した場合、RETENTIONとFILTERの両方を満たすセッションレコーディングファイルのみがアーカイブされます。

• /RULES:<advanced filters>: 複数のフィルターを/RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];形式に厳密に従って組み合わせることにより、高度なフィルターを設定します。RULESパラメーターとFILTERパラメーターは同時に使用できません。詳しくは、この記事の前の「ICLDB ARCHIVEおよびICLDB REMOVEコマンドのRULESパラメーター」セクションを参照してください。

• /LISTFILES – アーカイブされているセッションレコーディングファイルの完全なパスとファイル名を一覧表示します。このパラメーターはオプションです。

• /MOVETO:<directory> - アーカイブされたセッションレコーディングファイルを物理的に移動するディレクトリ。指定されたディレクトリは存在している必要があります。このパラメーターはオプションです。ディレクトリが指定されていない場合、ファイルは元の保存場所に残ります。

• /NOTE:<note> - アーカイブされた各セッションレコーディングのデータベースレコードに追加されるテキストメモ。メモは二重引用符で囲んでください。このパラメーターはオプションです。

• /L – アーカイブされたセッションレコーディングファイルの数の結果とエラーをWindowsイベントログに記録します。このパラメーターはオプションです。

• /F – プロンプトなしでアーカイブコマンドを強制的に実行します。このパラメーターはオプションです。

セッションレコーディングデータベースでセッションレコーディングをアーカイブし、セッションレコーディングファイルを物理的に移動するには

1. Session Recordingサーバーがインストールされているサーバーにローカル管理者としてログオンします。

2. コマンドプロンプトを起動します。

3. 現在の作業ディレクトリから、Session RecordingサーバーのインストールパスのBinディレクトリ（<Session Recording server Installation Path>\Bin）に変更します。

4. ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/MOVETO:<dir>] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?]コマンドを実行します。角かっこ内のパラメーターはオプションです。コマンドを実行するときは角かっこを削除してください。RULESパラメーターとFILTERパラメーターは同時に使用できません。daysはセッションレコーディングファイルの保持期間、directoryはアーカイブされたセッションレコーディングファイルの移動先ディレクトリ、noteはアーカイブされる各セッションレコーディングファイルのデータベースレコードに追加されるテキストメモです。アーカイブを確定するにはYを入力します。

Session Recordingデータベースでセッションレコーディングのみをアーカイブするには

1. Session Recordingサーバーがインストールされているサーバーにローカル管理者としてログオンします。

2. コマンドプロンプトを起動します。

3. 現在の作業ディレクトリから、Session Recording サーバーのインストールパスにあるバイナリディレクトリ (<Session Recording server installation path>\Bin) に移動します。

4. ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?] コマンドを実行します。角かっこ内のパラメーターはオプションです。コマンドを実行するときは、角かっこを削除してください。RULESパラメーターとFILTERパラメーターは同時に使用できません。days はセッション録画の保持期間であり、note はアーカイブされる各セッション録画のデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。

セッション録画ファイルを復元する

Session Recordingデータベースにアーカイブされ、録画保存場所から移動された録画ファイルを表示するには、そのファイルを復元します。アーカイブ中に録画保存場所から移動されなかったアーカイブ済みセッション録画は、引き続きプレーヤーでアクセスできます。

移動されたセッション録画ファイルを復元するには、2つの方法があります。必要なセッション録画ファイルをアーカイブ済みファイルの復元ディレクトリにコピーします。または、ICLDBユーティリティを使用して、必要なセッション録画ファイルをSession Recordingデータベースにインポートし直します。アーカイブ済みセッション録画ファイルを復元するには、最初の方法をお勧めします。アーカイブ済みファイルの復元ディレクトリにコピーされたアーカイブ済みファイルは、不要になったら削除してください。

Session Recording Brokerは、セッション録画ファイルが元の保存場所に見つからない場合に、アーカイブ済みファイルの復元ディレクトリを使用します。これは、プレーヤーが再生のためにセッション録画ファイルを要求したときに発生します。Session Recording Brokerはまず、元の保存場所でセッション録画ファイルを見つけようとします。元の保存場所でファイルが見つからない場合、Session Recording Brokerはアーカイブ済みファイルの復元ディレクトリを確認します。ファイルが復元ディレクトリに存在する場合、Session Recording Brokerはそのファイルをプレーヤーに送信して再生します。ファイルが見つからない場合、Session Recording Brokerはファイルが見つからないエラーをプレーヤーに送信します。

アーカイブ済み録画ファイルをインポートすると、新しい保存パスを含むセッション録画ファイルからの情報でSession Recordingデータベースが更新されます。アーカイブ済みセッション録画ファイルをインポートしても、セッションが録画されたときの元の保存場所にはファイルは戻されません。

注: インポートされたセッション録画ファイルは、Session Recordingデータベースでアーカイブ時刻とアーカイブメモがクリアされます。次にICLDB ARCHIVEコマンドが実行されると、インポートされたセッション録画ファイルが再度アーカイブされる可能性があります。

ICLDB IMPORTコマンドは、多数のアーカイブ済み録画ファイルをインポートするのに役立ちます。Session Recordingデータベース内の誤ったセッション録画データや欠落しているセッション録画データを修復または更新できます。また、Session Recordingサーバー上でセッション録画ファイルをある保存場所から別の保存場所に移動するのにも役立ちます。ICLDB REMOVEALLコマンドを実行した後、ICLDB IMPORTコマンドを使用してSession Recordingデータベースにセッション録画を再投入できます。

ICLDBユーティリティのIMPORTコマンドには、アーカイブ済み録画ファイルを復元するために使用できるいくつかのパラメーターがあります。

• /LISTFILES – インポート中にセッション録画ファイルの完全なパスとファイル名を一覧表示します。このパラメーターはオプションです。

• /RECURSIVE – すべてのサブディレクトリでセッション録画ファイルを検索します。このパラメーターはオプションです。

• /RELOCATE – RELOCATEパラメーターがない場合、IMPORTコマンドはセッション録画ファイルを完全に解析するため、時間がかかります。RELOCATEパラメーターを使用すると、IMPORTコマンドはセッション録画ファイルのデータベースレコードを単に特定し、そのファイルパスを直接更新します。

• /L – 結果とエラー、およびインポートされたセッション録画ファイルの数をWindowsイベントログに記録します。このパラメーターはオプションです。

• /F – プロンプトなしでIMPORTコマンドの実行を強制します。このパラメーターはオプションです。

注:

ICLDBユーティリティのIMPORTコマンドには、記録ファイルを再配置するために使用できるオプションのパラメーターRELOCATEも用意されています。詳細については、この記事の「セッション記録ファイルの再配置」セクションを参照してください。

アーカイブ済みファイルの復元ディレクトリを使用してセッション記録ファイルを復元する

1. Session Recordingサーバーがインストールされているサーバーにローカル管理者としてログオンします。

2. セッション記録プレイヤーのプロパティで、アーカイブされたセッション記録ファイルのファイルIDとアーカイブ時刻を特定します。

3. Session Recording Player Propertiesで指定されたFile IDを使用して、バックアップ内のセッション記録ファイルを見つけます。各セッション記録のファイル名はi_<FileID>.iclで、FileIDはセッション記録ファイルのIDです。

4. バックアップからアーカイブ済みファイルの復元ディレクトリにセッション記録ファイルをコピーします。アーカイブ済みファイルの復元ディレクトリを特定するには：

   1. スタートメニューから、スタート > すべてのプログラム > Citrix® > Session Recording Server Propertiesの順に選択します。

   2. Session Recording Server Propertiesで、ストレージタブを選択します。現在の復元ディレクトリは、アーカイブされたファイルの復元ディレクトリフィールドに表示されます。

ICLDB IMPORTコマンドを使用してセッション記録ファイルを復元する

1. Session Recordingサーバーがインストールされているサーバーにローカル管理者としてログオンします。

2. コマンドプロンプトを起動します。

3. 現在の作業ディレクトリから、Session RecordingサーバーのインストールパスのBinディレクトリ（<Session Recording server installation path>\Bin）に変更します。

4. 次のいずれかを実行します。

   • セッション記録ファイルを含む1つ以上のディレクトリの名前（スペースで区切る）がdirectoryであるICLDB IMPORT /LISTFILES /RECURSIVE /L <directory>コマンドを実行します。インポートを確定するには「Y」と入力します。

   • セッション記録ファイルの名前（スペースで区切る）が1つ以上あるfileであるICLDB IMPORT /LISTFILES /L <file>コマンドを実行します。ワイルドカードを使用してセッション記録ファイルを指定できます。インポートを確定するには「Y」と入力します。

セッション記録ファイルの再配置

負荷分散やその他の目的のために、セッション記録ファイルを別のストレージパスに移動できます。ファイルが引き続き再生できるようにするには、新しいパスをSession Recordingデータベースに更新する必要があります。これを行うには、ICLDB IMPORTコマンドを使用します。インポートプロセスを高速化するには、ICLDB IMPORTコマンドにRELOCATEパラメーターを追加します。

注：

RELOCATEパラメーターはオプションです。RELOCATEパラメーターがない場合、ICLDB IMPORTコマンドはセッション記録ファイルを完全に解析するため、時間がかかります。RELOCATEパラメーターを使用すると、ICLDB IMPORTコマンドはセッション記録ファイルのデータベースレコードを単に検索し、ファイルパスを直接更新します。

次の手順は、RELOCATEパラメーターを使用して新しいファイルパスをSession Recordingデータベースに更新する方法を示しています。

1. 必要に応じて、セッション記録ファイルを別のストレージパスに移動します。

2. Session Recordingサーバーがインストールされているサーバーにローカル管理者としてログオンします。

3. コマンドプロンプトを起動します。

4. 現在の作業ディレクトリから、Session RecordingサーバーのインストールパスのBinディレクトリ（<Session Recording server installation path>\Bin）に変更します。

5. 次のいずれかを実行します。

   • セッション記録ファイルを含む1つ以上のディレクトリの名前（スペースで区切る）がdirectoryであるICLDB IMPORT /LISTFILES /RECURSIVE /RELOCATE /L <directory>コマンドを実行します。インポートを確定するには「Y」と入力します。

   • セッション記録ファイルの名前（スペースで区切る）が1つ以上あるfileであるICLDB IMPORT /LISTFILES /RELOCATE /L <file>コマンドを実行します。ワイルドカードを使用してセッション記録ファイルを指定できます。インポートを確定するには「Y」と入力します。

注：

• RELOCATE パラメーターは、セッション録画ファイルのレコードがすでにセッション録画データベースに存在することを前提としています。
• セッション録画ファイルは、移動する前に再生可能である必要があります。そうでない場合、RELOCATE パラメーターは役に立ちません。
• セッション録画ファイルの新しいストレージパスは、Session Recordingサーバーによって認識可能である必要があります。これらは、Session Recording Server Properties の Storage タブで試すことができます。

応答しない、または休止状態のライブ録画を閉じる

デフォルトでは、24時間録画ファイルに新しいデータが書き込まれなかった場合、ライブ録画は応答しない、または休止状態であると見なされます。このしきい値を超えたときに、応答しない、または休止状態のライブ録画を自動的に閉じるように、Session Recording Server Properties の Storage タブでこの時間しきい値を構成できます。設定できる最小値は12（時間）です。

録画ファイルの休止時間の設定(/ja-jp/session-recording/2511/media/setting-recording-file-dormant-time.png)

たとえば、ICLDB DORMANT コマンドを使用して、応答しない、または休止状態のライブ録画を手動で閉じることもできます。

ICLDB DORMANT [/DAYS:<days> | /HOURS:<hours> | /MINUTES:<minutes> | /FILEID:<id>] [/LISTFILES] [/CLOSEFILES] [/L] [/F] [/S] [/?]
<!--NeedCopy-->

FILEID パラメーターを使用すると、ターゲットのセッション録画ファイルを指定でき、CLOSEFILES パラメーターを使用すると、指定した応答しない、または休止状態のライブ録画を手動で閉じることができます。

ヒント:

Session Recordingプレーヤー（Windows）でセッション録画ファイルのIDを確認できます。録画ファイル名はファイルIDとしても使用できます。