管理数据库记录

ICA 日志数据库 (ICLDB) 实用程序是一个数据库命令行实用程序,用于操作会话录制数据库记录。此实用程序在会话录制安装期间安装在托管会话录制服务器软件的服务器上的 drive:\Program Files\Citrix\SessionRecording\Server\Bin 目录中。

快速参考图表

下表列出了 ICLDB 实用程序可用的命令和选项。使用以下格式键入命令:

icldb [版本 | 定位 | 休眠 | 导入 | 存档 | 移除 | 移除所有] 命令选项 [/l] [/f] [/s] [/?]

注意:

有关该实用程序的更多详细说明可在其帮助中找到。要访问帮助,请在命令提示符下,键入 drive:\Program Files\Citrix\SessionRecording\Server\Bin 目录,然后键入 icldb /?。要访问特定命令的帮助,请键入 icldb command /?

命令 详细说明
归档 归档超过指定保留期的会话录制文件。使用此命令进行文件归档。
休眠 显示或计数被视为休眠的会话录制文件。休眠文件是由于数据丢失而未完成的会话录制。如果您怀疑数据丢失,请使用此命令进行验证。您可以检查整个数据库的会话录制文件是否正在变为休眠状态,或者仅检查在指定天数、小时数或分钟数内进行的录制。
导入 将会话录制文件导入到会话录制数据库。如果数据库记录丢失,请使用此命令重建数据库。此外,使用此命令合并数据库(如果您有两个数据库,可以从其中一个数据库导入文件)。
定位 使用文件 ID 作为条件,定位并显示会话录制文件的完整路径。当您查找会话录制文件的存储位置时,请使用此命令。这也是验证数据库是否与特定文件保持同步的一种方法。
移除 从数据库中移除对会话录制文件的引用。使用此命令(请谨慎操作)清理数据库。指定要用作条件的保留期。您还可以移除关联的物理文件。
全部移除 从会话录制数据库中移除所有对会话录制文件的引用,并将数据库恢复到其原始状态。实际的物理文件不会被删除;但是,您无法在会话录制播放器中搜索这些文件。使用此命令(请谨慎操作)清理数据库。已删除的引用只能通过从备份还原才能恢复。
版本 显示会话录制数据库架构版本。
/l 将结果和错误记录到 Windows 事件日志中。
/f 强制命令在没有提示的情况下运行。
/s 禁止显示版权消息。
/? 显示命令的帮助。

存档会话录制文件

为了在录制存储位置保持充足的备用磁盘容量,请务必定期归档会话录制文件。归档间隔会根据可用的磁盘空间总量以及会话录制文件的平均大小而有所不同。会话录制文件必须在其开始日期之后超过两天,方可进行归档操作。制定此规则的目的是为了防止任何正在进行的实时录制在尚未完全完成之前就被错误地归档。

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

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

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

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

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

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

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

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

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

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

在会话录制数据库中对会话录制进行存档,并物理移动会话录制文件

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

  2. 启动命令提示符。

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

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

仅将会话录制存档到会话录制数据库中

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

  2. 启动命令提示符。

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

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

还原会话录制文件

当您希望查看某个已存档在会话录制数据库中且其文件已从录制存储位置移出的会话录制时,需要对会话录制文件进行还原操作。在存档期间未从录制存储位置移出的已存档会话录制,仍然可以通过会话录制播放器进行访问。

有两种方法可用于还原已移动的会话录制文件。将所需的会话录制文件复制到存档文件的还原目录,或者使用 ICLDB 实用程序将所需的会话录制文件重新导入到会话录制数据库。Citrix® 建议使用第一种方法还原已存档的会话录制文件。当您不再需要已复制到存档文件还原目录的存档文件时,请将其删除。

当会话录制文件在其原始存储位置中找不到时,会话录制代理会利用存档文件的还原目录。这种情况发生在会话录制播放器请求会话录制文件进行播放时。会话录制代理首先尝试在原始存储位置中查找会话录制文件。如果在原始存储位置中找不到该文件,会话录制代理会检查存档文件的还原目录。如果文件存在于还原目录中,会话录制代理会将文件发送到会话录制播放器进行播放。否则,如果找不到文件,会话录制代理会向会话录制播放器发送文件未找到错误。

使用 ICLDB 实用程序导入已存档的会话录制文件会将会话录制文件中的会话录制信息(包括会话录制文件的新存储路径)更新到会话录制数据库中。使用 ICLDB 实用程序导入已存档的会话录制文件不会在会话录制时将文件移回原始存储位置。

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

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

ICLDB 实用程序的 import 命令有几个参数,具体说明如下:

  • /LISTFILES – 列出正在导入的会话录制文件的完整路径和文件名。这是一个可选参数。

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

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

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

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

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

  2. 在 Session Recording Player 属性中,确定存档的会话录制文件的文件 ID 和存档时间。

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

  4. 将会话录制文件从备份复制到存档文件的还原目录。要确定存档文件的还原目录,请执行以下操作:

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

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

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

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

  2. 启动命令提示符。

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

  4. 或者:

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

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

管理数据库记录