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

流程

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 和无头流程 Automation Manager 控制器。使用这个更新工具首先应用更新，然后安装与 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 脚本：

   重要

   在应用更新前，请确保您的红帽流程自动化管理器和 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 ：更新 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 ：在红帽 JBoss Web 服务器上更新 KIE 服务器(kie-server.war)
   • RHPAM-controller-ee7 ：更新无头进程 Automation Manager 控制器(controller.war)

   • RHPAM-controller-jws ：更新 Red Hat JBoss Web Server (controller.war)上的无头进程 Automation Manager 控制器。

     在 Red Hat JBoss EAP 上为完整的红帽流程自动化管理器分发的 Business Central 和 KIE Server 更新示例：

     $ ./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

     如果使用，对无头进程的 Automation Manager 控制器更新示例：

     $ ./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.12.0 Maven Repository 工件(rhpam-7.12.0-maven-repository.zip)，如在 air-gap 环境中下载 Red Hat Process Automation Manager 7.12.x Maven Repository，并将下载的 rhpam-7.12.x-maven-repository.zip 文件提取到现有的 ~/maven-repository 目录中。

   Maven 存储库更新示例：

   $ unzip -o rhpam-7.12.x-maven-repository.zip 'rhba-7.12.1.GA-maven-repository/maven-repository/*' -d /tmp/rhbaMavenRepoUpdate
   
   $ mv /tmp/rhbaMavenRepoUpdate/rhba-7.12.0.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 中重新安装相关的发行工件。恢复之前的发行版本后，您可以尝试运行更新。