已知的安装和升级问题

安装或升级到 Analytics Exchange 15.1.1 时存在几个已知问题。如果其中任一问题适用于您的组织,请按照以下说明进行操作,以确保成功安装或升级。

连接到 PostgreSQL 数据库

如果现有 Analytics Exchange 安装使用 PostgreSQL 数据库,则升级到 AX 服务器 15.1.1 时可能会遇到问题。AX 服务器安装程序在尝试连接到现有 PostgreSQL 数据库时偶尔会超时。

如果在配置 Analytics Exchange PostgreSQL 数据库服务器屏幕中单击下一步后安装程序挂起,请取消操作,然后重新启动该安装。这种变通方法通常可以解决该问题。

单点登录 (SSO)

在升级到 AX 服务器 15.1.1 的过程中,aclCas.properties 文件会损坏,单点登录在 AX 15.1.1 中停止工作。该文件存储 Analytics Exchange 认证的设置。

要避免此问题,请在开始升级之前复制aclCas.properties,并使用它覆盖损坏的文件。

说明

在该文件的损坏版本中,属性以 axaxcas 而不是 axcas 开头。

  1. 在安装 AX 服务器的服务器上,复制 aclCas.properties 文件并将其保存在 ..\ACL\App 目录之外。

    该文件的默认位置是:

    C:\ACL\App\Tomcat\conf\aclCas.properties

  2. 执行 AX 服务器升级。

  3. 使用已保存的 aclCas.properties 版本覆盖该文件的损坏版本。

  4. 在 Windows 服务中,重新启动 ACL Analytics Exchange 服务

    单点登录现在应该可以在 Analytics Exchange 15.1.1 中正常工作。

AX 引擎节点安装或升级

AX 引擎节点在安装或升级后可能无法正确工作。请按照以下步骤确保安装成功,或者排除升级故障。

AX 引擎节点全新安装

  1. 按常规方式安装 AX 引擎节点。

  2. 在 AX 服务器配置 Web 应用程序中添加该引擎节点之前,请确保 AX 引擎节点正在安装它的服务器上运行。

    在 Windows 服务中,确保 ACL Analytics Exchange 服务的状态为正在运行。如有必要,启动该服务。

  3. 在 AX 服务器配置 Web 应用程序中,添加该引擎节点,然后单击更新引擎节点设置

AX 引擎节点升级

如果 AX 引擎节点在升级后停止工作,并且在运行分析脚本时返回错误,请执行以下故障排除程序:

  1. 在 AX 服务器配置 Web 应用程序中,移除该引擎节点。

  2. 确保 AX 引擎节点正在安装它的服务器上运行。

    在 Windows 服务中,确保 ACL Analytics Exchange 服务的状态为正在运行。如有必要,启动该服务。

  3. 在 AX 服务器配置 Web 应用程序中,重新添加该引擎节点,然后单击更新引擎节点设置

AX 引擎节点排除项被重新安装

Python 引擎和可选的数据连接器在您将 AX 引擎节点从版本 14.x 升级到版本 15.1.1 时被安装。即使您之前在运行修补程序将引擎节点的 Analytics 引擎升级到 15.0 版时选择排除其中一个或两个项,这些项也会被安装。(有关详细信息,请参见将 AX 服务器分析引擎更新至版本 15.0.0。)

如果您不希望 Python 引擎或可选的数据连接器存在于 AX 引擎节点安装中,则可以手动移除它们。

移除 Python 引擎

升级 AX 引擎节点后,请在安装引擎节点的每个服务器上,删除 pyengine 文件夹。

默认位置:

C:\ACL\App\analytic_engine\pyengine

移除可选的数据连接器

升级 AX 引擎节点后,请在安装引擎节点的每个服务器上,删除所列出的项。

注意

请小心选择要删除的正确文件夹。

  1. 在安装引擎节点的每个服务器上,导航到 ACL 连接器父目录。

    默认父目录位置:C:\ACL\ACL Connector

  2. 删除以下常见项:

    • \Common 文件夹

    • cacerts.pem 文件

  3. 删除以下连接器文件夹:

    • \ACLAmazonRedshift

    • \ACLCassandra

    • \ACLConcur

    • \ACLCouchbase

    • \ACLDrill

    • \ACLDynamoDB

    • \ACLGoogleBigQuery

    • \ACLHBase

    • \ACLHive

    • \ACLImpala

    • \ACLMongoDB

    • \ACLOracle

    • \ACLSalesForce

    • \ACLSpark

    • \ACLSQLServer

    • \ACLTeradata