第 3 章 将补丁更新和次版本升级到 Red Hat Process Automation Manager

自动更新工具通常随补丁更新和 Red Hat Process Automation Manager 的新次要版本一起提供，以便于更新 Red Hat Process Automation Manager 的某些组件，如 Business Central、KIE Server 和无头进程自动化管理器控制器。其他 Red Hat Process Automation Manager 工件（如决策引擎和独立 Business Central）作为每个次发行版本的新工件发布，您必须重新安装它们以应用更新。

您可以使用相同的自动更新工具，将补丁更新和次版本升级到 Red Hat Process Automation Manager 7.11。Red Hat Process Automation Manager 的补丁更新（如从 7.11 升级到 7.11.1）包括最新的安全更新和程序错误修复。Red Hat Process Automation Manager 的次发行版本（如从版本 7.10.x 升级到 7.11），包括功能增强、安全更新和程序错误修复。

注意

Red Hat Process Automation Manager 更新工具中仅包含对 Red Hat Process Automation Manager 的更新。Red Hat JBoss EAP 的更新必须使用 Red Hat JBoss EAP 补丁分发来应用。有关红帽 JBoss EAP 补丁的更多信息，请参阅 Red Hat JBoss EAP 补丁和升级指南。

先决条件

  • 您的 Red Hat Process Automation Manager 和 KIE 服务器实例没有运行。在运行 Red Hat Process Automation Manager 或 KIE Server 实例时，不要应用更新。

流程

  1. 导航到红帽客户门户网站中的 Software Downloads 页面（需要登录），然后从下拉菜单中选择产品和版本。

    如果您要升级到 Red Hat Process Automation Manager 的新次要版本，如从版本 7.10.x 升级到 7.11，首先将最新的补丁更新应用到您当前的 Red Hat Process Automation Manager 版本，然后按照此流程升级到新的次版本。

  2. 单击 Patches，下载 Red Hat Process Automation Manager [VERSION] Update Tool，并将下载的 rhpam-$VERSION-update.zip 文件提取到临时目录中。

    这个版本工具会自动更新 Red Hat Process Automation Manager 的某些组件，如 Business Central、KIE Server 和无头进程自动化管理器控制器。首先使用此次更新工具来应用更新，然后安装与 Red Hat Process Automation Manager 发行版本相关的任何其他更新或新发行工件。

  3. 如果要保留更新工具更新的任何文件，进入提取的 rhpam-$VERSION-update 文件夹，打开 blacklist.txt 文件，并将相对路径添加到您不想更新的文件中。

    当文件列在 blacklist.txt 文件中时，更新脚本不会将文件替换为新版本，而是将文件保留原位，而在同一位置将添加新版本并带有 .new 后缀。如果您阻止不再分发的文件，则更新工具会创建一个带有 .removed 后缀的空标记文件。然后，您可以选择手动保留、合并或删除这些新文件。

    在 blacklist.txt 文件中要排除的文件示例： 

    WEB-INF/web.xml  // Custom file
styles/base.css  // Obsolete custom file kept for record

    更新后阻止的文件目录的内容： 

    $ ls WEB-INF
web.xml web.xml.new
    $ ls styles
base.css base.css.removed

  4. 在命令终端中，导航到提取 rhpam-$VERSION-update.zip 文件的临时目录，并以以下格式运行 apply-updates 脚本：

    重要

    在应用更新前，请确保您的 Red Hat Process Automation Manager 和 KIE 服务器实例没有运行。在运行 Red Hat Process Automation Manager 或 KIE Server 实例时，不要应用更新。

    在 Linux 或基于 Unix 的系统上： 

    $ ./apply-updates.sh $DISTRO_PATH $DISTRO_TYPE

    对于 Windows： 

    $ .\apply-updates.bat $DISTRO_PATH $DISTRO_TYPE

    $DISTRO_PATH 部分是相关分发目录的路径，$DISTRO_TYPE 部分是您使用这个更新更新的发行版类型。

    Red Hat Process Automation Manager 更新工具支持以下发行版类型：

    • rhpam-business-central-eap7-deployable: Updates Business Central (business-central.war)

    • rhpam-kie-server-ee8: Updates KIE Server (kie-server.war)

      注意

      更新工具将更新 Red Hat JBoss EAP EE7 到 Red Hat JBoss EAP EE8。Red Hat JBoss EAP EE7 用于 WebLogic 和 WebSphere，而版本 EE8 则用于 Red Hat JBoss EAP。确保 WebLogic 和 WebSphere 上的 KIE Server 不是由更新工具更新。

    • rhpam-kie-server-jws: Updates KIE Server on Red Hat JBoss Web Server (kie-server.war)
    • rhpam-controller-ee7 ：更新无头流程自动化管理器控制器(controller.war)

    • rhpam-controller-jws ：在 Red Hat JBoss Web Server (controller.war)上更新无头流程自动化管理器控制器

      在 Red Hat JBoss EAP 上为完整的 Red Hat Process Automation Manager 发行版更新到 Business Central 和 KIE 服务器示例： 

      ./apply-updates.sh ~EAP_HOME/standalone/deployments/business-central.war rhpam-business-central-eap7-deployable

./apply-updates.sh ~EAP_HOME/standalone/deployments/kie-server.war rhpam-kie-server-ee8

      使用无头进程自动化管理器控制器的示例： 

      ./apply-updates.sh ~EAP_HOME/standalone/deployments/controller.war rhpam-controller-ee7

      更新脚本会在提取的 rhpam-$VERSION-update 文件夹中创建一个 备份 文件夹，其中包含指定发行版的副本，然后继续进行更新。

  5. 更新工具完成后，返回到红帽客户门户网站的 Software Downloads 页面，在其中下载更新工具并安装与您的 Red Hat Process Automation Manager 发行版本相关的任何其他更新或新发行工件。

    对于 Red Hat Process Automation Manager 发行版本中已存在的文件，如决策引擎或其他附加组件的 .jar 文件，请将文件的现有版本替换为红帽客户门户网站中的新版本。

  6. 如果您使用独立的 Red Hat Process Automation Manager 7.11.0 Maven Repository 工件(rhpam-7.11.0-maven-repository.zip)，如在 air-gap 环境中，下载 Red Hat Process Automation Manager 7.11.x Maven Repository，并将下载的 rhpam-7.11.x-maven-repository.zip 文件提取到现有的 ~/maven-repository 目录中，以更新相关的内容。

    Maven 存储库更新示例： 

    $ unzip -o rhpam-7.11.x-maven-repository.zip 'rhba-7.11.1.GA-maven-repository/maven-repository/*' -d /tmp/rhbaMavenRepoUpdate

$ mv /tmp/rhbaMavenRepoUpdate/rhba-7.11.0.GA-maven-repository/maven-repository/ $REPO_PATH/
    注意

    在完成更新后，您可以删除 /tmp/rhbaMavenRepoUpdate 文件夹。

  7. 完成应用所有相关更新后，启动 Red Hat Process Automation Manager 和 KIE Server 并登录到 Business Central。

  8. 验证在 Business Central 中存在和准确的所有项目数据，并在 Business Central 窗口右上角点击您的配置集名称，然后点击 About 以验证更新的产品版本号。

    如果您遇到错误或注意到 Business Central 中缺少的数据，您可以恢复 rhpam-$VERSION-update 文件夹中 备份 文件夹中的内容，以恢复更新工具更改。您还可以在红帽客户门户网站中重新安装以前版本的 Red Hat Process Automation Manager 中的相关发行工件。恢复之前发行版本后，您可以重试来运行更新。