故障排除

安装问题

如何启用 AppDNA 详细日志记录

注意:有关 AppDNA 中所有类型的日志记录的更多信息,请参阅CTX219766

如果在安装 Citrix AppDNA 时遇到问题,这些步骤将向您展示如何在 AppDNA 服务器上启用详细安装日志文件的集合。

警告:注册表编辑不当可能会导致严重问题,可能需要您重新安装操作系统。Citrix 无法保证可以解决因注册表编辑器使用不当而导致的问题。使用注册表编辑器需自行承担风险。在编辑注册表之前,请务必备份注册表。

要在 AppDNA 服务器上启用详细日志记录,请完成以下过程:

  1. 打开 运行 对话框。
  2. 键入 注册表编辑器 并点击 确定
  3. 在“用户访问控制”对话框中,单击“ ”。
  4. 在注册表编辑器中,浏览到注册表项 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\AppDNA\appTitude\common\
  5. 查找或创建注册表设置 详细记 录 (REG_DWORD) 并将值更改为 1

当 AppDNA 检测到此注册表值已设置时,它会将详细日志写入 %temp%\AppDNAVerboseLog.log

请注意,对于服务器进程,这将是在 IIS 中运行 AppDNAAppPool 的标识的临时目录。默认情况下,这将是“ApplicationPoolIdentity”中的构建,临时目录将是 C:\windows\temp。

客户端和服务器进程分别捕获日志(除非它们以同一用户身份运行)。

使用文本编辑器来读取应用程序的日志文件的内容。

若要禁用详细日志记录,请将“详细日志记录”注册表值更改 为 0

类似的过程可以打开 Citrix AppDNA 服务, 队列处理器的详细日志记录。若要为队列处理器服务启用详细日志记录,请执行上述步骤 1-4。在步骤 5 中,查找或创建注册表 值队列处理程序日志记录。消息将写入 Windows 事件日志(而不是文件)中:

事件查看器 > 应用程序和服务日志 > AppDNA > 来源 = AppDNA 服务

登录问题

“请求失败,HTTP 状态 503:服务不可用”

此错误可能意味着 AppDNA 网站用于连接到 AppDNA 数据库的密码已过期或已更改。要更正此问题,请参阅网站

登录失败,显示“操作已超时”错误

有时会出现此错误是因为 AppDNA 服务之一或 AppDNA 依赖的其他服务未运行。

检查 IIS 服务

  1. 打开 IIS 管理器:在 Windows 开始屏幕或菜单上,选择程序 > 附件 > 运行,键入 inetmgr,然后单击确定。

  2. 检查 IIS 服务器是否正在运行,如果没有,请启动它。

    若要执行此操作,请在窗口右侧的“操作”面板中,在“管理服务器”下单击“开始”。如果服务器正在运行,则禁用“开始”链接。

  3. 如果 IIS 服务器正在运行,请检查 AppDNAAppPool 是否正在运行,如果未运行,请启动。

    若要执行此操作,展开 IIS 管理器窗口左侧的树,然后单击应用程序池。单击中间面板中的 AppDNAAppPool,然后单击右侧面板中的“启动”。如果 AppDNAAppPool 正在运行,请禁用“开始”链接。

  4. 如果 IIS 服务器和 AppDNAAppPool 正在运行,请检查 AppDNA 网站是否正在运行,如果未运行,请启动。

    若要执行此操作,在 IIS 管理器窗口左侧的树视图中展开站点节点,然后单击 AppDNA 网站(默认情况下,这称为 AppDNA)。然后单击右侧面板中的“开始”。如果 AppDNA 网站正在运行,则禁用“开始”链接。

如果您重新启动任何 IIS 服务,请尝试再次登录到 AppDNA。否则,请检查 SQL Server 实例服务是否正在运行,并在必要时启动它,如下所示:

  1. 打开 Windows 服务窗口(控制面板 > 管理工具 > 服务)。
  2. 在服务列表中,找到用于 AppDNA 数据库的 SQL Server 实例。
  3. 如果“状态”列为空,请单击“开始”以启动服务。如果此操作成功,请关闭 Windows 服务窗口。您现在应该可以登录到 AppDNA。

请求失败,HTTP 状态 407:需要代理身份验证

如果 Internet 资源管理器配置为为 LAN 使用代理服务器,则会发生此错误。您可以解决此问题,如下所示:

  1. 从“Internet 浏览器”中的菜单中,选择“工具”>“互联网选项”。
  2. 在 Internet 选项对话框中的连接选项卡上,单击 LAN 设置。
  3. 在“局域网 (LAN) 设置”对话框中的“代理服务器”下,选中“绕过本地地址的代理服务器”复选框。
  4. 点击 确定。

许可证问题

