データベースレコードを管理する
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がインストールされているサーバーにローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、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 Database内のセッション録画のみをアーカイブするには
-
Session Recording Serverがインストールされているサーバーにローカル管理者としてログオンします。
-
コマンドプロンプトを起動します。
-
現在の作業ディレクトリから、セッションレコーディングサーバーのインストールパスのBinディレクトリに移動します(<Session Recording Server Installation Path>/Server/Bin)。
-
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Lコマンドを実行します。ここで、daysはセッション録画の保持期間、noteはアーカイブされる各セッション録画のデータベースレコードに追加されるテキストメモです。アーカイブを確定するには「Y」と入力します。
セッション録画ファイルを復元する
Session Recording Databaseにアーカイブされ、録画保存場所から移動されたセッション録画を表示したい場合は、セッション録画ファイルの復元が必要です。アーカイブ中に録画保存場所から移動されなかったアーカイブ済みセッション録画は、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 Propertiesを選択します。
-
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」と入力します。
-