第 62 章 为 Red Hat Decision Manager 应用补丁更新和次版本升级
自动更新工具通常随补丁更新和新的 Red Hat Decision Manager 次要版本一起提供,以便于更新 Red Hat Decision Manager 的某些组件,如 Business Central、KIE Server 和无头决策管理器控制器。其他红帽决策管理器工件(如决策引擎和独立 Business Central)会在每个次发行版本中作为新工件发布,您必须重新安装它们以应用更新。
您可以使用相同的自动更新工具,将补丁更新和次版本升级到 Red Hat Decision Manager 7.12。Red Hat Decision Manager 的补丁更新(如从 7.12 升级到 7.12.1)包括最新的安全更新和程序错误修复。Red Hat Decision Manager 的次发行版本(如从版本 7.10.x 升级到 7.11),包括功能增强、安全更新和程序错误修复。
Red Hat Decision Manager 更新工具仅包含对 Red Hat Decision Manager 的更新。必须使用红帽 JBoss EAP 补丁分发来应用红帽 JBoss EAP 的更新。有关 Red Hat JBoss EAP 补丁的更多信息,请参阅 Red Hat JBoss EAP 补丁和升级指南。
先决条件
- 您的 Red Hat Decision Manager 和 KIE 服务器实例没有运行。在运行 Red Hat Decision Manager 或 KIE Server 实例时,不要应用更新。
流程
导航到红帽客户门户网站中的 Software Downloads 页面(需要登录),然后从下拉菜单选择产品和版本。
如果您要升级到 Red Hat Decision Manager 的新次要版本,如从版本 7.10.x 升级到 7.11,首先将最新的补丁更新应用到您的当前 Red Hat Decision Manager 版本,然后按照此流程升级到新的次版本。
单击 Patches,下载 Red Hat Decision Manager [VERSION] Update Tool,并将下载的
rhdm-$VERSION-update.zip
文件提取到临时目录中。这个版本工具会自动更新 Red Hat Decision Manager 的某些组件,如 Business Central、KIE Server 和无头决策管理器控制器。首先使用这个更新来应用更新,然后安装与 Red Hat Decision Manager 发行版本相关的任何其他更新或新发行工件。
如果要保留更新工具更新的任何文件,进入提取的
rhdm-$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
WEB-INF/web.xml // Custom file styles/base.css // Obsolete custom file kept for record
Copy to Clipboard Copied! 更新后被阻止的文件内容:
ls WEB-INF
$ ls WEB-INF web.xml web.xml.new
Copy to Clipboard Copied! ls styles
$ ls styles base.css base.css.removed
Copy to Clipboard Copied! 在命令终端中,导航到提取
rhdm-$VERSION-update.zip
文件的临时目录,并以以下格式运行apply-updates
脚本:重要在应用更新前,请确保您的 Red Hat Decision Manager 和 KIE 服务器实例没有运行。在运行 Red Hat Decision Manager 或 KIE Server 实例时,不要应用更新。
在 Linux 或基于 Unix 的系统中:
./apply-updates.sh $DISTRO_PATH $DISTRO_TYPE
$ ./apply-updates.sh $DISTRO_PATH $DISTRO_TYPE
Copy to Clipboard Copied! 在 Windows 中:
.\apply-updates.bat $DISTRO_PATH $DISTRO_TYPE
$ .\apply-updates.bat $DISTRO_PATH $DISTRO_TYPE
Copy to Clipboard Copied! $DISTRO_PATH
部分是相关发布目录的路径,$DISTRO_TYPE
部分是您更新的分发类型。Red Hat Decision Manager 更新工具支持以下发行版类型:
-
rhDM-decision-central-eap7-deployable
: Updates Business Central (decision-central.war
) -
rhdm-kie-server-ee8
: Updates KIE Server (kie-server.war
) -
rhDM-kie-server-jws
: Updates KIE Server on Red Hat JBoss Web Server (kie-server.war
) -
rhDM-controller-ee7
:更新无头决策管理器控制器(controller.war
) rhDM-controller-jws
:在 Red Hat JBoss Web Server (controller.war
)上更新无头决策管理器控制器在 Red Hat JBoss EAP 上为完整的 Red Hat Decision Manager 发行版更新到 Business Central 和 KIE 服务器示例:
./apply-updates.sh ~EAP_HOME/standalone/deployments/decision-central.war rhdm-decision-central-eap7-deployable ./apply-updates.sh ~EAP_HOME/standalone/deployments/kie-server.war rhdm-kie-server-ee8
$ ./apply-updates.sh ~EAP_HOME/standalone/deployments/decision-central.war rhdm-decision-central-eap7-deployable $ ./apply-updates.sh ~EAP_HOME/standalone/deployments/kie-server.war rhdm-kie-server-ee8
Copy to Clipboard Copied! 使用无头决定管理器控制器的更新示例:
./apply-updates.sh ~EAP_HOME/standalone/deployments/controller.war rhdm-controller-ee7
$ ./apply-updates.sh ~EAP_HOME/standalone/deployments/controller.war rhdm-controller-ee7
Copy to Clipboard Copied! 更新脚本会在提取的
rhdm-$VERSION-update
文件夹中创建一个备份
文件夹,其中包含指定发行版的副本,然后继续进行更新。
-
更新工具完成后,返回到红帽客户门户网站的 Software Downloads 页面,在其中下载更新工具并安装与您的 Red Hat Decision Manager 发行版本相关的任何其他更新或新发行工件。
对于 Red Hat Decision Manager 发行版本中已存在的文件,如决策引擎或其他附加组件的
.jar
文件,请将文件的现有版本替换为红帽客户门户网站中的新版本。如果您使用独立的 Red Hat Decision Manager 7.12.0 Maven Repository 工件(
rhdm-7.12.0-maven-repository.zip
),例如在 air-gap 环境中,下载 Red Hat Decision Manager 7.12.x Maven Repository,并将下载的rhdm-7.12.x-maven-repository.zip
文件提取到现有的~/maven-repository
目录中,以更新相关的内容。Maven 存储库更新示例:
unzip -o rhdm-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/
$ unzip -o rhdm-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 Copied! 注意您可以在完成更新后删除
/tmp/rhbaMavenRepoUpdate
文件夹。可选: 如果要将 Red Hat Decision Manager 从使用基于属性的用户存储改为基于文件的用户存储,请完成以下步骤:
导航到
$JBOSS_HOME
目录,再运行以下命令之一:在 Linux 或基于 Unix 的系统中:
./bin/standalone.sh --admin-only -c standalone-full.xml
$ ./bin/standalone.sh --admin-only -c standalone-full.xml
Copy to Clipboard Copied! ./bin/jboss-cli.sh --connect --file=rhdm-$VERSION-update/elytron/add-kie-fs-realm.cli
$ ./bin/jboss-cli.sh --connect --file=rhdm-$VERSION-update/elytron/add-kie-fs-realm.cli
Copy to Clipboard Copied! 在 Windows 中:
./bin/standalone.bat --admin-only -c standalone-full.xml
$ ./bin/standalone.bat --admin-only -c standalone-full.xml
Copy to Clipboard Copied! ./bin/jboss-cli.bat --connect --file=rhdm-$VERSION-update/elytron/add-kie-fs-realm.cli
$ ./bin/jboss-cli.bat --connect --file=rhdm-$VERSION-update/elytron/add-kie-fs-realm.cli
Copy to Clipboard Copied!
运行以下命令:
在 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
$ ./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 Copied! 在 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
$ ./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 Copied!
进入您提取
rhdm-$VERSION-update.zip
文件的目录,并运行以下命令来应用kie-fs-realm
补丁:在 Linux 或基于 Unix 的系统中:
./elytron/kie-fs-realm-patch.sh ~/$JBOSS_HOME/standalone/configuration/kie-fs-realm-users/
$ ./elytron/kie-fs-realm-patch.sh ~/$JBOSS_HOME/standalone/configuration/kie-fs-realm-users/
Copy to Clipboard Copied! 在 Windows 中:
./elytron/kie-fs-realm-patch.bat ~/$JBOSS_HOME/standalone/configuration/kie-fs-realm-users/
$ ./elytron/kie-fs-realm-patch.bat ~/$JBOSS_HOME/standalone/configuration/kie-fs-realm-users/
Copy to Clipboard Copied!
- 完成应用所有相关更新后,启动 Red Hat Decision Manager 和 KIE Server 并登录到 Business Central。
验证 Business Central 中是否存在和准确,在 Business Central 窗口右上角点击您的资料名称,然后单击 About 以验证更新的产品版本号。
如果您遇到错误或注意到 Business Central 中缺少的数据,您可以恢复
rhdm-$VERSION-update
文件夹中备份
文件夹中的内容,以恢复更新工具更改。您还可以在红帽客户门户网站中重新安装来自以前版本的 Red Hat Decision Manager 中的相关发行工件。恢复之前的发行版本后,您可以尝试运行更新。