レコーディングの管理

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: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ユーティリティは、元のファイルフォルダー構造である年/月/日が存在しない指定されたディレクトリにそれらを移動します。

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

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

ICLDBユーティリティのARCHIVEコマンドには、次のような複数のパラメーターがあります。

• /FILEID:<id> - ターゲットのセッション録画ファイルを指定できます。セッション録画プレーヤー (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. セッション録画サーバーがインストールされているサーバーに、ローカル管理者としてログオンします。

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

3. 現在の作業ディレクトリから、セッション録画サーバーのインストールパスの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」と入力します。

セッション録画データベースでセッション録画のみをアーカイブするには

1. セッション録画サーバーがインストールされているサーバーに、ローカル管理者としてログオンします。

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

3. 現在の作業ディレクトリから、セッションレコーディング サーバーのインストールパスにある Bin ディレクトリ (<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. Session Recording Playerのプロパティで、アーカイブされたセッション記録ファイルのファイルIDとアーカイブ時刻を特定します。

3. Session Recording Playerのプロパティで指定されたファイル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. 次のいずれかを実行します。

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

   • ICLDB IMPORT /LISTFILES /L <file> コマンドを実行します。ここで、file は、スペースで区切られた1つ以上のセッション記録ファイルの名前です。セッション記録ファイルを指定するためにワイルドカードを使用できます。インポートを確定するには 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. 次のいずれかを実行します。

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

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

注：

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

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

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

録画ファイルの休止時間の設定(/ja-jp/session-recording/current-release/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 Player（Windows）でセッション録画ファイルのIDを確認できます。録画ファイル名をファイルIDとして使用することもできます。