静默安装

静默安装流程需要在 Powershell 中编辑和运行 Silent-Install-Hub-4.4.ps1 脚本,才能在不使用 Hub 安装程序向导的情况下安装 Hub。

Silent-Install-Hub-4.4.ps1 脚本可从 Blue Prism 门户网站下载。

要使用 Hub 安装程序向导进行常规安装,请参阅安装 Blue Prism Hub

使用 Hub 安装程序向导时,点击向导中的按钮,可以验证您已输入文本字段中的信息。执行静默安装时不进行验证。输入任何不正确的参数均可能导致 Web 服务器损坏。建议您先拍摄计算机快照,然后再将脚本作为备份运行。

目标读者

本指南适用于具备以下能力的 IT 专业人员:

  • 编辑和运行脚本
  • 使用 Powershell
  • 正在调试

先决条件

常规 Blue Prism Hub 安装所需的所有先决条件也适用于 Blue Prism Hub 静默安装。

有关安装所需软件的信息,请参阅安装和配置 Web 服务器

编辑 Silent-Install-Hub.ps1 脚本文件

以下部分描述如何为静默安装 Blue Prism Hub 准备 Silent-Install-Hub-4.4.ps1 脚本文件。

可在 Notepad 或 Visual Studio Code 等编辑器中打开和编辑 Silent-Install-Hub-4.4.ps1。文件中的各个代码部分均包含与 Hub 安装向导上的屏幕相对应的信息。

Silent-Install-Hub-4.4.ps1 文件中的大多数参数都可直接填充或编辑。各个参数均有一个名称和值,并以下列格式显示:

