第 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 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

   Copy to Clipboard Toggle word wrap

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

   $ ls WEB-INF
   web.xml web.xml.new

   Copy to Clipboard Toggle word wrap

   $ ls styles
   base.css base.css.removed

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   在 Windows 中：

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

   Copy to Clipboard Toggle word wrap

   $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)

     注意

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

   • 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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

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

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

   Maven 存储库更新示例：

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

   Copy to Clipboard Toggle word wrap
   注意

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

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

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

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

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

        Copy to Clipboard Toggle word wrap

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

        Copy to Clipboard Toggle word wrap

      • 在 Windows 中：

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

        Copy to Clipboard Toggle word wrap

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

        Copy to Clipboard Toggle word wrap

   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

        Copy to Clipboard Toggle word wrap

      • 在 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

        Copy to Clipboard Toggle word wrap

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

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

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

        Copy to Clipboard Toggle word wrap

      • 在 Windows 中：

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

        Copy to Clipboard Toggle word wrap
8. 完成应用所有相关更新后，启动 Red Hat Process Automation Manager 和 KIE Server 并登录到 Business Central。

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

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