データベースレコードを管理する
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 |
指定された保持期間よりも古いセッションレコーディングファイルをアーカイブします。このコマンドを使用して、レコーディング内のレコーディングとイベントをアーカイブします。イベントはArchivedEventデータベーステーブルにアーカイブされます。 |
dormant |
休止状態と見なされるセッションレコーディングファイルを表示またはカウントします。休止状態のファイルとは、データ損失により完了しなかったセッションレコーディングです。データ損失が疑われる場合に、このコマンドを使用して確認します。セッションレコーディングファイルがデータベース全体で休止状態になっているか、または指定された日数、時間、分以内に作成されたレコーディングのみが休止状態になっているかを確認できます。 |
import |
セッションレコーディングファイルをセッションレコーディングデータベースにインポートします。データベースレコードを失った場合に、このコマンドを使用してデータベースを再構築します。また、このコマンドを使用してデータベースをマージすることもできます（2つのデータベースがある場合、一方のデータベースからファイルをインポートできます）。 |
locate |
ファイルIDを基準として、セッション記録ファイルの完全なパスを検索して表示します。セッション記録ファイルの保存場所を探しているときにこのコマンドを使用します。また、データベースが特定のファイルで最新であるかを確認する1つの方法でもあります。 |
remove |
データベースからセッション記録ファイルへの参照を削除します。このコマンドを（注意して）使用して、データベースをクリーンアップします。基準として使用する保持期間を指定します。関連する物理ファイルも削除できます。 |
removeall |
セッション記録データベースからセッション記録ファイルへのすべての参照を削除し、データベースを元の状態に戻します。実際の物理ファイルは削除されませんが、セッション記録プレーヤーでこれらのファイルを検索することはできません。このコマンドを（注意して）使用して、データベースをクリーンアップします。削除された参照は、バックアップから復元することによってのみ元に戻すことができます。 |
version |
セッション記録データベースのスキーマバージョンを表示します。 |
/l |
結果とエラーをWindowsイベントログに記録します。 |
/f |
プロンプトなしでコマンドを強制的に実行します。 |
/s |
著作権メッセージを非表示にします。 |
/? |
コマンドのヘルプを表示します。 |
セッション録画ファイルをアーカイブする
録画ストレージの場所に十分な空きディスク容量を維持するため、セッション録画ファイルを定期的にアーカイブしてください。利用可能なディスク容量とセッション録画ファイルの一般的なサイズによって、アーカイブ間隔は異なります。セッション録画ファイルは、アーカイブされる前に、開始日から2日以上経過している必要があります。このルールは、ライブ録画が完了する前にアーカイブされるのを防ぐためのものです。
セッション録画をアーカイブする際には、2つの方法があります。1つは、セッション録画ファイルが録画ストレージの場所に残っている間に、そのセッション録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新する方法です。この方法は、Playerでの検索結果を減らすために使用できます。もう1つの方法は、セッション録画ファイルのデータベースレコードをアーカイブ済みのステータスに更新し、さらにセッション録画ファイルを録画ストレージの場所から別の場所に移動して、代替メディアにバックアップする方法です。ICLDBユーティリティがセッション録画ファイルを移動する場合、ファイルは指定されたディレクトリに移動され、元の年/月/日のファイルフォルダ構造は存在しなくなります。
セッション録画データベース内のセッション録画レコードには、アーカイブに関連する2つのフィールドが含まれています。1つは、セッション録画がアーカイブされた現在の日時を表すアーカイブ時間。もう1つは、アーカイブ中に管理者が追加するオプションのテキストメモであるアーカイブノートです。これら2つのフィールドは、セッション録画がアーカイブされたことと、アーカイブされた時間を示します。
Session Recording Playerでは、アーカイブされたセッション録画は「アーカイブ済み」のステータスとアーカイブ日時を表示します。アーカイブされたセッション録画は、ファイルが移動されていない場合は再生できることがあります。アーカイブ中にセッション録画ファイルが移動された場合、「ファイルが見つかりません」エラーが表示されます。セッションを再生する前に、セッション録画ファイルを復元する必要があります。セッション録画を復元するには、Session Recording Playerの録画プロパティダイアログボックスから、セッション録画のファイルIDとアーカイブ時間を管理者に提供してください。アーカイブされたファイルの復元については、以下の「セッション録画ファイルを復元する」セクションで詳しく説明します。
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ユーティリティを使用して必要なセッションレコーディングファイルをSession Recording Databaseにインポートします。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ユーティリティを使用してアーカイブ済みセッションレコーディングファイルをインポートすると、セッションレコーディングファイルからのセッションレコーディング情報（セッションレコーディングファイルの新しい保存パスを含む）でSession Recording Databaseが更新されます。ICLDBユーティリティを使用してアーカイブ済みセッションレコーディングファイルをインポートしても、セッションが記録されたときの元の保存場所にはファイルは戻されません。
注： インポートされたセッションレコーディングファイルは、Session Recording Databaseでアーカイブ時間とアーカイブメモがクリアされます。そのため、次回ICLDB archive コマンドが実行されると、インポートされたセッションレコーディングファイルが再度アーカイブされる可能性があります。
ICLDB import コマンドは、多数のアーカイブ済みセッションレコーディングファイルをインポートしたり、Session Recording Database内の誤ったセッションレコーディングデータや欠落しているセッションレコーディングデータを修復または更新したり、セッションレコーディングファイルをSession Recording Server上のある保存場所から別の保存場所に移動したりするのに役立ちます。ICLDB import コマンドは、ICLDB removeall コマンドの実行後にSession Recording Databaseにセッションレコーディングを再入力するためにも使用できます。
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」を入力します。
-