$msi_params = $msi_params + "NAME=`"Value`" "

要编辑参数,请重新输入“值”。建议您不要更改任何参数名称。

进行任何更改后,请记得保存 Silent-Install-Hub-4.4.ps1。

更改默认 Hub 安装的目标文件夹(可选)

要查看 Silent-Install-Hub.ps1 脚本中的默认位置并将其更改为新位置:

  1. 在编辑器中打开 Silent-Install-Hub-4.4.ps1 文件。

    这时将打开脚本文件。根据您的编辑器,其显示方式会有所不同。

    要安装 Hub 的目标文件夹会显示默认位置 (C:\Program Files (x86)\Blue Prism):

  2. 如果要将 Hub 安装在其他位置,请从行开头删除 # 并编辑上图中所示的文件路径。

    # 表示该行添加了注释,不会运行。您需要删除 # 以激活该行。

更改 SQL 身份验证模式(可选)

可以为以下数据库编辑身份验证模式:

  • IMS (IMS_SQL_SERVER)
  • Hub (HUB_SQL_SERVER)
  • Audit (AUDIT_SQL_SERVER)
  • File (FILE_SQL_SERVER)
  • Notification Center (NOTIFICATION_CENTER_SQL_SERVER)
  • License Manager (LICENSE_MANAGER_SQL_SERVER)
  • Email Service ( EMAIL_SERVICE_SQL_SERVER)

各个数据库部分对应 Hub 安装向导的屏幕。

以下说明使用 IMS 数据库作为示例(IMS 是 Authentication Server 的传统命名)。

以下代码行与 Hub 安装向导的“配置 IMS SQL 连接” 屏幕中的“身份验证模式” 面板相对应:

  • 要将身份验证模式设置为“受信任(Windows 身份验证)”,请按“T”键重新输入值。

    如果为 IMS_SQL_AUTH_MODE 值输入 T,请移除 IMS_SQL_USERNAME 和 IMS_SQL_PASSWORD 的任何值。

  • 要将身份验证模式设置为“指定用户名和密码(SQL 身份验证)”,请按“S”键重新输入值。

    如果为 IMS_SQL_AUTH_MODE 值输入“S”,则填充 IMS_SQL_USERNAME 和 IMS_SQL_PASSWORD 值。

编辑主机名称(可选)

可以为以下网站编辑主机名称:

  • IMS (IMS_SITE_NAME)
  • Hub (HUB_SITE_NAME)
  • Audit (AUDIT_SITE_NAME)
  • Email Service ( EMAIL_SERVICE_SITE_NAME)
  • File (FILE_SITE_NAME)
  • SignalR (SIGNALR_SITE_NAME)
  • License Manager (LICENSE_MANAGER_SITE_NAME)
  • Notification Center (NOTIFICATION_CENTER_SITE_NAME)

各个网站部分对应 Hub 安装向导的屏幕。

以下说明使用 IMS 网站作为示例(IMS 是 Authentication Server 的传统命名)。

IMS_HOSTNAME 对应 Hub 安装程序向导的“Authentication Server IIS 设置”屏幕。

查看/编辑主机名称:

  1. 查看 IMS_HOSTNAME 值中的值是否全部使用小写。
  2. 您可以使用新主机名称来重新输入 IMS_HOSTNAME 值。如果使用新主机名称重新输入,请确保以小写字母输入名称。

借助 PowerShell 获取 SSL 证书

您可以使用 PowerShell 作为显示特定商店中所有证书指纹的快速方法。

  1. 以管理员身份打开 Powershell。

  2. PS C:\Windows\system32>> 之后输入以下行:

    获取子项目—路径证书:\LocalMachine\My

  3. 按 Enter 键。

    证书指纹以大写显示,并且无空格。

借助 Microsoft 管理控制台获取 SSL 证书

Hub 安装向导中需要证书的任何屏幕都会显示一个下拉列表供您选择。执行静默安装时,必须以缩略图格式手动输入证书:

访问证书:

  1. 在 Windows 搜索栏中,输入“MMC”并选择“MMC 运行命令”。

    这时将打开 Microsoft 管理控制台。

  2. 点击“文件”,然后点击“添加/删除嵌入式管理单元”。

  3. 在添加或删除嵌入式管理单元对话框中,选择证书并点击添加

  4. 在证书嵌入式管理单元对话框中,点击“计算机帐户”并点击“下一步”。

  5. 点击“完成”,然后点击“确定”。

  6. 在树视图中点击证书,然后选择个人 > 证书文件夹或 Web 托管 > 证书文件夹以在主窗格中选择适当的证书(在易记名称列中查找)。

  7. 双击您的证书,然后在“证书”对话框中选择“详细信息”,然后选择“指纹”。

    脚本仅在证书指纹为大写并且不包含空格时可用。在粘贴到脚本文件之前,使用文本编辑器将其更改为大写并删除空格。

  8. 将指纹复制到“Silent-Install-Hub-4.4.ps1”文件中的相关证书值中。

选择并取消选择复选框

与复选框对应的值接受“true”或“false”值。

查看 RabbitMQ

确保 RMQ 参数包含正确的值。

查看客户 ID

确保 HUB_CUSTOMER_ID 参数包含正确的值。如果此值不正确,则在无手动重新配置的情况下,您将无法许可任何插件。

查看 Blue Prism API URL(可选)

确保 BLUE_PRISM_API_URL 参数包含正确的值。

组合参数

以下代码用于将所有参数合并为一个字符串,以便进行安装:

复制
$silentArgs = “/I `"[filepath to Blue Prism Hub.msi]$Version\Blue Prism Hub.msi`" /qn /norestart /l*v `"C:[filepath to log file]logs_hub_$Version.log’" $msi_params"$process = Start-Process msiexec.exe -Wait -ArgumentList $silentArgs -PassThruWrite-Host $process.ExitCode
检查“Blue Prism Hub.msi”文件的文件路径是否正确,如果不正确,请更新。

开始静默安装

进行任何更改后,请记得保存 Silent-Install-Hub-4.4.ps1。

开始安装之前,请确保 Silent-Install-Hub-4.4.ps1 脚本与 Blue Prism Hub.msi 文件位于同一目录下,否则您需要在下面第三步中指定脚本的完整路径。

  1. 在文件资源管理器中,导航至 Blue Prism Hub.msi 文件的位置。

  2. 点击文件并选择打开 Windows PowerShell > 以管理员身份打开 Windows PowerShell

    此时将显示 PowerShell 屏幕。

  3. 键入 .\Silent-Install-Hub-4.4.ps1 并按 Enter 键。

  4. 如果显示警告,按 R 键运行一次。

    Hub 安装程序将运行,Hub 4.4 一经安装即可供使用。如果安装失败,PowerShell 中会显示错误代码。建议您在日志中查找并修复问题。

在安装期间,在安装程序位置创建一个日志文件,并实时更新。出于安全考虑,建议在安装后删除日志文件。

静默卸载

进行任何更改后,请记得保存 Silent-Install-Hub-4.4.ps1。

  1. 使用 Powershell 作为管理员,替换 Silent-Install-Hub-4.4.ps1 文件中的以下代码行:

    复制
    $silentArgs = "/I `"[filepath to Blue Prism Hub.msi]$Version\Blue Prism Hub.msi`" /qn /norestart /l*v `"C:[filepath to log file]logs_hub_$Version.log` 

    含:

    复制
    $silentArgs = "/X `"[filepath to Blue Prism Hub.msi]$Version\Blue Prism Hub.msi`" /qn /norestart /l*v `"C:[filepath to log file]logs_hub_uninstall_$Version.log`" $msi_params"
  2. 在文件资源管理器中,导航至 Blue Prism Hub.msi 文件的位置。

  3. 点击文件并选择打开 Windows PowerShell > 以管理员身份打开 Windows PowerShell

    此时将显示 PowerShell 屏幕。

  4. 输入“\Silent-Install-Hub-4.4.ps.1”并按 Enter 键。
  5. 如果显示警告,按 R 键运行一次。

    Hub 将被卸载。

  6. 输入“.\Clear-Installation.ps1”并按 Enter 键。

    卸载流程完成。如果安装失败,PowerShell 中会显示错误代码。建议您在日志中查找并修复问题。

    出于安全考虑,应在安装后删除日志文件。