録画の管理
ICAログデータベース（ICLDB）は、データベース用のコマンドラインユーティリティで、セッションの録画のデータベースレコードを操作するために使用します。このユーティリティは、Session Recordingサーバーをホストするサーバーの\Program Files\Citrix\SessionRecording\Server\Binフォルダーに、Session Recordingと合わせてインストールされます。
クイックリファレンス
次の表に、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 |
セッションの録画ファイルをSession Recordingデータベースにインポートします。このコマンドを使用して、データベースレコードを失ったときにデータベースを再構築します。また、このコマンドを使用して、データベースをマージします。2つのデータベースがある場合は、一方のデータベースからファイルをインポートできます。2303リリースでは、IMPORTコマンドにRELOCATEパラメーターが導入されています。RELOCATEパラメーターを指定しないと、IMPORTコマンドはセッションの録画ファイル全体を解析するため、時間がかかります。RELOCATEパラメーターを使用すると、IMPORTコマンドはセッションの録画ファイルのデータベースレコードを検索し、それらのファイルパスを直接更新します。 |
LOCATE |
ファイルIDを条件として、セッションの録画ファイルを検索しフルパスを表示します。このコマンドを使用して、セッションの録画ファイルの格納場所を検索します。このコマンドは、特定のファイルを条件にデータベースが最新の状態かどうかを検証する手段としても使用できます。 |
REMOVE |
セッションの録画ファイルへの参照をデータベースから削除します。このコマンドを使用して、データベースをクリーンアップします。ただし、注意して使用してください。関連付けられている物理ファイルを削除することもできます。REMOVEコマンドを使用する場合、RETENTIONおよびFILTERパラメーターを使用して対象のセッションの録画ファイルを指定します。RETENTIONパラメーターは必ず指定する必要があります。これによって、指定された保持期間よりも古いセッションの録画ファイルを操作できます。FILTERパラメーターはオプションです。ワイルドカード「*」および「?」を使用して、ファイルパスをフィルタリングできます。FILTERパラメーターを追加すると、RETENTIONとFILTERの両方を満たすセッションの録画ファイルのみを操作できます。 |
REMOVEALL |
セッションの録画ファイルへのすべての参照をSession Recordingデータベースから削除し、データベースを元の状態に戻します。実際の物理ファイルは削除されません。ただし、Session Recording Playerでファイルを検索することはできなくなります。このコマンドを使用して、データベースをクリーンアップします。ただし、注意して使用してください。削除された参照はバックアップから復元しない限り元に戻せません。 |
VERSION |
Session Recordingデータベースのスキーマバージョンを表示します。 |
/L |
結果とエラーをWindowsのイベントログに記録します。 |
/F |
プロンプトを表示せずにコマンドを強制的に実行します。 |
/S |
著作権のメッセージを非表示にします。 |
/? |
コマンドのオンラインヘルプを表示します。 |
セッションの録画ファイルのアーカイブ
録画の格納場所に適切なレベルの空きディスク容量を維持するには、セッションの録画ファイルを定期的にアーカイブします。使用可能なディスク容量と標準的な録画ファイルのサイズに応じて、アーカイブ間隔は異なります。録画開始日から2日以上経過すると、セッションの録画ファイルはアーカイブ可能となります。この規則は、ライブ録画が完了する前にアーカイブされないようにするためのものです。
セッション録画をアーカイブするには、2つの方法があります。録画ファイルが録画の格納場所にある間に、録画ファイルのデータベースレコードを更新してアーカイブ済みのステータスにすることができます。この方法を使用すると、Playerでの検索結果を減らすことができます。もう1つの方法は、録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新し、そのファイルを録画の格納場所から別の場所に移して代替メディアにバックアップする方法です。ICLDBユーティリティを使ってセッションの録画ファイルを移動する場合、それらのファイルは、年/月/日の元のファイルフォルダー構造のない指定されたディレクトリに移動します。
Session Recordingデータベースのセッションの録画レコードには、アーカイブに関連する2つのフィールド（アーカイブ日時とアーカイブメモ）が含まれています。アーカイブ日時は、録画がアーカイブされた最新の日時を表します。アーカイブメモは、アーカイブ中に追加できる任意のテキストメモです。この2つのフィールドは、録画がアーカイブされたこと、およびアーカイブの日時を示します。
Session Recording Playerでは、アーカイブされたセッションの録画にアーカイブ済みのステータスとアーカイブ日時が示されます。ファイルが移動していなくても、アーカイブされたセッション録画は再生されます。アーカイブ中にセッションの録画ファイルが移動した場合、「ファイルが見つかりません」というエラーが表示されます。セッションを再生するには、セッションの録画ファイルを復元する必要があります。セッションの録画ファイルを復元するには、録画ファイルのファイルIDとアーカイブ日時を指定します。アーカイブされたファイルの復元については、以下の「セッションの録画ファイルの復元」セクションで詳しく説明しています。
ICLDBユーティリティのARCHIVEコマンドには、次のようなさまざまなパラメーターがあります：
-
/RETENTION:<days> - セッション録画の保有期間（日数）。指定された日数を超過した録画は、Session Recordingデータベースでアーカイブ済みにマークされます。保有期間は2日以上の整数とする必要があります。
-
/FILTER:<filter>：ワイルドカード「
*」および「?」を使用して、ファイルパスをフィルタリングできます。FILTERパラメーターはオプションです。FILTERパラメーターを追加すると、RETENTIONとFILTERの両方を満たすセッションの録画ファイルのみをアーカイブできます。 -
/LISTFILES - セッションの録画ファイルのアーカイブ時の完全なファイルパスとファイルを一覧表示します。このパラメーターはオプションです。
-
/MOVETO:<directory> - アーカイブされたセッションの録画ファイルを物理的に移動する移動先ディレクトリ。あらかじめ存在するディレクトリを指定する必要があります。このパラメーターはオプションです。ディレクトリが指定されていない場合、ファイルは元の格納場所に残ります。
-
/NOTE:<note> - データベースレコードに追加される、アーカイブされた各セッション録画のテキストを含むメモ。このメモは二重引用符で囲んでください。このパラメーターはオプションです。
-
/L - Windowsイベントログに、アーカイブされたセッションの録画ファイルの結果とエラーの数を記録します。このパラメーターはオプションです。
-
/F - プロンプトを表示せずにarchiveコマンドを強制的に実行します。このパラメーターはオプションです。
Session Recordingデータベースにセッション録画をアーカイブし、セッションの録画ファイルを物理的に移動するには
-
Session Recordingサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを開始します。
-
現在の作業ディレクトリから、Session RecordingサーバーのインストールパスのBinディレクトリ（
<Session Recording server Installation Path>/Server/Bin）に変更します。 -
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /Lコマンドを実行します。ここで、daysはセッションの録画ファイルの保有期間、directoryはアーカイブされたセッションの録画ファイルの移動先ディレクトリ、noteはデータベースレコードに追加された、アーカイブされた各セッションの録画ファイルに関するメモです。Yと入力してアーカイブを確定します。
Session Recordingデータベースでセッション録画のアーカイブのみを行うには
-
Session Recordingサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを開始します。
-
現在の作業ディレクトリから、Session RecordingサーバーのインストールパスのBinディレクトリ（<Session Recordingサーバーのインストールパス>/Server/Bin）に変更します。
-
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Lコマンドを実行します。ここで、daysはセッション録画の保有期間、noteはデータベースレコードに追加された、アーカイブされる各セッション録画に関するメモです。Yと入力してアーカイブを確定します。
セッションの録画ファイルの復元
Session Recordingデータベースにアーカイブされ、録画の格納場所から移動した録画ファイルを表示するには、ファイルを復元します。アーカイブ中に録画の格納場所から移動されなかったアーカイブ済みのセッション録画は、Playerで引き続きアクセスできます。
移動されたセッションの録画ファイルを復元するには、2つの方法があります。必要なセッションの録画ファイルを、アーカイブ済みファイルの復元フォルダーにコピーします。または、ICLDBユーティリティを使用して、必要なセッションの録画ファイルをSession Recordingデータベースにインポートします。アーカイブされたセッションの録画ファイルの復元には、最初の方法をお勧めします。アーカイブ済みファイルの復元フォルダーにコピーしたファイルは、不要になった場合、削除します。
Session Recording Brokerでは、セッションの録画ファイルが元の格納場所に見つからない場合、アーカイブ済みファイルの復元フォルダーを利用します。このケースは、Playerからセッションの録画ファイルの再生が要求された場合に発生します。Session Recording Brokerは最初に、元の格納場所でセッションの録画ファイルを探します。ファイルが元の格納場所に見つからない場合、Session Recording Brokerは次に、アーカイブ済みファイルの復元フォルダーをチェックします。ファイルが復元フォルダーに存在する場合には、Session Recording Brokerは再生するためにそのファイルをPlayerに送信します。ファイルが見つからない場合は、Session Recording Brokerは「ファイルが見つかりません」というエラーをPlayerに送信します。
アーカイブ済みの録画ファイルをインポートすると、Session Recordingデータベースがこのファイルのセッション録画情報（新しい格納パスなど）で更新されます。アーカイブされたセッションの録画ファイルをインポートしても、ファイルはセッション録画時の元の格納場所には戻されません。
注： インポートされたセッションの録画ファイルには、Session Recordingデータベースで消去されたアーカイブ日時とアーカイブメモが含まれています。次にICLDBのARCHIVEコマンドを実行したとき、インポートされたセッションの録画ファイルが再度アーカイブされることがあります。
ICLDBのARCHIVEコマンドは、アーカイブされた多数の録画ファイルをインポートするのに役立ちます。これにより、Session Recordingデータベース内の誤った欠落しているセッション録画データを修復または更新できます。また、Session Recordingサーバー上のある格納場所から別の格納場所にセッション録画ファイルを移動する場合にも役立ちます。ICLDBのIMPORTコマンドは、ICLDBのREMOVEALLコマンドの実行後、Session Recordingデータベースにセッション録画を再取り込みするのにも使用できます。
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サーバーのプロパティ］ の順に選択します。
-
［Session Recordingサーバーのプロパティ］ で、［格納場所］ タブを選択します。［アーカイブ済みファイルの復元フォルダー］ フィールドに現在の復元ディレクトリが表示されます。
-
ICLDBのIMPORTコマンドを使用してセッションの録画ファイルを復元する
-
Session Recordingサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを開始します。
-
現在の作業ディレクトリから、Session Recordingサーバーのインストールパスの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と入力してインポートを確定します。
-
セッション録画ファイルの再配置
セッション録画ファイルを負荷分散やその他の目的で別の格納パスに移動できます。ファイルを引き続き再生できるようにするには、Session Recordingデータベースへの新しいパスを更新する必要があります。これを行うには、ICLDBのIMPORTコマンドを使用します。インポート処理を高速化するには、ICLDBのIMPORTコマンドにRELOCATEパラメーター追加します。
注：
RELOCATEパラメーターはオプションです。RELOCATEパラメーターを指定しないと、ICLDBのIMPORTコマンドはセッションの録画ファイル全体を解析するため、時間がかかります。RELOCATEパラメーターを使用すると、ICLDBのIMPORTコマンドはセッションの録画ファイルのデータベースレコードを検索し、それらのファイルパスを直接更新します。
以下の手順は、RELOCATEパラメーターを使用してSession Recordingデータベースへの新しいパスを更新する方法を示しています。
-
必要に応じて、セッション録画ファイルを別の格納パスに移動します。
-
Session Recordingサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを開始します。
-
現在の作業ディレクトリから、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 のプロパティ］ の ［格納場所］ タブで試すことができます。