管理您的数据库记录

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 将会话录制文件导入到会话录制数据库。如果数据库记录丢失,请使用此命令重建数据库。此外,使用此命令合并数据库(如果您有两个数据库,可以从其中一个数据库导入文件)。
locate 根据文件 ID 查找并显示会话录制文件的完整路径。当您查找会话录制文件的存储位置时,请使用此命令。这也是验证数据库是否与特定文件保持同步的一种方法。
remove 从数据库中删除会话录制文件的引用。使用此命令(请谨慎)清理数据库。指定要用作条件的保留期。您还可以删除关联的物理文件。
removeall 从会话录制数据库中删除所有会话录制文件的引用,并将数据库恢复到其原始状态。实际的物理文件不会被删除;但是,您无法在会话录制播放器中搜索这些文件。使用此命令(请谨慎)清理数据库。只有通过从备份还原才能恢复已删除的引用。
version 显示会话录制数据库架构版本。
/l 将结果和错误记录到 Windows 事件日志。
/f 强制命令在没有提示的情况下运行。
/s 抑制版权信息的显示。
/? 显示命令的帮助信息。

归档会话录制文件

为了在录制存储位置保持足够的备用磁盘容量,请定期归档会话录制文件。根据可用的磁盘空间量以及会话录制文件的典型大小,归档间隔会有所不同。会话录制文件必须从其开始日期算起,超过两天后才能进行归档。此规则旨在防止任何正在进行的录制在完成之前被归档。

归档会话录制时有两种方法可用。可以将会话录制文件的数据库记录更新为归档状态,同时会话录制文件保留在录制存储位置。此方法可用于减少播放器中的搜索结果。另一种方法是将会话录制文件的数据库记录更新为归档状态,并将会话录制文件从录制存储位置移动到另一个位置,以备份到备用介质。当 ICLDB 实用程序移动会话录制文件时,文件将移动到指定的目录,其中原始的年/月/日文件文件夹结构不再存在。

会话录制数据库中的会话录制记录包含与归档相关的两个字段:归档时间,表示会话录制被归档时的当前日期和时间;归档备注,管理员在归档期间可能添加的可选文本备注。这两个字段指示会话录制已归档以及归档时间。

在会话录制播放器中,任何已归档的会话录制都显示为“已归档”状态以及归档日期和时间。如果文件未被移动,则仍可播放已归档的会话录制。如果在归档期间移动了会话录制文件,则会显示“文件未找到”错误。会话录制文件必须在会话可以播放之前恢复。要恢复会话录制,请向管理员提供会话录制播放器中录制属性对话框中的会话录制文件 ID 和归档时间。有关恢复已归档文件的更多信息,请参阅以下恢复会话录制文件部分。

ICLDB 实用程序的 archive 命令有几个参数,描述如下:

  • /RETENTION:<days> - 会话录制的保留期(天)。早于指定天数的录制在会话录制数据库中标记为已归档。保留期必须是大于或等于 2 天的整数。

  • /LISTFILES – 列出正在归档的会话录制文件的完整路径和文件名。此参数是可选的。

  • /MOVETO:<directory> - 您实际移动归档会话录制文件的目录。指定的目录必须存在。此参数是可选的。如果未指定目录,文件将保留在其原始存储位置。

  • /NOTE:<note> - 添加到每个已归档会话录制数据库记录的文本备注。确保备注用双引号括起来。此参数是可选的。

  • /L – 将已归档的会话录制文件数量的结果和错误记录到 Windows 事件日志中。此参数是可选的。

  • /F – 强制 archive 命令在没有提示的情况下运行。此参数是可选的。

如何在会话录制数据库中归档会话录制并物理移动会话录制文件

  1. 以本地管理员身份登录到安装了会话录制服务器的服务器。

  2. 启动命令提示符。

  3. 将当前工作目录更改为会话录制服务器安装路径的 Bin 目录 (<Session Recording Server Installation Path>/Server/Bin)。

  4. 运行 ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /L 命令,其中 days 是会话录制文件的保留期,directory 是存档的会话录制文件移动到的目录,note 是添加到每个正在存档的会话录制文件的数据库记录中的文本备注。输入 Y 确认存档。

