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 升级问题进行故障排除

使用以下步骤对 StoreFront 升级问题进行故障排除。

尝试升级之前

  1. 确认您有所有 StoreFront 服务器的备份。
  2. 确认您未尝试从生命周期已结束的 StoreFront 版本进行升级。有关详细信息,请参阅 CTX200356
  3. 验证您仅从受支持的 StoreFront 版本升级到当前版本。
  4. 如果 StoreFront 服务器是 StoreFront 服务器组的一部分,则必须按顺序升级组中的所有服务器。不支持同时升级 StoreFront 服务器组。
  5. 删除 C:\inetpup\wwwroot\citrix 或其子目录中的任何 thumbs.db 文件。显示隐藏的文件以完成此步骤:文件夹选项 > 查看,选择选项显示隐藏的文件、文件夹和驱动器,并清除选项隐藏受保护的操作系统文件(推荐)
  6. 在开始执行升级过程之前,请禁用防病毒软件。
  7. 确认正在升级的服务器已从任何负载平衡器中删除,并且没有连接的活动用户会话。
  8. 请在执行升级之前重新启动 StoreFront 服务器。
  9. 手动停止以下服务:
    • CitrixConfigurationReplication
    • CitrixCredentialWallet
    • CitrixDefaultDomainService
    • CitrixPeerResolutionService
    • CitrixSubscriptionsStore
  10. 确保 StoreFront 管理控制台已关闭。

如果升级失败

  1. C:\Windows\Temp\StoreFront 中,打开最新的 CitrixMsi.log*,并搜索任何异常错误。

    Thumbs.db 访问异常:由 C:\inetpup\wwwroot\citrix 或其子目录中的 thumbs.db 文件导致的。删除找到的任何 thumbs.db 文件。

    使用过程中无法获取独占文件访问权限异常:还原快照/备份(如果可用),或者重新启动服务器,并手动停止任何 StoreFront 服务。

    无法启动服务异常:还原快照/备份(如果可用),或者安装 .NET Framework 4.5 的完整版本(而非客户端配置文件)。

  2. 如果 CitrixMsi.log* 中没有异常错误,请检查服务器的事件查看器 > 交付服务是否存在包含上述异常错误消息的任何错误。按照相应的建议进行操作。
  3. 如果事件查看器中没有异常错误,请检查 C:\Program Files\Citrix\Receiver StoreFront\logs 中是否存在包含上述异常错误消息的任何错误。按照相应的建议进行操作。

手动删除 StoreFront

警告:

手动删除 StoreFront 会清除所有现有信息。

要手动删除 StoreFront,请执行以下操作:

  1. 卸载 StoreFront
  2. 删除 Web 服务器角色。
  3. 删除文件夹 C:\Program Files\Citrix\Receiver StoreFront
  4. 删除 C:\Program Files\Citrix\StoreFront Install 下的所有子目录。
  5. 删除文件夹 C:\Inetpub

您现在可以重新安装 StoreFront