データベースレコードを管理する
ICA Log database (ICLDB) ユーティリティは、セッション記録データベースレコードを操作するために使用されるデータベースコマンドラインユーティリティです。このユーティリティは、Session Recording のインストール中に、Session Recording Server をホストするサーバーのドライブ:\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つの方法があります。セッション録画ファイルが録画ストレージの場所に残っている間に、セッション録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新できます。この方法は、Playerでの検索結果を減らすために使用できます。もう1つの方法は、セッション録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新し、セッション録画ファイルを録画ストレージの場所から別の場所へ移動して、代替メディアにバックアップすることです。ICLDBユーティリティがセッション録画ファイルを移動すると、ファイルは指定されたディレクトリに移動され、元の年/月/日のファイルフォルダ構造は存在しなくなります。
Session Recording Databaseのセッション録画レコードには、アーカイブに関連する2つのフィールドが含まれています。1つは、セッション録画がアーカイブされた現在の日時を表すアーカイブ時間。もう1つは、アーカイブ中に管理者が追加できるオプションのテキストメモであるアーカイブノートです。これら2つのフィールドは、セッション録画がアーカイブされたことと、アーカイブされた時間を示します。
Session Recording Playerでは、アーカイブされたセッション録画は「アーカイブ済み」のステータスとアーカイブ日時を表示します。ファイルが移動されていない場合、アーカイブされたセッション録画は再生できることがあります。アーカイブ中にセッション録画ファイルが移動された場合、「ファイルが見つかりません」エラーが表示されます。セッションを再生する前に、セッション録画ファイルを復元する必要があります。セッション録画を復元するには、Session Recording Playerの録画プロパティダイアログボックスから、セッション録画のファイルIDとアーカイブ時間を管理者に提供してください。アーカイブされたファイルの復元については、以下の「(/ja-jp/xenapp-and-xendesktop/7-15-ltsr/monitor/session-recording/reference.html#restore-session-recording-files)」セクションで詳しく説明します。
ICLDBユーティリティのarchiveコマンドには、以下に説明するいくつかのパラメーターがあります。
-
/RETENTION:<days> - セッション録画の保持期間(日数)。指定された日数よりも古い録画は、Session Recording Databaseでアーカイブ済みとしてマークされます。保持期間は2日以上の整数である必要があります。
-
/LISTFILES – アーカイブされるセッション録画ファイルの完全なパスとファイル名を一覧表示します。このパラメーターはオプションです。
-
/MOVETO:<directory> - アーカイブされたセッション録画ファイルを物理的に移動するディレクトリ。指定されたディレクトリは存在している必要があります。このパラメーターはオプションです。ディレクトリが指定されていない場合、ファイルは元のストレージの場所に残ります。
-
/NOTE:<note> - アーカイブされた各セッション録画のデータベースレコードに追加されるテキストメモ。メモは二重引用符で囲むようにしてください。このパラメーターはオプションです。
-
/L – アーカイブされたセッション録画ファイルの数に関する結果とエラーをWindowsイベントログに記録します。このパラメーターはオプションです。
-
/F – プロンプトなしでアーカイブコマンドを実行するように強制します。このパラメーターはオプションです。
Session Recording Databaseでセッション録画をアーカイブし、セッション録画ファイルを物理的に移動するには
-
Session Recording Serverがインストールされているサーバーにローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、セッションレコーディングサーバーのインストールパスのBinディレクトリ (
<Session Recording Server Installation Path>/Server/Bin) に変更します。 -
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /Lコマンドを実行します。ここで、days はセッションレコーディングファイルの保持期間、directory はアーカイブされたセッションレコーディングファイルの移動先ディレクトリ、note はアーカイブされる各セッションレコーディングファイルのデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。
セッションレコーディングデータベース内のセッションレコーディングのみをアーカイブするには
-
セッションレコーディングサーバーがインストールされているサーバーに、ローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、セッションレコーディングサーバーのインストールパス (<Session Recording Server Installation Path>/Server/Bin) のBinディレクトリに変更します。
-
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Lコマンドを実行します。ここで、days はセッションレコーディングの保持期間、note はアーカイブされる各セッションレコーディングのデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。
セッションレコーディングファイルを復元する
セッションレコーディングデータベースにアーカイブされ、レコーディング保存場所から移動されたセッションレコーディングを表示したい場合は、セッションレコーディングファイルの復元が必要です。アーカイブ中にレコーディング保存場所から移動されなかったアーカイブ済みセッションレコーディングは、引き続きSession Recording Playerでアクセスできます。
移動されたセッションレコーディングファイルを復元するには、2つの方法があります。必要なセッションレコーディングファイルをアーカイブ済みファイルの復元ディレクトリにコピーするか、ICLDBユーティリティを使用して必要なセッションレコーディングファイルをセッションレコーディングデータベースにインポートします。Citrix®は、アーカイブ済みセッションレコーディングファイルを復元するには最初の方法を推奨します。不要になったアーカイブ済みファイルは、アーカイブ済みファイルの復元ディレクトリにコピーされたものから削除してください。
Session Recording Brokerは、セッションレコーディングファイルが元の保存場所に見つからない場合に、アーカイブ済みファイルの復元ディレクトリを利用します。これは、Session Recording Playerが再生のためにセッションレコーディングファイルを要求したときに発生します。Session Recording Brokerはまず、元の保存場所でセッションレコーディングファイルを見つけようとします。元の保存場所でファイルが見つからない場合、Session Recording Brokerはアーカイブ済みファイルの復元ディレクトリを確認します。ファイルが復元ディレクトリに存在する場合、Session Recording BrokerはそのファイルをSession Recording Playerに送信して再生します。それ以外の場合、ファイルが見つからないと、Session Recording Brokerはファイルが見つからないというエラーをSession Recording Playerに送信します。
ICLDBユーティリティを使用してアーカイブ済みセッションレコーディングファイルをインポートすると、セッションレコーディングファイルからのセッションレコーディング情報(セッションレコーディングファイルの新しい保存パスを含む)でセッションレコーディングデータベースが更新されます。ICLDBユーティリティを使用してアーカイブ済みセッションレコーディングファイルをインポートしても、セッションが記録されたときの元の保存場所にはファイルは戻されません。
注: インポートされたセッションレコーディングファイルは、セッションレコーディングデータベースでアーカイブ時間とアーカイブメモがクリアされます。そのため、次回ICLDB archive コマンドが実行されると、インポートされたセッションレコーディングファイルが再度アーカイブされる可能性があります。
ICLDB import コマンドは、多数のアーカイブ済みセッションレコーディングファイルをインポートしたり、セッションレコーディングデータベース内の誤ったまたは欠落しているセッションレコーディングデータを修復または更新したり、セッションレコーディングサーバー上のセッションレコーディングファイルをある保存場所から別の保存場所に移動したりするのに役立ちます。ICLDB import コマンドは、ICLDB removeall コマンドの実行後にセッションレコーディングデータベースにセッションレコーディングを再投入するためにも使用できます。
ICLDBユーティリティのimportコマンドには、以下に示すいくつかのパラメーターがあります。
-
/LISTFILES – セッション録画ファイルをインポート中に、その完全なパスとファイル名を一覧表示します。このパラメーターはオプションです。
-
/RECURSIVE – すべてのサブディレクトリでセッション録画ファイルを検索します。このパラメーターはオプションです。
-
/L – インポートされたセッション録画ファイルの数に関する結果とエラーをWindowsイベントログに記録します。このパラメーターはオプションです。
-
/F – プロンプトなしでインポートコマンドを強制的に実行します。このパラメーターはオプションです。
アーカイブされたファイルの復元ディレクトリを使用してセッション録画ファイルを復元するには
-
Session Recording Serverがインストールされているサーバーにローカル管理者としてログオンします。
-
Session Recording Playerのプロパティで、アーカイブされたセッション録画ファイルのファイルIDとアーカイブ時刻を特定します。
-
Session Recording Playerのプロパティで指定されたファイルIDを使用して、バックアップ内のセッション録画ファイルを特定します。各セッション録画ファイルの名前は
i_<FileID>.iclで、FileIDはセッション録画ファイルのIDです。 -
セッション録画ファイルをバックアップからアーカイブされたファイルの復元ディレクトリにコピーします。アーカイブされたファイルの復元ディレクトリを特定するには:
-
スタートメニューから、スタート > すべてのプログラム > Citrix > Session Recording Serverのプロパティを選択します。
-
Session Recording Serverのプロパティで、ストレージタブを選択します。現在の復元ディレクトリがアーカイブされたファイルの復元ディレクトリフィールドに表示されます。
-
ICLDB importコマンドを使用してセッション録画ファイルを復元するには
-
Session Recording Serverがインストールされているサーバーにローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、Session Recording Serverのインストールパスにある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を入力します。
-