仅在 Session Recording 数据库中存档会话录制

  1. 以本地管理员身份登录到安装了 Session Recording Server 的服务器。

  2. 启动命令提示符。

  3. 将当前工作目录更改为会话录制服务器安装路径的 Bin 目录 (<会话录制服务器安装路径\>\/Server/Bin)。

  4. 运行 ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /L 命令,其中 days 是会话录制的保留期,note 是添加到每个正在存档的会话录制的数据库记录中的文本备注。输入 Y 确认存档。

还原会话录制文件

当您想要查看在 Session Recording 数据库中存档且文件已从录制存储位置移出的会话录制时,需要还原会话录制文件。在存档期间未从录制存储位置移出的存档会话录制仍可在 Session Recording Player 中访问。

有两种方法可用于还原已移动的会话录制文件。将所需的会话录制文件复制到存档文件的还原目录,或者使用 ICLDB 实用程序将会话录制文件重新导入到 Session Recording 数据库。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 数据库。使用 ICLDB 实用程序导入存档的会话录制文件不会在会话录制时将文件移回原始存储位置。

注意:导入的会话录制文件在 Session Recording 数据库中已清除存档时间和存档备注。因此,下次运行 ICLDB archive 命令时,导入的会话录制文件可能会再次存档。

ICLDB import 命令可用于导入大量存档的会话录制文件、修复或更新 Session Recording 数据库中不正确和缺失的会话录制数据,或者将会话录制文件从 Session Recording Server 上的一个存储位置移动到另一个存储位置。运行 ICLDB removeall 命令后,ICLDB import 命令还可用于使用会话录制重新填充 Session Recording 数据库。

ICLDB 实用程序的 import 命令有以下几个参数:

  • /LISTFILES – 在导入会话录制文件时,列出其完整路径和文件名。此参数是可选的。

  • /RECURSIVE – 搜索所有子目录以查找会话录制文件。此参数是可选的。

  • /L – 将导入的会话录制文件数量的结果和错误记录到 Windows 事件日志中。此参数是可选的。

  • /F – 强制导入命令在没有提示的情况下运行。此参数是可选的。

通过使用存档文件的还原目录来还原会话录制文件

  1. 以本地管理员身份登录到安装了 Session Recording Server 的服务器。

  2. 在“会话录制播放器属性”中,确定存档的会话录制文件的文件 ID 和存档时间。

  3. 使用“会话录制播放器属性”中指定的文件 ID 在备份中找到会话录制文件。每个会话录制的文件名为 i_<FileID>.icl,其中 FileID 是会话录制文件的 ID。

  4. 将会话录制文件从您的备份复制到存档文件的还原目录。要确定存档文件的还原目录:

    1. 从“开始”菜单中,选择“开始”>“所有程序”>“Citrix”>“会话录制服务器属性”。

    2. 在“Session Recording Server Properties”中,选择“存储”选项卡。当前还原目录显示在“存档文件的还原目录”字段中。

使用 ICLDB import 命令还原会话录制文件

  1. 以本地管理员身份登录到安装了 Session Recording Server 的服务器。

  2. 启动命令提示符。

  3. 从当前工作目录切换到 会话录制服务器 安装路径的 Bin 目录 (<Session Recording Server Installation Path>/Server/Bin)。

  4. 或者:

    • 运行 ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory> 命令,其中 directory 是一个或多个目录的名称,这些目录之间用空格分隔,并包含会话录制文件。输入 Y 以确认导入。

    • 运行 ICLDB IMPORT /LISTFILES /L <file> 命令,其中 file 是一个或多个会话录制文件的名称,这些文件之间用空格分隔。可以使用通配符来指定会话录制文件。输入 Y 以确认导入。

管理您的数据库记录