升级 Hub 和 Interact

点击工具栏上的 图标可查看和下载本指南的 PDF 版本。

Hub 和 Interact 的升级流程非常简单,需要使用专用工具。您需要从您当前使用的版本开始按照以下顺序运行升级工具:

完成升级后,建议用户登录 Hub 并按 CTRL + F5 来清除缓存。这将刷新所有网页,并且确保所有用户界面更改均已更新。

将 Hub 和 Interact 4.0 升级到版本 4.1

建议您安排在工作时间之外进行升级。

先决条件

  • 已安装 Hub 和 Interact 版本 4.0。
  • 每个人都需退出 IMS Server。

  • 备份所有相关数据库。虽然数据库不受升级的影响,但建议在执行任何升级之前备份数据库。

升级程序会在升级过程中自动停止任何正在运行的网站。您无需手动停止网站。

升级步骤

  1. 请从 Blue Prism 门户网站下载适用于版本 4.0 到 4.1 的 Blue Prism Interact 与 Hub 升级程序。
  2. 运行升级程序并按照说明执行操作。
  3. 升级程序完成运行后,登录 Hub 并打开插件管理库。

    该管理库将显示准备更新的插件以及当前安装和可用版本的详细信息。

  4. 选中全部复选框,然后点击完成更新

    此时会安装选定插件的新版本,并完成版本 4.1 升级。

  5. 在所有安装 Hub 的计算机上重复此流程。

将 Hub 和 Interact 4.1 升级到版本 4.2

建议您安排在工作时间之外进行升级。

先决条件

  • 已安装 Hub 和 Interact 版本 4.1。
  • 每个人都需退出 IMS Server。

  • 备份所有相关数据库。虽然数据库不受升级的影响,但建议在执行任何升级之前备份数据库。

  • 为 License Manager 和 Notification Center 创建了 DNS 记录,以便在此升级期间使用。单机环境无需满足此先决条件。
  • 新网站的 SSL 证书;License Manager 和 Notification Center。有关 SSL 证书的更多信息,请参阅 Hub 安装指南
  • 您有足够的数据库权限来配置在此升级过程中创建的新数据库,如 dbcreator 或 sysadmin 等。
  • 2 安装 Hub 和/或 Interact 的服务器的 GB 可用磁盘空间—这是在安装流程完成之前创建备份所必需的。

升级程序会在升级过程中自动停止任何正在运行的网站。您无需手动停止网站。

