管理您的数据库记录

ICA 日志数据库 (ICLDB) 实用程序是用于管理 Session Recording 数据库记录的数据库命令行实用程序。此实用程序在 Session Recording 安装期间安装在托管 Session Recording Server 软件的服务器上的 <驱动器>:\Program Files\Citrix\SessionRecording\Server\Bin 目录中。驱动器>

快速参考表

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

icldb [version | locate | dormant | import | archive | remove | removeall] 命令选项 [/l] [/f] [/s] [/?]

注意:

与此实用程序关联的帮助中提供了更多详细说明。要访问帮助,请在命令提示窗口中键入 驱动器:\Program Files\Citrix\SessionRecording\Server\Bin 目录,然后键入 icldb /?。要访问特定命令的帮助,请键入 icldb 命令 /?

命令 说明
archive 存档超过指定的保留期限的会话录制文件。此命令用于存档文件。
dormant 显示或计数被视为休眠的会话录制文件。休眠文件是指由于数据丢失而未完成的会话录制。此命令用于在您怀疑有数据丢失时进行验证。可以检查是整个数据库的会话录制文件都进入休眠,还是只有指定天数、小时数或分钟数内创建的录制件进入休眠。
导入 将会话录制文件导入 Session Recording 数据库。此命令用于在丢失数据库录制时重建数据库。此外,此命令还用于合并数据库(如果您有两个数据库,则可以导入其中一个数据库中的文件)。
locate 将会话录制文件 ID 用作条件查找并显示该文件的完整路径。查找会话录制文件的存储位置时可使用此命令。此命令还可用于通过特定文件来验证数据库是否为最新。
删除 从数据库中删除对会话录制文件的引用。此命令用于清理数据库(使用时需谨慎)。指定要用作条件的保留期限。也可以删除关联的物理文件。
removeall 从 Session Recording 数据库中删除对会话录制文件的所有引用,并将数据库返回原始状态。不会删除实际物理文件;但您无法在 Session Recording Player 中搜索这些文件。此命令用于清理数据库(使用时需谨慎)。只能通过从备份中恢复来还原删除的引用。
version 显示 Session Recording 数据库架构版本。
/l 将结果和错误记录到 Windows 事件日志。
/f 强制运行命令而不提示。
/s 不显示版权信息。
/? 显示命令的帮助。

存档会话录制文件

要在录制件存储位置保留充足的备用磁盘容量,请定期存档会话录制文件。存档时间间隔因可用磁盘空间量和会话录制文件的典型大小而异。会话录制文件保留时间必须晚于开始录制日期超过两天才能进行存档。此规则是为了防止任何正在进行的录制还未完成即被存档。

可以采用两种方法来存档会话录制件。可以将会话录制文件的数据库记录更新为“已存档”状态,同时会话录制文件仍保留在录制件存储位置。使用此方法可以减少在 Player 中出现的搜索结果。另一种方法是将会话录制文件的数据库记录更新为“已存档”状态,同时还将会话录制文件从录制件存储位置移至另一个位置以便备份到备用介质。当 ICLDB 实用程序移动会话录制文件时,这些文件将被移至指定的目录,在此位置不再使用年/月/日形式的原始文件文件夹结构。

Session Recording 数据库中的会话录制件记录包含两个与存档关联的字段:存档时间(表示存档会话录制件时的当前日期和时间)和存档注释(管理员可以在存档时添加的可选文本注释)。这两个字段指示会话录制件已存档和存档时间。

在 Session Recording Player 中,任何存档的会话录制件都会显示“已存档”状态以及存档日期和时间。如果尚未移动已存档的会话录制件,则仍可以播放这些文件。如果在存档过程中移动了会话录制文件,则在要播放该文件时会显示“未找到文件”错误。此时,必须还原会话录制文件才能播放会话。要还原会话录制件,请根据 Session Recording Player 中的录制件“属性”对话框向管理员提供会话录制件的文件 ID 和存档时间。在下面的还原会话录制文件部分详细介绍了如何还原存档文件。

ICLDB 实用程序的 archive 命令具有多个参数,如下所述:

  • /RETENTION:<days> - 会话录制件的保留期限(天)。保留时间超过指定天数的录制件会在 Session Recording 数据库中被标记为“已存档”。保留期限必须是大于或等于 2 天的整数。

  • /LISTFILES - 列出存档会话录制文件时这些文件的完整路径和文件名。这是可选参数。

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

  • /NOTE:<note> - 在数据库记录中为存档的每个会话录制件添加的文本注释。注释两边务必加上双引号。这是可选参数。

  • /L - 将结果和错误记录到 Windows 事件日志,并记录存档的会话录制文件数。这是可选参数。

  • /F - 强制运行 archive 命令而不显示提示。这是可选参数。

在 Session Recording 数据库中存档会话录制件并以物理方式移动会话录制文件

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

  2. 启动命令提示窗口。

  3. 从当前工作目录转到 Session Recording Server 安装路径的 Bin 目录(<Session Recording Server 安装路径>/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. 从当前工作目录转到 Session Recording Server 安装路径的 Bin 目录(<Session Recording Server 安装路径>/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 命令,导入的会话录制文件可能会重新变为“已存档”。

如果要导入大量存档的会话录制文件、在 Session Recording 数据库中修复或更新错误和缺少的会话录制数据、或者将会话录制文件从 Session Recording Server 上的一个存储位置移至另一个存储位置,ICLDB import 命令很有用。ICLDB import 命令还可以用于在执行 ICLDB removeall 命令后在 Session Recording 数据库中重新填充会话录制件。

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 > Session Recording Server 属性

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

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

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

  2. 启动命令提示窗口。

  3. 从当前工作目录转到 Session Recording Server 安装路径的 Bin 目录(<Session Recording Server 安装路径>/Server/Bin)。

  4. 执行以下操作之一:

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

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

管理您的数据库记录