レコーディングの管理

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

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

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

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

• /FILEID:<id> - ターゲットのセッション録画ファイルを指定できます。セッション録画ファイルのIDは、Session Recording player (Windows) で確認できます。録画ファイル名をファイル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. 現在の作業ディレクトリから、セッションレコーディングサーバーのインストールパス（<Session Recording server installation path>\Bin）にあるBinディレクトリに移動します。

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

セッションレコーディングファイルを復元する

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

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

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

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

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

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

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のプロパティを選択します。

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

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サーバーによって認識可能である必要があります。「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プレーヤー（Windows）でセッションレコーディングファイルのIDを確認できます。レコーディングファイル名をファイルIDとして使用することもできます。