録画を管理する
ICAログデータベース (ICLDB) は、セッション録画データベースレコードを操作するために使用されるデータベースのコマンドラインユーティリティです。このユーティリティは、セッション録画のインストール中に、セッション録画サーバーをホストするサーバー上の \Program Files\Citrix\SessionRecording\Server\Bin フォルダーにインストールされます。
クイックリファレンスチャート
以下の表は、ICLDBユーティリティで利用可能なコマンドとオプションを一覧表示しています。次の形式を使用してコマンドを入力してください。
ICLDB [VERSION | LOCATE | DORMANT | IMPORT | ARCHIVE | REMOVE | REMOVEALL] command-options [/L] [/F] [/S] [/?]
注:
ユーティリティに関連付けられているヘルプには、より詳細な手順が記載されています。ヘルプにアクセスするには、コマンドプロンプトから
\Program Files\Citrix\SessionRecording\Server\Binフォルダーに移動し、次のように入力します。icldb /?。特定のコマンドのヘルプにアクセスするには、次のように入力します。icldb *command* /?。
| コマンド | 項目説明 |
|---|---|
ARCHIVE |
RETENTIONおよびFILTERパラメーターを使用して指定したセッション録画ファイルをアーカイブします。RETENTIONパラメーターは必須です。これにより、指定された保持期間よりも古いセッション録画ファイルを操作できます。FILTERパラメーターはオプションです。これにより、* および ? のワイルドカードを使用してファイルパスをフィルターできます。FILTERパラメーターを追加すると、RETENTIONとFILTERの両方を満たすセッション録画ファイルのみが操作されます。録画と録画内のイベントの両方をアーカイブできます。イベントは ArchivedEvent データベーステーブルにアーカイブされます。 |
DORMANT |
休止状態と見なされるセッション録画ファイルを表示またはカウントします。休止状態のファイルとは、データ損失により完了しなかったセッション録画です。データが失われている疑いがある場合に、このコマンドを使用して確認します。データベース全体のセッション録画ファイルが休止状態になっているか、または指定された日数、時間、または分数内に作成された録画のみが休止状態になっているかを確認できます。 |
IMPORT |
セッション録画ファイルをセッション録画データベースにインポートします。データベースレコードを失った場合に、このコマンドを使用してデータベースを再構築します。また、このコマンドを使用してデータベースをマージすることもできます (2つのデータベースがある場合、一方のデータベースからファイルをインポートできます)。2303リリースでは、IMPORTコマンドにRELOCATEパラメーターが導入されました。RELOCATEパラメーターがない場合、IMPORTコマンドはセッション録画ファイルを完全に解析するため、時間がかかります。RELOCATEパラメーターを使用すると、IMPORTコマンドはセッション録画ファイルのデータベースレコードを単に特定し、そのファイルパスを直接更新します。 |
LOCATE |
ファイルIDを基準として使用し、セッション記録ファイルの完全なパスを特定して表示します。セッション記録ファイルの保存場所を探しているときに、このコマンドを使用します。また、データベースが特定のファイルで最新の状態であるかを確認する1つの方法でもあります。 |
REMOVE |
データベースからセッション記録ファイルへの参照を削除します。データベースをクリーンアップするには、このコマンドを（注意して）使用してください。関連する物理ファイルを削除することもできます。REMOVEコマンドを使用する場合、RETENTIONおよびFILTERパラメーターを使用して、ターゲットのセッション記録ファイルを指定します。RETENTIONパラメーターは必須です。指定された保持期間よりも古いセッション記録ファイルを操作できます。FILTERパラメーターはオプションです。*および?ワイルドカードを使用してファイルパスをフィルタリングできます。FILTERパラメーターを追加すると、RETENTIONとFILTERの両方を満たすセッション記録ファイルのみが操作されます。 |
REMOVEALL |
セッション記録データベースからセッション記録ファイルへのすべての参照を削除し、データベースを元の状態に戻します。実際の物理ファイルは削除されませんが、セッション記録プレーヤーでこれらのファイルを検索することはできません。データベースをクリーンアップするには、このコマンドを（注意して）使用してください。削除された参照は、バックアップから復元することによってのみ元に戻すことができます。 |
VERSION |
セッション記録データベースのスキーマバージョンを表示します。 |
/L |
結果とエラーをWindowsイベントログに記録します。 |
/F |
プロンプトなしでコマンドを実行するように強制します。 |
/S |
著作権メッセージを非表示にします。 |
/? |
コマンドのヘルプを表示します。 |
セッション録画ファイルをアーカイブする
録画ストレージの場所に十分な空きディスク容量を維持するため、セッション録画ファイルを定期的にアーカイブしてください。利用可能なディスク容量と録画ファイルの一般的なサイズによって、アーカイブ間隔は異なります。セッション録画ファイルは、アーカイブされる前に、開始日から2日以上経過している必要があります。この規則は、ライブ録画が完了する前にアーカイブされるのを防ぐためのものです。
セッション録画をアーカイブする際には、2つの方法があります。1つは、録画ファイルが録画ストレージの場所に残っている間に、そのデータベースレコードをアーカイブ済みステータスに更新する方法です。この方法を使用すると、プレーヤーでの検索結果を減らすことができます。もう1つの方法は、録画ファイルのデータベースレコードをアーカイブ済みステータスに更新し、ファイルを録画ストレージの場所から別の場所に移動して、代替メディアにバックアップする方法です。ICLDBユーティリティがセッション録画ファイルを移動する場合、ファイルは指定されたディレクトリに移動され、そこでは元の年/月/日のファイルフォルダ構造は存在しません。
セッション録画データベース内のセッション録画レコードには、アーカイブに関連する2つのフィールド（アーカイブ時刻とアーカイブメモ）が含まれています。アーカイブ時刻は、録画がアーカイブされた現在の日付と時刻を表します。アーカイブメモは、アーカイブ中に追加できるオプションのテキストメモです。これら2つのフィールドは、録画がアーカイブされたことと、アーカイブされた時刻を示します。
セッション録画プレーヤーでは、アーカイブされたセッション録画は「アーカイブ済み」のステータスとアーカイブの日付と時刻を表示します。ファイルが移動されていない場合、アーカイブされたセッション録画は引き続き再生できる可能性があります。セッション録画ファイルがアーカイブ中に移動された場合、「ファイルが見つかりません」エラーが表示されます。セッションを再生する前に、セッション録画ファイルを復元する必要があります。セッション録画ファイルを復元するには、録画ファイルのファイルIDとアーカイブ時刻を提供します。アーカイブされたファイルの復元については、以下の「セッション録画ファイルを復元する」セクションで詳しく説明します。
ICLDBユーティリティのARCHIVEコマンドには、以下に説明するいくつかのパラメーターがあります。
-
/RETENTION:<days> - セッション録画の保持期間を日数で指定します。指定された日数よりも古い録画は、セッション録画データベースでアーカイブ済みとしてマークされます。保持期間は、2日以上の整数である必要があります。
-
/FILTER:<filter>:
*と?のワイルドカードを使用してファイルパスをフィルタリングできます。FILTERパラメーターはオプションです。FILTERパラメーターを追加した場合、RETENTIONとFILTERの両方を満たすセッション録画ファイルのみがアーカイブされます。 -
/LISTFILES – セッション録画ファイルがアーカイブされる際に、そのフルパスとファイル名を一覧表示します。このパラメーターはオプションです。
-
/MOVETO:<directory> - アーカイブされたセッション録画ファイルを物理的に移動するディレクトリ。指定されたディレクトリは存在している必要があります。このパラメーターはオプションです。ディレクトリが指定されていない場合、ファイルは元のストレージの場所に残ります。
-
/NOTE:<note> - アーカイブされた各セッション録画のデータベースレコードに追加されるテキストメモ。メモは二重引用符で囲む必要があります。このパラメーターはオプションです。
-
/L – アーカイブされたセッション録画ファイルの数に関する結果とエラーをWindowsイベントログに記録します。このパラメーターはオプションです。
-
/F – プロンプトなしでアーカイブコマンドの実行を強制します。このパラメーターはオプションです。
セッション録画データベースでセッション録画をアーカイブし、セッション録画ファイルを物理的に移動するには
-
セッションレコーディングサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、セッションレコーディングサーバーのインストールパスのBinディレクトリに移動します (
<Session Recording server Installation Path>/Server/Bin)。 -
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /Lコマンドを実行します。ここで、days はセッションレコーディングファイルの保持期間、directory はアーカイブされたセッションレコーディングファイルの移動先ディレクトリ、note はアーカイブされる各セッションレコーディングファイルのデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。
セッションレコーディングデータベース内のセッションレコーディングのみをアーカイブするには
-
セッションレコーディングサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、セッションレコーディングサーバーのインストールパスのBinディレクトリ (<Session Recording server installation path>/Server/Bin) に移動します。
-
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Lコマンドを実行します。ここで、days はセッションレコーディングの保持期間、note はアーカイブされる各セッションレコーディングのデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。
セッションレコーディングファイルを復元する
セッションレコーディングデータベースにアーカイブされ、レコーディング保存場所から移動されたレコーディングファイルを表示するには、それを復元します。アーカイブ中にレコーディング保存場所から移動されなかったアーカイブ済みセッションレコーディングは、引き続きプレーヤーでアクセスできます。
移動されたセッションレコーディングファイルを復元するには、2つの方法があります。必要なセッションレコーディングファイルをアーカイブ済みファイルの復元ディレクトリにコピーするか、ICLDBユーティリティを使用して必要なセッションレコーディングファイルをセッションレコーディングデータベースにインポートします。アーカイブ済みセッションレコーディングファイルの復元には、最初の方法をお勧めします。不要になったアーカイブ済みファイルは、アーカイブ済みファイルの復元ディレクトリから削除してください。
セッションレコーディングブローカーは、セッションレコーディングファイルが元の保存場所に見つからない場合に、アーカイブ済みファイルの復元ディレクトリを使用します。これは、プレーヤーが再生のためにセッションレコーディングファイルを要求したときに発生します。セッションレコーディングブローカーはまず、元の保存場所でセッションレコーディングファイルを見つけようとします。元の保存場所でファイルが見つからない場合、セッションレコーディングブローカーはアーカイブ済みファイルの復元ディレクトリを確認します。ファイルが復元ディレクトリに存在する場合、セッションレコーディングブローカーはそのファイルを再生のためにプレーヤーに送信します。ファイルが見つからない場合、セッションレコーディングブローカーはファイルが見つからないというエラーをプレーヤーに送信します。
アーカイブされたレコーディングファイルをインポートすると、新しい保存パスを含むセッションレコーディング情報でセッションレコーディングデータベースが更新されます。アーカイブされたセッションレコーディングファイルをインポートしても、セッションがレコーディングされたときの元の保存場所にはファイルは戻されません。
注： インポートされたセッションレコーディングファイルは、セッションレコーディングデータベースでアーカイブ時刻とアーカイブメモがクリアされます。次回ICLDB ARCHIVEコマンドが実行されると、インポートされたセッションレコーディングファイルが再度アーカイブされる可能性があります。
ICLDB IMPORTコマンドは、大量のアーカイブされた録画ファイルをインポートするのに役立ちます。セッション録画データベース内の不正確または欠落しているセッション録画データを修復または更新できます。また、セッション録画ファイルをSession Recordingサーバー上のあるストレージの場所から別の場所に移動するのにも役立ちます。ICLDB REMOVEALLコマンドを実行した後、ICLDB IMPORTコマンドを使用して、セッション録画データベースにセッション録画を再投入できます。
ICLDBユーティリティのIMPORTコマンドには、アーカイブされた録画ファイルを復元するために使用できるいくつかのパラメーターがあります。
-
/LISTFILES – インポート中にセッション録画ファイルの完全なパスとファイル名を一覧表示します。このパラメーターはオプションです。
-
/RECURSIVE – すべてのサブディレクトリでセッション録画ファイルを検索します。このパラメーターはオプションです。
-
/L – インポートされたセッション録画ファイルの数と結果およびエラーをWindowsイベントログに記録します。このパラメーターはオプションです。
-
/F – プロンプトなしでIMPORTコマンドを強制的に実行します。このパラメーターはオプションです。
注：
ICLDBユーティリティのIMPORTコマンドには、録画ファイルを再配置するために使用できるオプションのパラメーターRELOCATEも用意されています。詳細については、この記事の「セッション録画ファイルを再配置する」セクションを参照してください。
アーカイブされたファイルの復元ディレクトリを使用してセッション録画ファイルを復元する
-
Session Recordingサーバーがインストールされているサーバーにローカル管理者としてログオンします。
-
Session Recording Playerのプロパティで、アーカイブされたセッション録画ファイルのファイルIDとアーカイブ時刻を特定します。
-
Session Recording Playerのプロパティで指定されたファイルIDを使用して、バックアップ内のセッション録画ファイルを見つけます。各セッション録画のファイル名は
i_<FileID>.iclで、FileIDはセッション録画ファイルのIDです。 -
バックアップからアーカイブされたファイルの復元ディレクトリにセッション録画ファイルをコピーします。アーカイブされたファイルの復元ディレクトリを特定するには：
-
スタートメニューから、スタート > すべてのプログラム > Citrix® > Session Recording Server Propertiesを選択します。
-
セッションレコーディングサーバーのプロパティで、ストレージタブを選択します。現在の復元ディレクトリは、アーカイブファイルの復元ディレクトリフィールドに表示されます。
-
ICLDB IMPORTコマンドを使用してセッション録画ファイルを復元する
-
セッション録画サーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、セッション録画サーバーのインストールパスのBinディレクトリ（
<Session Recording server installation path>/Server/Bin）に移動します。 -
次のいずれかを実行します。
-
ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory>コマンドを実行します。ここで、directoryは、セッション録画ファイルを含む1つ以上のディレクトリの名前をスペースで区切ったものです。インポートを確定するには「Y」と入力します。 -
ICLDB IMPORT /LISTFILES /L <file>コマンドを実行します。ここで、fileは、1つ以上のセッション録画ファイルの名前をスペースで区切ったものです。ワイルドカードを使用してセッション録画ファイルを指定することもできます。インポートを確定するには「Y」と入力します。
-
セッション録画ファイルを再配置する
セッション録画ファイルを、負荷分散やその他の目的のために別のストレージパスに移動できます。ファイルが引き続き再生できるようにするには、新しいパスをセッション録画データベースに更新する必要があります。これを行うには、「ICLDB IMPORT」コマンドを使用します。インポートプロセスを高速化するには、「ICLDB IMPORT」コマンドに「RELOCATE」パラメーターを追加します。
注：
RELOCATEパラメーターはオプションです。RELOCATEパラメーターがない場合、「ICLDB IMPORT」コマンドはセッション録画ファイルを完全に解析するため、時間がかかります。RELOCATEパラメーターを使用すると、「ICLDB IMPORT」コマンドはセッション録画ファイルのデータベースレコードを単に検索し、ファイルパスを直接更新します。
次の手順は、RELOCATEパラメーターを使用して新しいファイルパスをセッション録画データベースに更新する方法を示しています。
-
必要に応じて、セッション録画ファイルを別のストレージパスに移動します。
-
セッション録画サーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリからSession RecordingサーバーのインストールパスのBinディレクトリに移動します (
<Session Recording server installation path>/Server/Bin)。 -
いずれか：
-
ICLDB IMPORT /LISTFILES /RECURSIVE /RELOCATE /L <directory>コマンドを実行します。ここで、directory は、セッション記録ファイルを含む1つ以上のディレクトリの名前をスペースで区切ったものです。インポートを確定するには「Y」と入力します。 -
ICLDB IMPORT /LISTFILES /RELOCATE /L <file>コマンドを実行します。ここで、file は、1つ以上のセッション記録ファイルの名前をスペースで区切ったものです。ワイルドカードを使用してセッション記録ファイルを指定できます。インポートを確定するには「Y」と入力します。
-
注：
- RELOCATEパラメーターは、Session Recordingデータベースにセッション記録ファイルのレコードがすでに存在することを前提としています。
- セッション記録ファイルは、移動する前に再生可能である必要があります。そうでない場合、RELOCATEパラメーターは役に立ちません。
- セッション記録ファイルの新しい保存パスは、Session Recordingサーバーによって認識可能である必要があります。これらは、Session Recording Server Properties の Storage タブで試すことができます。