録画を管理する
ICA log database (ICLDB) は、セッション録画データベースレコードを操作するために使用されるデータベースコマンドラインユーティリティです。このユーティリティは、Session Recording のインストール中に、Session Recording サーバーをホストするサーバー上の \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 |
指定された保持期間よりも古いセッション録画ファイルをアーカイブします。このコマンドを使用して、録画内の録画とイベントをアーカイブします。イベントは ArchivedEvent データベーステーブルにアーカイブされます。 |
dormant |
休止状態と見なされるセッション録画ファイルを表示またはカウントします。休止状態のファイルとは、データ損失により完了しなかったセッション録画です。このコマンドを使用して、データ損失の疑いがある場合に確認します。セッション録画ファイルがデータベース全体で休止状態になっているか、または指定された日数、時間、または分以内に作成された録画のみが休止状態になっているかを確認できます。 |
import |
セッション録画ファイルを Session Recording データベースにインポートします。このコマンドを使用して、データベースレコードを失った場合にデータベースを再構築します。また、このコマンドを使用してデータベースをマージすることもできます(2つのデータベースがある場合、一方のデータベースからファイルをインポートできます)。 |
locate |
ファイルIDを基準として、セッション録画ファイルのフルパスを検索して表示します。セッション録画ファイルの保存場所を探しているときに、このコマンドを使用します。また、データベースが特定のファイルで最新の状態であるかを確認する1つの方法でもあります。 |
remove |
データベースからセッション録画ファイルへの参照を削除します。このコマンドを(注意して)使用して、データベースをクリーンアップします。基準として使用する保持期間を指定します。関連する物理ファイルも削除できます。 |
removeall |
セッション録画データベースからセッション録画ファイルへのすべての参照を削除し、データベースを元の状態に戻します。実際の物理ファイルは削除されませんが、セッション録画プレーヤーでこれらのファイルを検索することはできません。このコマンドを(注意して)使用して、データベースをクリーンアップします。削除された参照は、バックアップから復元することによってのみ元に戻すことができます。 |
version |
セッション録画データベースのスキーマバージョンを表示します。 |
/l |
結果とエラーをWindowsイベントログに記録します。 |
/f |
プロンプトなしでコマンドを強制的に実行します。 |
/s |
著作権メッセージを非表示にします。 |
/? |
コマンドのヘルプを表示します。 |
セッション録画ファイルをアーカイブする
録画ストレージの場所に十分な空きディスク容量を維持するため、セッション録画ファイルを定期的にアーカイブしてください。利用可能なディスク容量と録画ファイルの一般的なサイズに応じて、アーカイブ間隔は異なります。セッション録画ファイルは、アーカイブされる前に、開始日から2日以上経過している必要があります。このルールは、ライブ録画が完了する前にアーカイブされるのを防ぐためのものです。
セッション録画をアーカイブする際には、2つの方法があります。1つは、録画ファイルが録画ストレージの場所に残っている間に、その録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新する方法です。この方法は、プレーヤーでの検索結果を減らすために使用できます。もう1つの方法は、録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新し、ファイルを録画ストレージの場所から別の場所に移動して、代替メディアにバックアップする方法です。ICLDBユーティリティがセッション録画ファイルを移動すると、ファイルは指定されたディレクトリに移動され、元の年/月/日のファイルフォルダー構造は存在しなくなります。
セッション録画データベース内のセッション録画レコードには、アーカイブに関連する2つのフィールド(アーカイブ時刻とアーカイブメモ)が含まれています。アーカイブ時刻は、録画がアーカイブされた現在の日付と時刻を表します。アーカイブメモは、アーカイブ中に追加できるオプションのテキストメモです。これら2つのフィールドは、録画がアーカイブされたことと、アーカイブされた時刻を示します。
Session Recordingプレーヤーでは、アーカイブされたセッション録画は「アーカイブ済み」のステータスとアーカイブの日時を表示します。ファイルが移動されていない場合、アーカイブされたセッション録画は引き続き再生できます。アーカイブ中にセッション録画ファイルが移動された場合、「ファイルが見つかりません」エラーが表示されます。セッションを再生する前に、セッション録画ファイルを復元する必要があります。セッション録画ファイルを復元するには、録画ファイルのファイルIDとアーカイブ時刻を指定します。アーカイブされたファイルの復元については、次のセッション録画ファイルを復元するセクションで詳しく説明します。
ICLDBユーティリティのarchiveコマンドには、次のような複数のパラメーターがあります。
-
/RETENTION:<days> - セッション録画の保持期間(日数)。指定された日数よりも古い録画は、Session Recordingデータベースでアーカイブ済みとしてマークされます。保持期間は、2日以上の整数である必要があります。
-
/LISTFILES – セッション録画ファイルがアーカイブされる際に、その完全なパスとファイル名を一覧表示します。このパラメーターはオプションです。
-
/MOVETO:<directory> - アーカイブされたセッション録画ファイルを物理的に移動するディレクトリ。指定されたディレクトリは存在している必要があります。このパラメーターはオプションです。ディレクトリが指定されていない場合、ファイルは元のストレージの場所に残ります。
-
/NOTE:<note> - アーカイブされた各セッション録画のデータベースレコードに追加されるテキストメモ。メモは二重引用符で囲むようにしてください。このパラメーターはオプションです。
-
/L – アーカイブされたセッション録画ファイルの数に関する結果とエラーをWindowsイベントログに記録します。このパラメーターはオプションです。
-
/F – プロンプトなしでアーカイブコマンドの実行を強制します。このパラメーターはオプションです。
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サーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
Change from the current working directory to the Bin directory of the Session Recording server installation path (<Session Recording server installation path>/Server/Bin).
-
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Lコマンドを実行します。ここで、daysはセッション録画の保持期間、noteはアーカイブされる各セッション録画のデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。
セッション録画ファイルを復元する
Session Recordingデータベースにアーカイブされ、録画保存場所から移動された録画ファイルを表示するには、そのファイルを復元します。アーカイブ中に録画保存場所から移動されなかったアーカイブ済みセッション録画は、Session Recording Playerで引き続きアクセスできます。
移動されたセッション録画ファイルを復元するには、2つの方法があります。必要なセッション録画ファイルをアーカイブ済みファイルの復元ディレクトリにコピーするか、ICLDBユーティリティを使用して必要なセッション録画ファイルをSession Recordingデータベースにインポートします。アーカイブ済みセッション録画ファイルの復元には、最初の方法をお勧めします。アーカイブ済みファイルの復元ディレクトリにコピーしたアーカイブ済みファイルは、不要になったら削除してください。
Session Recording Brokerは、セッション録画ファイルが元の保存場所に見つからない場合に、アーカイブ済みファイルの復元ディレクトリを使用します。これは、Session Recording Playerが再生のためにセッション録画ファイルを要求したときに発生します。Session Recording Brokerはまず、元の保存場所でセッション録画ファイルを見つけようとします。元の保存場所でファイルが見つからない場合、Session Recording Brokerはアーカイブ済みファイルの復元ディレクトリを確認します。ファイルが復元ディレクトリに存在する場合、Session Recording BrokerはそのファイルをSession Recording Playerに送信して再生します。ファイルが見つからない場合、Session Recording Brokerはファイルが見つからないエラーをSession Recording Playerに送信します。
アーカイブされた録画ファイルをインポートすると、新しい保存パスを含むセッション録画情報でSession Recordingデータベースが更新されます。アーカイブされたセッション録画ファイルをインポートしても、セッションが録画されたときの元の保存場所にはファイルは戻されません。
注: インポートされたセッション録画ファイルは、Session Recordingデータベースでアーカイブ時刻とアーカイブメモがクリアされます。次回ICLDB archiveコマンドが実行されると、インポートされたセッション録画ファイルが再度アーカイブされる可能性があります。
ICLDB importコマンドは、多数のアーカイブ済み録画ファイルをインポートするのに役立ちます。Session Recordingデータベース内の誤ったセッション録画データや欠落しているセッション録画データを修復または更新できます。また、Session Recordingサーバー上でセッション録画ファイルをある保存場所から別の保存場所に移動することもできます。ICLDB removeallコマンドを実行した後、ICLDB importコマンドを使用してSession Recordingデータベースにセッション録画を再投入できます。
ICLDB ユーティリティの import コマンドにはいくつかのパラメータがあり、それらを以下に示します。
-
/LISTFILES – インポート中にセッション記録ファイルの完全なパスとファイル名を一覧表示します。このパラメータはオプションです。
-
/RECURSIVE – すべてのサブディレクトリからセッション記録ファイルを検索します。このパラメータはオプションです。
-
/L – インポートされたセッション記録ファイルの数、結果、およびエラーを Windows イベントログに記録します。このパラメータはオプションです。
-
/F – プロンプトなしでインポートコマンドを実行するように強制します。このパラメータはオプションです。
アーカイブされたファイルの復元ディレクトリを使用してセッション記録ファイルを復元するには
-
セッション記録サーバーがインストールされているサーバーにローカル管理者としてログオンします。
-
Session Recording Player のプロパティで、アーカイブされたセッション記録ファイルのファイル ID とアーカイブ時刻を特定します。
-
Session Recording Player のプロパティで指定されたファイル ID を使用して、バックアップ内のセッション記録ファイルを特定します。各セッション記録のファイル名は
i_<FileID>.iclで、ここで FileID はセッション記録ファイルの ID です。 -
バックアップからセッション記録ファイルをアーカイブされたファイルの復元ディレクトリにコピーします。アーカイブされたファイルの復元ディレクトリを特定するには:
-
スタートメニューから、スタート > すべてのプログラム > Citrix® > Session Recording Server Properties を選択します。
-
Session Recording Server Properties で、ストレージタブを選択します。現在の復元ディレクトリは、アーカイブされたファイルの復元ディレクトリフィールドに表示されます。
-
ICLDB import コマンドを使用してセッション記録ファイルを復元するには
-
セッション記録サーバーがインストールされているサーバーにローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、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」と入力します。
-