升级 Hub 和 Interact

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

• 从 4.0 升级到 4.1。
• 从 4.1 升级到 4.2。
• 从 4.2 升级到 4.3。
• 从 4.3 升级到 4.4。
• 从 4.4 升级到 4.5。
• 从 4.5 升级到 4.6。
• 从 4.6 升级到 4.7。

完成升级后，建议用户登录 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.3 升级到版本 4.4

将 Hub 和 Interact 4.4 升级到版本 4.5

将 Hub 和 Interact 4.5 升级到版本 4.6

作为此次升级的一部分：

• Windows 身份验证功能安装在 IIS 中并应用于 Authentication Server 网站。
• 在 RabbitMQ 中创建新队列—您需要手动删除旧队列。

• Blue Prism API URL 已从 Web 服务器配置文件中删除—这会阻止 Control Room 与 Blue Prism 通信。要继续使用 Control Room，您需要以管理员身份登录 Hub 并在环境管理页面的 API 配置部分输入 URL，以重新输入此 URL。

  您必须输入包含协议的完整 URL，例如 http:// 或 https://。例如：https://bpapi.yourdomain.com

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

先决条件

• 已安装 Hub 和/或 Interact 版本 4.5。
• 每个人都需退出 Authentication Server。
• 备份所有相关数据库。虽然数据库不受升级的影响，但建议在执行任何升级之前备份数据库。
• 2.5 GB 可用磁盘空间—这是在安装过程完成之前创建备份所必需的。删除之前任何升级的所有备份。

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

升级步骤

1. 停止 Hub 和 Interact 站点的所有应用程序池。

2. 打开 RabbitMQ 并删除以下列内容开头的所有队列：

   • BPC.*
   • Connect.*
   • ImsServer.*
   • Interact.*
3. 请从 Blue Prism 门户网站下载适用于版本 4.5 到 4.6 的 Blue Prism Interact 与 Hub 升级程序。

4. 在已安装 Hub 和 Interact 4.5 的计算机上解压缩安装程序。其包含两个文件：

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

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

5. 双击升级程序的可执行文件来启动升级程序向导，在“欢迎使用 Hub 和 Interact 升级程序”屏幕上点击下一步。
6. 在“最终用户许可协议 (EULA)”屏幕上阅读最终用户许可协议，如果同意这些条款，请选中复选框并点击下一步。
7. 在“准备升级到 4.6”屏幕上，点击“下一步”‭，将 Hub 和 Interact 升级到 4.6。

8. 在“Blue Prism Hub 和 Blue Prism Interact 升级已完成”屏幕上：

   • 成功完成升级后，点击完成。

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

9. 在所有安装 Hub 和/或 Interact 的计算机上重复此流程。
10. 如果您正在使用 Blue Prism API，请以管理员身份登录 Hub，并在环境管理页面上输入 API URL。

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

将 Hub 和 Interact 4.6 升级到版本 4.7

此升级将更新 Blue Prism Hub、Blue Prism Interact 和支持站点，以使用以下 .NET 组件：

• .NET Desktop 运行时 6.0.9 或 6.0.10

• ASP.NET Core 运行时 6.0.9 或 6.0.10（Windows 托管捆绑包）

• .NET Framework 4.8—Windows Server 2022 上默认已安装。

此升级还强制实施 SSL 加密要求。有关更多信息，请参阅 。

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

先决条件

• 已安装 Hub 和/或 Interact 版本 4.6。

• 每个人都需退出 Authentication Server。

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

• 安装 Hub 和/或 Interact 的服务器的 2.5 GB 可用磁盘空间—这是在安装流程完成之前创建备份所必需的。删除之前任何升级的所有备份。

• SQL Server 必须配置为使用 SSL 加密。如果您的组织尚未使用 SSL 加密（您一直在运行没有 SQL Server 证书的环境，或者您一直在使用自签名证书），则您的组织应该从可信证书颁发机构获取证书，并将其导入 SQL Server 以启用该功能。有关更多信息，请参阅 Microsoft 文档。

  如果您之前没有为 SQL Server 使用 SSL 加密，则需要在运行升级程序之前为 Blue Prism 应用程序更新应用程序设置文件中的连接字符串。有关更多信息，请参阅 。

  来自可信证书颁发机构的证书应该用于生产环境。但是，自签名证书可以用于概念验证或开发环境。重要的是，SQL Server 使用的 FQDN（完全限定域名）必须与证书中定义的 FQDN 匹配。如果不匹配，则无法与数据库建立连接，安装也无法正常运行。有关使用和配置自签名证书的信息，请参阅 Blue Prism Hub 安装指南中的自签名证书。

  要将证书导入 SQL Server，请执行以下操作：

  1. 从 Windows 任务栏中，打开 SQL Server 配置管理器。

  2. 在 SQL Server 配置管理器中，展开 SQL Server 网络配置并右键点击 <SqlServerInstanceName> 协议，然后点击属性。

  3. 在 <SqlServerInstanceName> 协议的“属性”对话框中，选择证书选项卡，然后选择或导入所需的证书。

  4. 点击“应用”。

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