升级步骤

  1. 请从 Blue Prism 门户网站下载适用于版本 4.1 到 4.2 的 Blue Prism Interact 与 Hub 升级程序。
  2. 在已安装 Hub 和 Interact 4.1 的计算机上解压缩安装程序。其包含两个文件:

    • Blue Prism Interact and Hub Upgrader.exe—升级程序的可执行文件。
    • BluePrismHubAndInteractUpdate4.2.bin—需要升级到 4.2 的二进制文件。

    这些文件必须保存在同一目录中。

  3. 双击升级程序的可执行文件来启动升级程序向导,在“欢迎使用 Hub 和 Interact 升级程序”屏幕上点击下一步
  4. 在“最终用户许可协议 (EULA)”屏幕上阅读最终用户许可协议,如果同意这些条款,请选中复选框并点击下一步
  5. 在“配置 License Manager SQL 连接”屏幕上:

    1. 配置适用于 License Manager 数据库的设置通过提供 SQL Server 主机名称或 IP 地址,以及帐户用于创建数据库的凭据:
      • 如果选择 Windows 身份验证,则帐户必须具有相应权限。
      • 如果选择 SQL 身份验证,请输入用户名和密码。

        您必须确保您的数据库密码不包含等号 (=) 或分号 (;)。这些字符不受支持,并且在尝试连接到数据库时将导致出现问题。

      数据库名称可以保留为默认值,也可以根据需要进行更改。

    2. 点击测试连接以继续,测试 SQL 凭据并验证连接性。
      通知将显示测试结果。仅当测试成功时,您才能继续下一步。

    3. 点击下一步
  6. 在“License Manager IIS 设置”屏幕上:

    1. 配置 License Manager 网站。

      您需要:

      • 输入站点名称。
      • 以小写输入主机名—这将用作站点的 URL。不得更改默认主机名的第一部分。您只能更改主机名的 .local 部分。请确保在选择主机名时考虑 DNS 和域结构。

        不支持在 URL 中使用大写字符。

      • 输入端口号。
      • 选择适当的 SSL 证书。
      • 保持启动站点选项的选中状态,除非您不希望网站在安装结束时自动打开。

    2. 点击下一步
  7. 在“Notification Center SQL 连接”屏幕上:

    1. 配置适用于通知中心数据库的设置通过提供 SQL Server 主机名称或 IP 地址,以及帐户用于创建数据库的凭据:
      • 如果选择 Windows 身份验证,则帐户必须具有相应权限。
      • 如果选择 SQL 身份验证,请输入用户名和密码。

        您必须确保您的数据库密码不包含等号 (=) 或分号 (;)。这些字符不受支持,并且在尝试连接到数据库时将导致出现问题。

      数据库名称可以保留为默认值,也可以根据需要进行更改。

    2. 点击测试连接以继续,测试 SQL 凭据并验证连接性。
      通知将显示测试结果。仅当测试成功时,您才能继续下一步。

    3. 点击下一步
  8. 在“Notification Center IIS 设置”屏幕上:

    1. 配置 Notification Center 网站。

      您需要:

      • 输入站点名称。
      • 以小写输入主机名—这将用作站点的 URL。不得更改默认主机名的第一部分。您只能更改主机名的 .local 部分。请确保在选择主机名时考虑 DNS 和域结构。

        不支持在 URL 中使用大写字符。

      • 输入端口号。
      • 选择适当的 SSL 证书。
      • 保持启动站点选项的选中状态,除非您不希望网站在安装结束时自动打开。

    2. 点击下一步
  9. 在“配置 IADA SQL 配置”屏幕上:

    1. 配置适用于 IADA 的设置通过提供 SQL Server 主机名称或 IP 地址,以及帐户用于创建数据库的凭据:
      • 如果选择 Windows 身份验证,则帐户必须具有相应权限。
      • 如果选择 SQL 身份验证,请输入用户名和密码。

        您必须确保您的数据库密码不包含等号 (=) 或分号 (;)。这些字符不受支持,并且在尝试连接到数据库时将导致出现问题。

      数据库名称可以保留为默认值,也可以根据需要进行更改。

    2. 点击测试连接以继续,测试 SQL 凭据并验证连接性。
      通知将显示测试结果。仅当测试成功时,您才能继续下一步。

    3. 点击下一步
  10. 在“准备升级到 4.2”屏幕上,点击“下一步”,将 Hub 和 Interact 升级到 4.2。
  11. 在“Blue Prism Hub 和 Blue Prism Interact 升级已完成”屏幕上:

    • 成功完成升级后,点击完成
    • 如果安装失败,查看日志选项将为您提供发生的错误的详细信息。有关更多信息,请参阅升级故障排除

  12. 确保适用于新数据库的数据库权限为:

    应用程序名称

    SQL 窗口的示例服务帐户名称身份验证

    安装期间所需的SQL Server权限

    应用程序运行期间所需的数据库权限

    默认数据库名称

    Blue Prism—Notification Center

    IIS APPPOOL\ Blue Prism – Notification Center

    dbcreator / sysadmin

    db_datawriter / db_datareader

    NotificationCenterDB

    Blue Prism—License Manager

    IIS APPPOOL\ Blue Prism – License Manager

    dbcreator / sysadmin

    db_owner

    具有执行权限(见下文)的 db_datawriter / db_datareader

    LicenseManagerDB

    当应用程序运行时,License Manager 需要相应的权限来执行存储程序。如果您不想使用 db_owner 作为权限级别,可以使用 db_datawriter/db_datareader 并运行以下 SQL 脚本,为该用户提供所需的级别:

    复制
    USE [LicenseManagerDB]
    GRANT EXECUTE to "IIS APPPOOL\Blue Prism - License Manager"

    其中:

    • [LicenseManagerDB] 是 License Manager 的数据库名称。
    • “IIS APPPOOL\Blue Prism - License Manager”是用户名。
  13. 如果使用 Windows 身份验证:

    1. 更改新安装的 License Manager 和 Notification Center 的应用程序池身份,以匹配已存在的 Hub 和 Interact 应用程序池。
    2. 向该身份(IIS 池在该身份下运行)提供 BPC_SQL_CERTIFICATE 证书访问权限。要执行此操作,请从 Windows 任务栏中打开“管理计算机证书”。在“个人文件夹”中,右键点击该证书并选择所有任务 > 管理私钥。添加与该身份匹配的用户,并为用户提供完全控制权。

      运行 Blue Prism – Hub 和 Blue Prism – IADA 应用程序池的身份需要访问此证书。

    3. 检查新文件夹上服务帐户的文件权限是否设置为“完全控制”:
      • C:\Program Files (x86)\Blue Prism\Notification Center
      • C:\Program Files (x86)\Blue Prism\License Manager
  14. 重新启动 RabbitMQ 服务。
  15. 重新启动所有应用程序池。
  16. 重新启动 IIS。
  17. 在所有安装 Hub 的计算机上重复此流程。

在升级过程中,插件会自动更新为最新版本。

升级故障排除

升级提前结束。怎么办?

升级流程经过精心设计,如果遇到故障,它会回滚安装并恢复升级前的版本。在升级过程中,会在安装位置(默认为 C:\Program Files (x86)\Blue Prism\)创建文件夹 backup_4.n,其中 4.n 反映现有版本号。它包含现有安装文件的副本,如果安装过程中遇到错误,它将用作回滚源。

您可以尝试重新运行升级程序。在重试升级之前,请阅读升级期间创建的任何错误消息和日志文件,并确保在重试升级之前已解决任何问题。

如果此问题仍然存在,请联系 Blue Prism 支持。

我已升级到版本 4.2,但仍显示 4.1 的用户界面。

如果遇到此情况,请清除您的浏览器缓存,然后重新加载页面。

我已从 4.1 版本升级,但没有创建我的新队列。

这可能是由于 RabbitMQ 中未启用法定队列功能。如果检查 Hub 日志,您将看到错误“‘quorum_queue'功能已禁用”。

  1. 在消息代理服务器上,运行 RabbitMQ 命令:

    rabbitmqctl enable_feature_flag quorum_queue

  2. 在 Hub Web 服务器上,重新启动应用程序池。

    队列已创建。

升级后,当我尝试登录 Interact 或 Hub 时,看到与 SignalR 相关的错误(涉及到 IIS 中的 Web 服务器过载)。

此错误非常罕见,但如果确实发生,请重新加载站点并重新启动 IIS 中的应用程序池。

我在升级过程中取消了安装,现在看到错误。

建议不要在升级过程中取消安装。不过,虽然可能会看到错误,但回滚操作将会成功完成。