第 3 章 将补丁更新和次要发行升级应用到 Red Hat Process Automation Manager

流程

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

   如果您要升级到 Red Hat Process Automation Manager 的新次版本，如从版本 7.12.x 升级到 7.13，请首先将最新的补丁更新应用到 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 服务器和无头流程自动化管理器控制器。使用这个更新工具，首先应用更新，然后安装与 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 服务器实例时，不要应用更新。

   在 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: 更新 Business Central(business-central.war)

   • RHPAM-kie-server-ee8 ：更新 KIE 服务器(kie-server.war)

     注意

     更新工具将会更新并替换红帽 JBoss EAP EE7 到红帽 JBoss EAP EE8。红帽 JBoss EAP EE7 用于 WebLogic 和 WebSphere，而版本 EE8 则用于红帽 JBoss EAP。确保更新工具不会更新 WebLogic 和 WebSphere 上的 KIE 服务器。

   • RHPAM-kie-server-jws: 更新 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 上完整红帽流程自动化管理器分发的 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

     使用，到无头进程 Automation Manager 控制器示例：

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

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

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

   对于已在红帽流程自动化管理器分发中已存在的文件，如决策引擎或其他附加组件的 .jar 文件，将该文件的现有版本替换为红帽客户门户网站中的新版本。

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

   Maven 存储库更新示例：

   $ unzip -o rhpam-7.13.4-maven-repository.zip 'rhba-7.13.4.GA-maven-repository/maven-repository/*' -d /tmp/rhbaMavenRepoUpdate
   
   $ mv /tmp/rhbaMavenRepoUpdate/rhba-7.13.4.GA-maven-repository/maven-repository/ $REPO_PATH/

   注意

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

7. 可选： 如果您要使用基于属性的用户存储更改 Red Hat Process Automation Manager，请完成以下步骤：

   1. 进入 $JBOSS_HOME 目录并运行以下命令之一：

      • 在 Linux 或基于 Unix 的系统中：

        $ ./bin/standalone.sh --admin-only -c standalone-full.xml

        $ ./bin/jboss-cli.sh --connect --file=rhpam-$VERSION-update/elytron/add-kie-fs-realm.cli

      • 在 Windows 中：

        $ ./bin/standalone.bat --admin-only -c standalone-full.xml

        $ ./bin/jboss-cli.bat --connect --file=rhpam-$VERSION-update/elytron/add-kie-fs-realm.cli

   2. 运行以下命令：

      • 在 Linux 或基于 Unix 的系统中：

        $ ./bin/elytron-tool.sh filesystem-realm --users-file standalone/configuration/application-users.properties --roles-file standalone/configuration/application-roles.properties --output-location standalone/configuration/kie-fs-realm-users --filesystem-realm-name kie-fs-realm-users

      • 在 Windows 中：

        $ ./bin/elytron-tool.bat filesystem-realm --users-file standalone/configuration/application-users.properties --roles-file standalone/configuration/application-roles.properties --output-location standalone/configuration/kie-fs-realm-users --filesystem-realm-name kie-fs-realm-users

   3. 导航到您提取 rhpam-$VERSION-update.zip 文件的目录，并运行以下命令来应用 kie-fs-realm 补丁之一：

      • 在 Linux 或基于 Unix 的系统中：

        $ ./elytron/kie-fs-realm-patch.sh ~/$JBOSS_HOME/standalone/configuration/kie-fs-realm-users/

      • 在 Windows 中：

        $ ./elytron/kie-fs-realm-patch.bat ~/$JBOSS_HOME/standalone/configuration/kie-fs-realm-users/

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

9. 验证 Business Central 窗口中的所有项目数据都显示和准确，然后在 Business Central 窗口右上角存在且准确，点击您的资料名称并点击 About 来验证更新的产品版本号。

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