ai-center
2022.4
true
AI Center 安装指南
Automation CloudAutomation SuiteStandalone
Last updated 2024年6月6日

离线升级

准备

警告:确保所有节点上的 /opt/UiPathAutomationSuite 文件夹都有 10GiB 的可用空间。如果空间不足,您可以增加此文件夹的容量,也可以删除除 cluster_config.json 之外的所有以前的安装程序文件。您随时可以再次下载以前的安装程序。
要验证可用空间,请运行以下命令: df -h /opt/UiPathAutomationSuite

要准备升级,请执行以下步骤:

  1. 识别在 /uipath 装载点附加了其他 UiPath bundle 磁盘的服务器(而非代理)节点。此节点在整个文档中被称为主服务器节点。对于其中只有一个服务器节点的单节点评估配置文件,您必须登录该节点。
    注意:在集群中的所有节点上执行以下步骤。首先是服务器节点,然后是代理节点。
  2. 使用 SSH 连接到节点。
  3. 成为根用户:
    sudo su -sudo su -
  4. /opt/UiPathAutomationSuite 目录下创建安装文件夹:
    <h1>Please replace {version} with installer version
    mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1><h1>Please replace {version} with installer version
    mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>
  5. 下载 sf-installer.zip 并将其复制到 /opt/UiPathAutomationSuite/{version}/installer有关下载说明,请参阅 sf-installer.zip
    cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installercp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
  6. 下载 sf-infra.tar.gz 并将其复制到 /opt/UiPathAutomationSuite/{version}有关下载说明,请参阅 sf-infra.tar.gz
    cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
  7. (仅在 主服务器节点上)。 下载 sf.tar.gz 并将其复制到 /uipath/{version}有关下载说明,请参阅 sf.tar.gz
    cp /path/to/sf.tar.gz /uipath/{version}cp /path/to/sf.tar.gz /uipath/{version}
  8. sf-installer.zip 解压缩:
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip sf-installer.zip -d .cd /opt/UiPathAutomationSuite/{version}/installer
    unzip sf-installer.zip -d .
  9. 为安装程序提供必要的权限:
    chmod 755 -R /opt/UiPathAutomationSuite/{version}/installerchmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
  10. 在第一个服务器节点上生成最新的 cluster_config.json ,并将其复制到其余节点。 有关如何配置 cluster_config.json 参数的详细信息,请参阅 使用配置文件
  • 如果您有旧版 cluster_config.json,请通过运行以下命令从集群生成配置文件:
    cd /opt/UiPathAutomationSuite/{version}/installer
    ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.jsoncd /opt/UiPathAutomationSuite/{version}/installer
    ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
  • 如果您没有旧版 cluster_config.json 文件,请使用以下命令覆盖任何默认值(您在安装以前的版本时可能已这样操作):
    cd /opt/UiPathAutomationSuite/{version}/installer
    ./configureUiPathAS.sh config get -o ./cluster_config.jsoncd /opt/UiPathAutomationSuite/{version}/installer
    ./configureUiPathAS.sh config get -o ./cluster_config.json

添加 AI Center 特定配置

  1. 使用编辑器(例如 vi)打开cluster_config.json
    vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.jsonvi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json
  2. 替换以下块:
    "aicenter": {
      "enabled": "false"
    },"aicenter": {
      "enabled": "false"
    },
    注意:如果启用了 AI Center,则默认启用 Document Understanding。
  3. 使用以下信息(将 <> 之间的信息替换为您的值):
    "aicenter": {
      "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
      "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
      "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
      "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
      "identity_access_token": "<placeholder will be replaced later>",
    },"aicenter": {
      "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
      "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
      "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
      "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
      "identity_access_token": "<placeholder will be replaced later>",
    },

执行

警告:如果在升级期间或之后发生任何错误或问题,只要您之前配置了备份,就可以回滚到以前的版本。有关说明,请参阅“出错时回滚”。

配置备份

要配置备份,请执行以下步骤:

  1. 确保您在集群上启用了备份。 您必须使用与当前部署所用版本相同的安装程序版本创建备份。 有关说明,请参阅与您计划升级的UiPath AI Center版本对应的备份和还原文档。
  2. 通过 SSH 连接到其中一个服务器节点。
  3. 要验证集群中是否所有所需的卷都有备份,请运行:
    /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
    注意:备份可能需要一些时间,因此请等待大约 15 至 20 分钟,然后再次验证卷备份。

创建备份后,请继续执行以下步骤。

将集群置于维护模式

将集群置于维护模式将关闭入口控制器和所有 UiPath 服务,并阻止流向 AI Center 集群的所有传入流量。

警告:此操作将导致停机,并且在整个升级过程中,您的业务自动化将暂停。
  1. 要将集群置于维护模式,请运行:
    cd /opt/UiPathAutomationSuite/{version}/installer
    ./configureUiPathAS.sh enable-maintenance-modecd /opt/UiPathAutomationSuite/{version}/installer
    ./configureUiPathAS.sh enable-maintenance-mode
  2. 要验证集群是否处于维护模式,请运行:
    ./configureUiPathAS.sh is-maintenance-enabled./configureUiPathAS.sh is-maintenance-enabled
    警告:启用维护模式后,请创建 SQL Server 的备份,以便 SQL 数据库不再记录任何事务。

更新 Kubernetes 和其他基础架构组件

警告:您必须在集群中的所有节点上执行基础架构升级。

您不能同时在多个节点上执行此步骤;您必须等待每个节点上的升级完成,然后才能移动到另一个节点。

  1. 登录到要执行基础架构升级的每个节点。
  2. 通过运行 sudo su - 成为根用户。
  3. 确保在服务器和代理节点上启用rke service

    如果该服务已禁用,请通过运行以下命令启用该服务:

    • 对于服务器节点:
      [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service[[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service
    • 对于代理节点:
      [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service[[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
  4. 要开始升级,请运行以下命令:
    警告:请确保已按照准备步骤中的说明更新生成的 cluster_config.json
    replace {version} with the version you are upgrading to
    cd /opt/UiPathAutomationSuite/{version}/installer
    /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.jsonreplace {version} with the version you are upgrading to
    cd /opt/UiPathAutomationSuite/{version}/installer
    /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
    重要提示:如果出现错误,请按照“将 Ceph 从 16.2.6 降级到 15.2.9”中的说明进行操作。

更新共享组件和 UiPath 产品服务

此步骤将升级与集群一起运行的结构和服务组件。 您只能在主服务器节点上执行此步骤。

  1. 连接到任何服务器节点。
  2. 通过运行 sudo su - 成为根用户。
  3. 运行以下命令:
    replace {version} with the version you are upgrading to in both the commands
    cd /opt/UiPathAutomationSuite/{version}/installer
    /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.jsonreplace {version} with the version you are upgrading to in both the commands
    cd /opt/UiPathAutomationSuite/{version}/installer
    /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
  4. 使用以下命令运行软件安装程序。

    首先,您需要连接到身份服务器并检索安装令牌。 然后复制此令牌并将其粘贴到“cluster_config.json”文件中的占位符中。

    一旦令牌存在,您就可以运行 AI Center 安装程序。

    /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json/path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
    警告:升级完成后,系统将自动禁用维护模式。

启用升级后备份

警告:请确保 AI Center 已启动并正在运行,且您的自动化按预期继续进行,然后再继续执行后续步骤。

在开始升级集群之前,升级脚本会自动创建集群的备份,然后暂时将其禁用。 升级完成后,您可能需要手动启用备份。

要启用备份,请从任何服务器节点运行以下命令:
replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backupsreplace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。