本节提供了帮助您解决许可问题的信息,包括那些导致 AppDNA 横幅变红的问题。发生这种情况时,请查看的“模块许可摘要”部分中的解释性消息控制板。这通常可以清楚地表明问题是由 AppDNA 无法联系 AppDNA 许可服务,还是由于数据库本身的实际许可问题引起的。以下是各个根本原因的信息,分别列于不同的标题。

您可以继续使用 AppDNA 解决许可问题和红色横幅。但是,功能非常有限-您可以导入应用程序,但大多数其他功能都被阻止。许可问题解决后,被阻止的功能将再次可用。

AppDNA 无法联系许可服务

如果 AppDNA 显示无法联系许可服务的消息,则可能意味着 AppDNA 许可证服务器未运行。你可以检查这一点,如有必要重新启动它,如下所示:

  1. 打开 Windows 服务窗口(控制面板 > 管理工具 > 服务)。
  2. 在服务列表中,找到 AppDNA 许可证服务器。
  3. 如果“状态”列为空,则表示服务尚未启动。单击开始启动服务。如果此操作成功,请关闭“服务”窗口。
  4. 重新启动 AppDNA。

移动 AppDNA 服务器或传输许可证后,数据库许可中断

当激活许可证时,AppDNA 许可证与运行 AppDNA 许可服务的数据库和计算机相关联。当数据库中的许可证与许可服务位置之间的链接中断时,可能会出现问题,例如,因为您已将 AppDNA 服务器从一台计算机移动到另一台计算机,或者您已开始但尚未完成转移许可证的两阶段过程。

  • 要使数据库与其他计算机上的许可服务一起使用,请将许可证从旧计算机上的 AppDNA 许可服务转移到新计算机。

  • 如果您已启动许可证转移过程(例如,导出许可证令牌但尚未将其导入带有新许可证服务器位置的数据库),请完成该过程。然后,数据库将再次可用。

有关详细信息,请参阅转让许可证

注意:通常,许可服务在与 AppDNA 服务器相同的计算机上运行。但是,如果您已从早期版本的 AppDNA 升级,则可能不是这种情况。

默认许可证服务器端口不可用

默认情况下,AppDNA 许可服务使用端口 8079。如果该端口不可用,请按如下方式进行更改。

  1. 关闭服务器上的 AppDNA 和所有连接的 AppDNA 客户端。

  2. 找到 AppDNA 许可服务文件。

    默认位置为 C:\Program Files[ (x86)]\Citrix\AppDNA\License Server。

  3. 在文本编辑器中打开远程 .config。

  4. 在下面的行中,将 8079 更改为不同的端口号,然后保存该文件。 <channel ref="tcp" port="8079" bindTo="0.0.0.0">

  5. 从“Windows 开始”屏幕或菜单中,选择“控制面板”>“管理工具”>“服务”。

  6. 在“Windows 服务”面板中,在服务列表中找到 AppDNA 授权服务,然后单击工具栏上的“开始”或“重新启动”以重新启动 AppDNA 授权服务。

导入和分析问题

“此交易已完成,无法再使用”

此错误消息可能在分析或任何类型的导入过程中发生。这通常是由于数据库没有足够的磁盘空间来扩展。

  1. 打开 Microsoft SQL Server Management Studio 并连接到托管 AppDNA 数据库的 SQL Server 实例。

  2. 检查 SQL Server 日志以确认是否存在磁盘空间不足是问题。

    若要执行此操作,请在左侧的树视图中打开管理 > SQL Server 日志文件夹。查看最近的日志并查找显示磁盘空间不足的文本。如果磁盘空间是问题,请按照以下步骤操作。

  3. 确保允许增长 AppDNA 数据库数据文件和日志文件。

    在左侧的树视图中,打开“数据库”文件夹。然后右键单击 AppDNA 数据库,然后从快捷菜单中选择属性。这将打开“数据库属性”对话框。单击侧栏中的“文件”,并确保数据文件和日志文件都配置为以小块增长(例如 10%),并且没有设置最大大小。

  4. 将数据库恢复模型设置为简单。

    在“数据库属性”对话框中,单击侧栏中的“选项”,并确保恢复模型设置为“简单”。

  5. 检查可用磁盘空间,如有必要,通过清理不需要的数据或升级硬件来增加可用磁盘空间。

导入 App-V 软件包(.sft 或 .appv)失败

当您导入 .sft 或 .appv 包时,AppDNA 会自动将其内容解压到中间文件夹中,保留原始目录结构。如果生成的文件路径中的字符总数超过 Windows 限制(通常为 256 个字符),则此操作将失败。发生这种情况时,导入日志文件包含文本:Create_deep_dir。