更新应用程序设置

如果您以前没有为 SQL Server 使用 SSL 加密，则只需要更新 Blue Prism 应用程序的 appsettings.json 文件。您可以使用 Blue Prism 创建的脚本更新应用程序设置，也可以手动更新。

要使用脚本更新应用程序设置，请执行以下操作：

1. 要将证书导入 SQL Server。有关更多信息，请参阅 。
2. 如果您还没有 Blue Prism Data Protector，请从 Blue Prism 门户下载并将其保存到您的 Hub 和/或 Interact Web 服务器。完成此过程后，您可以将其移除。
3. 如果您还没有应用程序设置脚本 (update‑connectionStrings.ps1)，请从 Blue Prism 门户下载并将其保存到您的 Hub 和/或 Interact Web 服务器。

4. 以管理员身份打开 PowerShell 并运行 update‑connectionStrings.ps1 脚本。出现提示时，请输入以下信息：

   1. installationDirectory—键入 Hub 安装位置的目录路径，然后按 Enter。例如，如果使用了默认安装位置，则路径将为 C:\Program Files (x86)\Blue Prism。

   2. sqlSource—键入 SSL 证书创建期间使用的 SQL Server 名称，然后按 Enter。

   3. dataProtectorPath—键入 Blue Prism Data Protector 的完整路径，然后按 Enter。例如，如果您直接将其保存到 C: 驱动器，请输入 C:\BluePrismDataProtector.Console.exe。

   4. interactInstallationDirectory—键入 Interact 安装位置的目录路径，然后按 Enter。例如，如果使用了默认安装位置，则路径将为 C:\Program Files (x86)\Blue Prism。如果您尚未安装 Interact，请勿输入任何信息，直接按 Enter。

   脚本会运行，并使用 SQL Server 的新值更新应用程序设置中的连接字符串。

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

要手动更新应用程序设置，请执行以下操作：

1. 要将证书导入 SQL Server。有关更多信息，请参阅 。
2. 如果您还没有 Blue Prism Data Protector，请从 Blue Prism 门户下载。
3. 在 BluePrismDataProtector.Console.exe 所在的文件夹中以管理员身份打开 PowerShell。您将使用此工具更新 appsettings.json 文件中的连接字符串。有关使用此工具的更多信息，请参阅 Blue Prism Data Protector 工具。

