管理您的数据库记录
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 命令在没有提示的情况下运行。此参数是可选的。
在会话录制数据库中归档会话录制内容，并对会话录制文件进行物理性移动
-
以本地管理员身份登录到安装了会话录制服务器的服务器。
-
启动命令提示符。
-
将当前工作目录更改为会话录制服务器安装路径的 Bin 目录 (
<Session Recording Server Installation Path>/Server/Bin)。 -
运行
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /L命令，其中 days 是会话录制文件的保留期，directory 是存档的会话录制文件移动到的目录，note 是添加到每个正在存档的会话录制文件的数据库记录中的文本备注。输入 Y 确认存档。
仅将会话录制存档到会话录制数据库中
-
以本地管理员身份登录到安装了会话录制服务器的服务器。
-
启动命令提示符。
-
Change from the current working directory to the Bin directory of the Session Recording Server installation path (<Session Recording Server Installation Path>/Server/Bin).
-
运行
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /L命令，其中 days 是会话录制的保留期，note 是添加到每个正在存档的会话录制的数据库记录中的文本备注。输入 Y 确认存档。
还原会话录制文件
当您想要查看一个会话录制时，如果该录制已存档在会话录制数据库中，并且其文件已从录制存储位置移出，则需要还原会话录制文件。对于在存档过程中未从录制存储位置移出的已存档会话录制，它们仍然可以在会话录制播放器中进行访问。
有两种方法可用于还原已移动的会话录制文件。将所需的会话录制文件复制到存档文件的还原目录，或者使用 ICLDB 实用程序将所需的会话录制文件重新导入到会话录制数据库。Citrix® 建议使用第一种方法还原存档的会话录制文件。当您不再需要存档文件时，请删除复制到存档文件还原目录中的文件。
当会话录制文件在其原始存储位置中找不到时，会话录制代理会利用存档文件的还原目录。这种情况发生在会话录制播放器请求会话录制文件进行播放时。会话录制代理首先尝试在原始存储位置中查找会话录制文件。如果在原始存储位置中找不到该文件，会话录制代理会检查存档文件的还原目录。如果文件存在于还原目录中，会话录制代理会将文件发送到会话录制播放器进行播放。否则，如果找不到文件，会话录制代理会向会话录制播放器发送文件未找到错误。
使用 ICLDB 实用程序导入存档的会话录制文件会将会话录制文件中的会话录制信息更新到会话录制数据库中，包括会话录制文件的新存储路径。使用 ICLDB 实用程序导入存档的会话录制文件不会在会话录制时将文件移回原始存储位置。
注意： 导入的会话录制文件在会话录制数据库中已清除存档时间和存档备注。因此，下次运行 ICLDB archive 命令时，导入的会话录制文件可能会再次被存档。
ICLDB import 命令可用于导入大量存档的会话录制文件、修复或更新会话录制数据库中不正确和缺失的会话录制数据，或者将会话录制文件从会话录制服务器上的一个存储位置移动到另一个存储位置。运行 ICLDB removeall 命令后，ICLDB import 命令还可以用于使用会话录制重新填充会话录制数据库。
ICLDB 实用程序的 import 命令有以下几个参数：
-
/LISTFILES – 列出会话录制文件导入时的完整路径和文件名。此参数是可选的。
-
/RECURSIVE – 搜索所有子目录中的会话录制文件。此参数是可选的。
-
/L – 将结果、错误以及导入的会话录制文件数量记录到 Windows 事件日志中。此参数是可选的。
-
/F – 强制导入命令在没有提示的情况下运行。此参数是可选的。
如何使用存档文件的还原目录来还原会话录制文件
-
以本地管理员身份登录安装了 Session Recording Server 的服务器。
-
在 Session Recording Player 属性中，确定存档会话录制文件的文件 ID 和存档时间。
-
使用 Session Recording Player Properties 中指定的 File ID 在备份中找到会话录制文件。每个会话录制的文件名为
i_<FileID>.icl，其中 FileID 是会话录制文件的 ID。 -
将您的备份中的会话录制文件复制到存档文件的还原目录。要确定存档文件的还原目录，请执行以下操作：
-
从“开始”菜单中，选择“开始”>“所有程序”>“Citrix”>“会话录制服务器属性”。
-
在 Session Recording Server Properties 中，选择“存储”选项卡。当前还原目录显示在“存档文件的还原目录”字段中。
-
使用 ICLDB import 命令还原会话录制文件
-
以本地管理员身份登录安装了 Session Recording Server 的服务器。
-
启动命令提示符。
-
将当前工作目录更改为会话录制服务器安装路径的 Bin 目录 (
<Session Recording Server Installation Path>/Server/Bin)。 -
以下任一操作：
-
运行
ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory>命令，其中 directory 是一个或多个目录的名称，这些目录之间用空格分隔，并包含会话录制文件。输入 Y 确认导入。 -
运行
ICLDB IMPORT /LISTFILES /L <file>命令，其中 file 是一个或多个会话录制文件的名称，这些文件之间用空格分隔。可以使用通配符指定会话录制文件。输入 Y 确认导入。
-