默认情况下,AppDNA 将 .sft 和 .appv 文件解压到中指定的临时文件夹中文件设置。但是,您可以在中的 SFT 中间文件夹框中为 .sft 和 .appv 文件指定单独的中间文件夹导入和分析设置

若要解决此问题,请设置 SFT 中间文件夹的非常短的文件路径。AppDNA 不会自动清除此文件夹。如有必要,您可以在导入完成后手动删除解压缩的文件。

导入成功,但我的申请不包含预期的 DNA

如果安装失败,但安装程序不遵循成功返回零和失败时返回非零值的惯例,则通过安装捕获或自行预配导入的应用程序偶尔会发生这种情况。当这种情况发生时,默认情况下 AppDNA 假定捕获成功,导入捕获的 DNA,并标记导入成功 — 尽管事实上根本没有捕获真正的应用 DNA。在这种情况下,捕获的 DNA 包括失败的尝试安装到底层操作系统的应用程序的任何小的更改。

如果您使用自动点击器运行捕获,则安装可能失败,因为它正在等待用户输入。因此,在没有自动点击器的情况下再次运行捕获。这可能会使安装,从而成功完成捕获。

或者,如果您知道安装程序不遵循成功时返回零退出代码的惯例,则可以在该应用程序的执行配置文件中指定成功退出代码。有关如何执行此操编辑执行配置文件作的信息,请参阅。

操作系统映像导入失败,错误 404:找不到文件

当操作系统映像的导入失败并显示“404:未找到文件”错误时,通常意味着 IIS 中超出了对最大内容长度大小的限制。要增加允许的最大内容长度,请参阅中的“优化 IIS”下的说明优化 AppDNA

报告问题

报告视图显示速度非常慢

当每页的记录数无意中被设置为一个非常大的值时,有时会出现此问题。如果页面速度太慢,无法使用,请远离报告视图并更改每页的记录数,如下所示。

  1. 从 AppDNA 的编辑菜单中,选择设置。
  2. 在“设置”对话框的侧栏中,单击“报告”。
  3. 在“每页记录”框中,输入较低的值(例如,200)。
  4. 单击保存。

要更改 Web 客户端中每页的记录数:

  • 将以下内容附加到报告视图的 URL 中: &FRMKEY_PAGE_SIZE=n

其中 n 是所需的默认页面大小,如以下示例所示。为了清楚起见,此 URL 显示在多行上。实际上,URL 必须作为一个完整的字符串输入。

http://appdna-machine:8199/appdna/Reporting/AssessmentReport.aspx? FRMKEY_TOKEN=1dd82045-b9a3-4840-af46-75e112bfcbb0 &FRMKEY_MODULE_ID=Win8Module &FRMKEY_CUSTOMISATION=&FRMKEY_POSTIMAGE=-2147483637 &FRMKEY_PREIMAGE=-2147483647&FRMKEY_RESOLUTION=app_group_summary &FRMKEY_PAGE_SIZE=5

图像无法在报告视图中显示

在 Windows 8 上安装 AppDNA 后首次查看报告时,会遇到此问题。问题是由互联网信息服务 (IIS) 配置不完整引起的。

要解决此问题,请执行以下操作:

  1. 关闭 AppDNA 并停止 AppDNA 客户端。
  2. 在 AppDNA 服务器计算机上,请确保启用了所有必需的 IIS 功能。有关详细信息,请参阅AppDNA 7.6 的系统要求
  3. 使用 iisreset 命令重置 IIS。

工作量计算器是不可读的

当控制面板中的“更容易阅读屏幕上的内容”显示选项用于增加屏幕上的文本和其他项目的大小,例如,125% 时,主工作量计算器屏幕不可读。默认情况下,在 Windows 8 上,此选项有时处于启用状态。

使用此选项时,工作量计算器会增加文本的大小。这会导致文本被截断或运行在其他项目上,使其无法读取。其他一些报告也受到类似的影响。

解决方案是将显示大小重置为“控制面板”>“显示”中的 100% 设置。

PDF 导出失败

如果您尝试在安装 Adobe Reader 之后但在实际运行 Adobe Reader 或打开 PDF 文件之前执行 PDF 导出,则 PDF 导出失败并显示错误(“禁用 UAC 时无法激活此应用程序”)。这是因为在您接受 Adobe 阅读器许可协议之前,AppDNA PDF 导出不起作用。

若要解决此问题,请在运行 AppDNA 的计算机上打开 PDF 文件,然后接受 Adobe Reader 许可协议。

PDF 导出的“报告数据”部分中的列重叠

当报告具有大量算法组时,PDF 导出的“报告数据”部分中的列可能会重叠并变得无法读取。若要解决此问题,请清除在 PDF 导出中显示计数复选框报告设置,然后再次运行 PDF 导出。