4. 在 Hub 和 Interact Web 服务器上，导航到以下文件并找到以下代码片段中指示的部分：

   下面所示的文件路径是默认安装位置。如果您将应用程序安装到其他文件夹，您应导航到该文件夹。

   C:\Program Files (x86)\Blue Prism\Audit Service\appsettings.json

   复制

   "ConnectionStrings": {
           "AuditServerConnection": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Audit Service Listener\appsettings.json

   复制

   "ConnectionStrings": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Authentication Server\appsettings.json

   复制

   "ConnectionStrings": {
           "IdentityServerConnection": <Replace the string here>
   "Storage": {
        "Type": "Database",
         "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Email Service\appsettings.json

   复制

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\File Service\appsettings.json

   复制

   "Storage": {
           "Type": "Database",
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Hub\appsettings.json

   复制

   "Data": {
         "Connect": {
           "ConnectionName": "Connect",
           "ConnectionString": <Replace the string here>
           
         "BluePrismDecision": {
           "ConnectionName": "BluePrismDecision",
           "ConnectionString": <Replace the string here>        
   
   "DistributedCache": {
     "Type": "Database",
     "DefaultExpirationMinutes": 0,
     "SqlServer": {
       "ConnectionString": <Replace the string here>
       
   "Storage": {
     "Type": "Database",
     "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\IADA\appsettings.json

   复制

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Interact\appsettings.json

   复制

   "InteractDatabases": {
         "InteractConnectionString": <Replace the string here>
         
   "DistributedCache": {
     "Type": "Database",
     "DefaultExpirationMinutes": 0,
     "SqlServer": {
       "ConnectionString": <Replace the string here> 

   C:\Program Files (x86)\Blue Prism\Interact Remote API\appsettings.json

   复制

   "InteractRemoteDatabases": {
           "InteractConnectionString": <Replace the string here>
           
   "InteractRemoteStorage": {
       "Type": "Database",
       "ConnectionString":    <Replace the string here>

   C:\Program Files (x86)\Blue Prism\License Manager\appsettings.json

   复制

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Notification Center\appsettings.json

   复制

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Submit Form Manager\appsettings.json

   复制

   "SubmitFormManagerDatabases": {
           "InteractConnectionString": <Replace the string here>

5. 对于这些文件，依次为：

   1. 使用 Blue Prism Data Protector 工具解密连接字符串并复制到临时文本文件，例如：

      复制

       "InteractDatabases": {
            "InteractConnectionString": "CfDJ8MILtsx8cQBOrqrAatl5A1aLmLP1GodoFWTnhvaHwh0ryabXaXW2i-KTfsq2XTYuAzct_ZXIFS3ILFv4Zu5ozmtvHv9aOLCxZjQJEUm7Ytwx8dK1Zqapywv2s5TCoi4X_9MGselkrRmbknBuQ_zWE93ozrNlBUVCQNHVedkyjTTPmPnxyeIgJJdoZRbkKOupnSrJwTt95SCmvo2SLLhZZFR5e2s24smn72PKNGrga8fksbIDpalDFwRc-i6_kkEinp5qA-FBFfIbVZzBD5ZN1dyuaC2jM7V4dxKt5tea1NP-_vauczgCLBp88WdmNEe0Ew"

      成为：

      复制

      "InteractDatabases": {
            "InteractConnectionString": "Data Source=existed-name-without-certificate; Initial Catalog=Interact; User Id=sa; Pass=Pass***; Max Pool Size=500; Encrypt=False; MultiSubnetFailover=True" 

      上述第 4 步中的示例显示了 appsettings.json 文件的摘录，以说明设置的位置。解密和加密只在连接字符串上进行，而不会在这些代码示例中也显示的设置上进行。

      只需要更新连接字符串中的数据源。连接字符串设置中的其他参数应保持不变。升级脚本将执行运行时所需的任何更改，例如更新加密参数。

   2. 在复制的连接字符串中，将数据源参数的值替换为证书的名称，例如：

      复制

      "InteractDatabases": {
            "InteractConnectionString": "Data Source=name-with-certificate; Initial Catalog=Interact; User Id=sa; Password=Pass***; Max Pool Size=500; Encrypt=False; MultiSubnetFailover=True" 

      证书名称可在 SQL Server 配置管理器中找到。

      1. 在 SQL Server 配置管理器中，展开 SQL Server 网络配置，右键点击 <SqlServerInstanceName> 协议，然后点击属性。
      2. 在 <SqlServerInstanceName> 协议的“属性”对话框中，选择证书选项卡。证书名称在签收人字段中显示—此名称的显示格式为：短名称后跟通用名称（通常是 FQDN）。这两个名称都可以用作数据源，但是，如果两个名称都存在，建议使用通用名称 (FQDN)。
      3. 或者，为进一步明确，请点击查看，然后选择使用者可选名称。名称在字段下方的文本区域中显示。

   3. 使用 Blue Prism Data Protector 工具加密新连接字符串并将 appsettings.json 文件中的字符串重写为这个新值。

   有关解密和加密连接字符串的信息，请参阅 Blue Prism Data Protector 工具。

6. 打开 IIS Manager 并重新启动相应的应用程序池，以确保其使用新的连接字符串。

7. 在所有安装 Hub 和/或 Interact 的计算机上重复此流程。

升级步骤

1. Blue Prism Hub 和 Blue Prism Interact 4.7 需要 .NET Core 6.0 和 .NET Framework 4.8。如果您没有这些版本，需要更新您的 Hub 和/或 Interact Web 服务器。

   步骤	详细信息	视频
   1	下载以下组件并将其存储在临时位置，例如 C:\temp: ASP.NET Core 运行时 6.0.9 或 6.0.10（Windows 托管捆绑包） https://dotnet.microsoft.com/download/dotnet/6.0—选择您所需的版本。在“ASP.NET Core 运行时”之下，选择“托管捆绑包”。 .NET Desktop 运行时 6.0.9 或 6.0.10 https://dotnet.microsoft.com/download/dotnet/6.0—选择您所需的版本。在“.NET 桌面运行时”之下，选择适当的下载。 .NET Framework 4.8 https://support.microsoft.com/en-us/topic/microsoft-net-framework-4-8-offline-installer-for-windows-9d23f658-3b97-68ab-d013-aa3c3e7495e0 默认已在 Windows Server 2022 上安装。如果您使用的是 Windows Server 2016 Datacenter 或 Windows Server 2019，则只需要安装 .NET Framework。	以上视频仅作为视觉指南。本视频中包含的 .NET 版本可能与所需的实际版本不同。
   2	要安装 .NET 依赖关系，请在运行下一个命令之前，使用 PowerShell 命令提示符运行以下每个命令，直到每个命令完成： 对于 Windows Server 2016 和 Windows Server 2019： 复制 start-process "C:\temp\dotnet-hosting-6.0.0-win.exe" /q -wait start-process "C:\temp\windowsdesktop-runtime-6.0.0-win-x64.exe" /q -wait start-process "C:\temp\ndp48-x86-x64-allos-enu.exe" /q -wait 对于 Windows Server 2022（默认已安装 .NET Framework）： 复制 start-process "C:\temp\dotnet-hosting-6.0.0-win.exe" /q -wait start-process "C:\temp\windowsdesktop-runtime-6.0.0-win-x64.exe" /q -wait 确保文件名和文件路径与步骤 1 中存储的文件相匹配。
   3	在安装 Blue Prism Hub 之前，请重新启动服务器，确保组件已完全安装和注册。

   要观看此安装步骤，请参阅我们的 .NET 安装视频。

2. 请从 Blue Prism 门户网站下载适用于版本 4.6 到 4.7 的 Blue Prism Interact 与 Hub 升级程序。

3. 在已安装 Hub 和 Interact 4.6 的计算机上解压缩安装程序。其包含两个文件：

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

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

4. 双击升级程序的可执行文件来启动升级程序向导，在“欢迎使用 Hub 和 Interact 升级程序”屏幕上点击下一步。

   升级程序会检查是否已安装步骤 1 中的必备软件。如果没有安装，则会显示“先决条件”屏幕，您需要关闭安装程序并执行步骤 1。

5. 在“最终用户许可协议 (EULA)”屏幕上阅读最终用户许可协议，如果同意这些条款，请选中复选框并点击下一步。
6. 在“准备升级到 4.7”屏幕上，点击下一步，将 Hub 和 Interact 升级到 4.7。

7. 在“Blue Prism Hub 和 Blue Prism Interact 升级已完成”屏幕上：

   • 成功完成升级后，点击完成。

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

8. 在所有安装 Hub 和/或 Interact 的计算机上重复此流程。

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

升级 Interact API VBO

Interact API VBO 用于 Blue Prism 交互式客户端中，并且独立更新，便于利用 Interact 更新后 Interact API 服务中任何可用的新功能。最新版本的 VBO 可在 Blue Prism 门户网站上的 Interact API 服务发行版 zip 文件中找到。

要升级 VBO，您只需更新实用程序—Interact VBO：

1. 从 Blue Prism 门户网站下载 Interact API 服务发行版文件。
2. 解压缩 Interact API 服务发行版文件。

3. 在 Blue Prism 交互式客户端中，选择文件 > 导入 > 发行版/技能。

   此时将显示“选择输入文件”屏幕。

4. 点击“浏览”并选择提取的 Interact API Release.bprelease 文件，然后点击“下一步”。

   此时将显示“解决导入冲突”屏幕。

5. 在“分辨率”列中：

   1. 将“实用程序—Interact API”的设置保留为“覆盖现有业务对象”。

   2. 将所有其他组件的设置更改为“不导入此业务对象”。

6. 点击下一步。

   此时将显示“流程日志记录概览”屏幕。

7. 确保仅列出要导入的实用程序—Interact API。如果：

   • 其他组件已列出，点击“后退”，然后按照上述步骤 5 中的详细信息来更改设置。
   • 仅此一个组件，请点击“下一步”以完成导入。

8. 点击完成。

升级故障排除

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

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

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

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