StoreFront 故障排除

注意:

单击新增功能了解与产品名变更有关的信息。

安装或卸载 StoreFront 时,StoreFront 安装程序将在 C:\Windows\Temp\StoreFront 目录中创建以下日志文件。文件名称中包含时间戳,并将反映创建这些文件的组件。

  • Citrix-DeliveryServicesRoleManager-*.log — 交互式安装 StoreFront 时创建。
  • Citrix-DeliveryServicesSetupConsole-*.log — 无提示安装 StoreFront 及卸载 StoreFront(交互式或无提示)时创建。
  • CitrixMsi-CitrixStoreFront-x64-*.log — 安装和卸载 StoreFront(交互式或无提示)时创建。

StoreFront 支持对身份验证服务、应用商店和 Receiver for Web 站点进行 Windows 事件日志记录。生成的所有事件都将写入到 StoreFront 应用程序日志中,可以通过应用程序和服务日志 > Citrix 交付服务Windows 日志 > 应用程序下的事件查看器查看这些事件。可以通过编辑身份验证服务、应用商店和 Receiver for Web 站点的配置文件,控制单个事件的重复日志条目数。

Citrix StoreFront 管理控制台将自动记录跟踪信息。默认情况下,对其他操作的跟踪功能处于禁用状态,必须手动启用。Windows PowerShell 命令创建的日志存储在 StoreFront 安装的 \Admin\logs\ 目录中,通常位于 C:\Program Files\Citrix\Receiver StoreFront。日志文件名称中包含命令操作和主题以及可用于区分命令顺序的时间戳。

重要:

在多服务器部署中,请一次仅使用一台服务器以更改服务器组的配置。确保 Citrix StoreFront 管理控制台未在部署中的任何其他服务器上运行。完成后, 请将对配置所做的更改传播到服务器组,以便更新部署中的其他服务器。

配置日志限制

  1. 使用文本编辑器打开身份验证服务、应用商店或 Receiver for Web 站点的 web.config 文件,通常情况下,该文件分别位于 C:\inetpub\wwwroot\Citrix\Authentication、C:\inetpub\wwwroot\Citrix\storename 和 C:\inetpub\wwwroot\Citrix\storenameWeb\ 目录中,其中 storename 为创建应用商店时为其指定的名称。

  2. 在此文件中查找以下元素。

    <logger duplicateInterval="00:01:00" duplicateLimit="10">

    在 StoreFront 的配置中,重复日志条目数默认限制为每分钟 10 条。

  3. 更改 duplicateInterval 属性的值,以小时、分钟和秒为单位设置监视重复日志条目的时间段。使用 duplicateLimit 属性设置必须在指定时间间隔内记录的重复条目数,以便触发日志限制。

触发日志限制后,将记录一条警告消息,指出将禁止显示后续相同的日志条目。限制时段结束后将恢复常规日志记录,此时将记录一条信息性消息,指出将不再禁止显示重复的日志条目。

对调试启用跟踪

重要:

StoreFront 和 PowerShell 控制台不能同时打开。使用 PowerShell 控制台管理 StoreFront 配置之前,请始终关闭 StoreFront 管理控制台。同样,打开 StoreFront 控制台之前,请关闭 PowerShell 控制台的所有实例。

将跟踪输出发送到 c:\Program Files\Citrix\Receiver StoreFront\admin\trace

跟踪输出

注意:

运行 Get-Help Set-STFDiagnostics -detailed 以获取 Powershell 帮助以及有关如何使用 Set-STFDiagnostics cmdlet 的说明。

使用具有本地管理员权限的帐户启动 Windows PowerShell,然后在命令提示窗口中指定以下必需参数以启用或禁用跟踪。

  • -All。指示应更新所有实例和服务的跟踪的标志。
  • -TraceLevel。要增加跟踪详细信息的级别,允许 -TraceLevel 使用以下值:Off、Error、Warning、Info 或 Verbose。由于可能生成大量的数据,因此跟踪可能会显著影响 StoreFront 的性能。除非进行故障排除时明确需要,否则,不建议使用 Info 或 Verbose 级别。

可选参数:

  • -FileSizeKb。跟踪文件的大小以 KB 为单位。
  • -FileCount。在磁盘中一次维护的跟踪文件数。
  • -confirm:$False。禁止弹出 Windows 提示以允许 StoreFront cmdlet 每次都能运行。

示例

要出于调试目的为所有服务启用 Verbose 级别的跟踪,请执行以下操作:

Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False

要禁用 Verbose 级别的跟踪并将跟踪级别设置回所有服务的默认值,请执行以下操作:

Set-STFDiagnostics -All -TraceLevel "Error" -confirm:$False

有关设置 Set-STFDiagnostics cmdlet 的详细信息,请参阅 StoreFront PowerShell SDK 文档。

启用 launch.ica 文件的日志记录

将信息保存在客户端计算机的 launch.ica 文件中,以对多个问题进行故障排除。launch.ica 文件由 Citrix Web Interface 或 Citrix StoreFront 服务器生成。

要启用 launch.ica 文件的日志记录,请完成以下步骤:

  1. 使用注册表编辑器导航到以下注册表项:

    32 位系统:HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging

    64 位系统:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging

  2. 设置以下字符串值:

    LogFile=<日志文件的路径,使用以下格式 C:\ica\ica.log> LogICAFile=true

其他资源

注意:

CTX200126 中进一步概述了如何在您的环境中将 ICA 文件用于除故障排除用途之外的任何其他目的。

上一步

StoreFront 故障排除