安装和配置红帽流程自动化管理器

流程

1. 在终端窗口中，导航到您下载安装程序 JAR 文件的目录，然后输入以下命令：

   java -jar rhpam-installer-7.12.0.jar

   注意

   在 Windows 上运行安装程序时，可能会提示您在安装过程中提供管理员凭据。要防止此要求，请在安装命令中添加 izpack.mode=privileged 选项：

   java -Dizpack.mode=privileged -jar
   rhpam-installer-7.12.0.jar

   另外，在 32 位 Java 虚拟机上运行安装程序时，您可能会遇到内存限制。要防止这个问题，请运行以下命令：

   java -XX:MaxHeapSize=4g -jar
   rhpam-installer-7.12.0.jar

   图形安装程序显示启动屏幕和许可证协议页面。

2. 单击 I accept the terms of this license agreement，然后单击 Next。
3. 指定您要安装 Red Hat Process Automation Manager 的 Red Hat JBoss EAP 7.4 服务器主页，然后点 Next。

4. 选择您要安装的组件，然后点 Next。

   注意

   您可以在同一个服务器上安装 Business Central 和 KIE 服务器。但是，您应该在生产环境中的不同服务器上安装 Business Central 和 KIE 服务器。为此，请运行安装程序两次。

5. 创建用户，然后单击下一步。默认情况下，如果您在同一容器中安装 Business Central 和 KIE Server，则新用户将获得 admin、kie-server 和 rest-all 角色。如果您只安装 KIE Server，则会给出 kie-server 角色。要选择另一个角色，请取消选择 admin。有关角色的详情，请参考 第 11 章 Red Hat Process Automation Manager 角色和用户。

   注意

   确保指定的用户名与现有用户、角色或组不同。例如，不要创建用户名 admin 的用户。

   密码必须至少有 8 个字符，且必须至少包含一个数字，以及一个非字母数字字符，但不能包括 & (ampersand)。

   记录用户名和密码。您需要他们访问 Business Central 和 KIE 服务器。

6. 在 Installation Overview 页面中，查看您要安装的组件并点 Next 开始安装。
7. 安装完成后，单击 下一步。

8. 如果安装了 KIE Server，则 组件安装 下会显示 Configure Runtime 步骤。在 Configure Runtime Environment 页面中，选择执行默认安装或执行高级配置。

   如果您选择 Perform advanced configuration，您可以选择配置数据库设置或自定义某些 KIE Server 选项。

9. 如果您选择了 Customize database settings，在 JDBC Drive Configuration 页面中指定数据源 JDBC 驱动程序供应商，请选择一个或多个驱动程序 JAR 文件，然后单击 Next。

   数据源是一种对象，它允许 Java 数据库连接(JDBC)客户端（如应用服务器）与数据库建立连接。应用程序在 Java 命名和目录接口(JNDI)树或本地应用程序上下文中查找数据源，并请求数据库连接来检索数据。您必须为 KIE 服务器配置数据源，以确保服务器与指定数据库之间的正确数据交换。

10. 如果您选择了 Customize KIE Server properties，在 KIE Server Properties Configuration 页面中更改以下任何属性：

    • 更改 KIE 服务器 ID 的值，以更改 KIE Server 属性的名称。
    • 更改 Controller URL 的值，以更改无头进程 Automation Manager 控制器的 URL。
    • 取消选择您要禁用的任何 KIE 服务器功能。
11. 点 Next 配置运行时环境。
12. 当在屏幕的顶部出现 Processing finished 时，点 Next 来完成安装。

13. 可选：点 Generate Installation Script and Properties File 将安装数据保存在 XML 文件中，然后点 Done。

    安装程序生成两个文件。auto.xml 文件自动执行将来的安装，auto.xml.variables 文件存储用户密码和其他敏感变量。使用 auto.xml 文件在多个具有相同类型的服务器以及与原始安装相同的配置的情况下重复 Red Hat Process Automation Manager 安装。如有必要，更新 auto.xml 文件中的 installpath 参数。要使用 XML 文件执行安装，请输入以下命令：

    java -jar rhpam-installer-7.12.0.jar <path-to-auto.xml-file>

流程

1. 在终端窗口中，进入您下载安装程序文件的目录，并输入以下命令：

   java -jar rhpam-installer-7.12.0.jar -console

   命令行交互流程将启动并显示最终用户许可协议。

   press 1 to continue, 2 to quit, 3 to redisplay.

2. 阅读许可证协议，输入 1，然后按 Enter 继续：

   Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7 or Red Hat JBoss Web Server 5. For more information, see https://access.redhat.com/articles/3405381[Red Hat Process Automation Manager 7 Supported Configurations].

3. 输入现有 Red Hat JBoss EAP 7.4 安装的父目录。

   安装程序将在提供的位置验证安装位置。输入 1 确认并继续。

   注意

   您可以在同一个服务器上安装 Business Central 和 KIE 服务器。但是，您应该在生产环境中的不同服务器上安装 Business Central 和 KIE 服务器。

4. 按照安装程序中的说明完成安装。

   注意

   当您创建用户名和密码时，请确保指定的用户名与角色或组群的任何已知标题没有冲突。例如，如果有一个名为 admin 的角色，则不应创建一个名为 admin 的用户。

   密码必须至少有 8 个字符，且必须至少包含一个数字，以及一个非字母数字字符(不能包括字符 &)。

   记录用户名和密码。您需要他们访问 Business Central 和 KIE 服务器。

5. 安装完成后，您将看到这个信息：

   Would you like to generate an automatic installation script and properties file?

6. 输入 y 创建包含安装数据的 XML 文件，或输入 n 来完成安装。如果输入 y，系统会提示您指定 XML 文件的路径。

7. 输入路径或按 Enter 键接受推荐的路径。

   安装程序生成两个文件。auto.xml 文件自动执行将来的安装，auto.xml.variables 文件存储用户密码和其他敏感变量。在多个系统上使用 auto.xml 文件，在与原始安装相同的配置相同的服务器上轻松重复 Red Hat Process Automation Manager 安装。如有必要，更新 auto.xml 文件中的 installpath 参数。要使用 XML 文件执行安装，请输入以下命令：

   java -jar rhpam-installer-7.12.0.jar <path-to-auto.xml-file>

8. 如果您只安装 Business Central，请重复这些步骤以在单独的服务器上安装 KIE Server。

流程

1. 在第一个计算机上，以交互模式或 CLI 模式运行安装程序。如需更多信息，请参阅以下部分之一：

   • 第 13.1 节 “在互动模式中使用安装程序”
   • 第 13.2 节 “在 CLI 模式中使用安装程序”
2. 在 组件选择 页面中，清除 KIE Server 框。
3. 完成 Business Central 安装。
4. 在第二台计算机上，以交互模式或 CLI 模式运行安装程序。
5. 在 组件选择 页面中，清除 Business Central 框。
6. 在 Configure Runtime Environment 页面上，选择 Perform Advanced Configuration。
7. 选择 Customize KIE Server 属性 并单击下一步。

8. 输入 Business Central 的控制器 URL，并为 KIE 服务器配置其他属性。控制器 URL 具有以下形式，其中 & lt;HOST:PORT > 是第二个计算机上的 Business Central 地址：

   <HOST:PORT>/business-central/rest/controller

9. 完成安装。
10. 要验证 Process Automation Manager 控制器现在是否已与 Business Central 集成，请转至 Business Central 中的 Execution Servers 页面，并确认您在 REMOTE SERVERS 下配置的 KIE 服务器。

流程

1. 将 rhpam-7.12.0- business-central-eap7-deployable.zip 文件提取到临时目录中。在以下示例中，此目录名为 TEMP_DIR。

2. 将 TEMP_DIR/rhpam-7.12.0- business-central-eap7-deployable/jboss-eap-7.4 目录的内容复制到 EAP_HOME。出现提示时，合并或替换文件。

   警告

   确保您复制的 Red Hat Process Automation Manager 部署的名称不会与 Red Hat JBoss EAP 实例中的现有部署冲突。

流程

1. 将 rhpam-7.12.0-kie-server-ee8.zip 归档提取到临时目录中。在以下示例中，此目录名为 TEMP_DIR。

2. 将 TEMP_DIR/rhpam-7.12.0-kie-server-ee8/kie-server.war 目录复制到 EAP_HOME/standalone/deployments/。

   警告

   确保您复制的 Red Hat Process Automation Manager 部署的名称不会与 Red Hat JBoss EAP 实例中的现有部署冲突。

3. 将 TEMP_DIR/rhpam-7.12.0-kie-kie-server-ee8/rhpam-7.12.0-kie-server-ee8/SecurityPolicy/ 复制到 EAP_HOME/bin。
4. 当提示覆盖文件时，点 替换。
5. 在 EAP_HOME/standalone/deployments/ 目录中，创建一个名为 kie-server.war.dodeploy 的空文件。此文件确保服务器启动时自动部署 KIE 服务器。

流程

1. 完成以下步骤以准备数据库：

   1. 将 rhpam-7.12.0-add-ons.zip 提取到临时目录中，如 TEMP_DIR。
   2. 提取 TEMP_DIR/rhpam-7.12.0-migration-tool.zip。
   3. 将您的当前目录更改为 TEMP_DIR/rhpam-7.12.0-migration-tool/ddl-scripts 目录。此目录包含多种数据库类型的 DDL 脚本。

   4. 将数据库类型的 DDL 脚本导入到您要使用的数据库中。

      以下示例在 PostreSQL 中创建 jBPM 数据库结构

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注意

      如果您将 PostgreSQL 或 Oracle 与 Spring Boot 结合使用，您必须导入相应的 Spring Boot DDL 脚本，如 /ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql 或 /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql。

      注意

      PostgreSQL DDL 脚本创建 PostgreSQL 模式，其中包含标有 @LOB 的实体属性的自动递增整数值(OID)列。要使用其他二进制列类型，如 BYTEA 而不是 OID，您必须使用 postgresql-bytea-jbpm-schema.sql 脚本创建 PostgreSQL 模式，并设置 Red Hat Process Automation Manager org.kie.persistence.postgresql.useBytea=true 标志。Red Hat Process Automation Manager 不提供从基于 OID 变为基于 BYTEA 模式的迁移工具。

2. 在文本编辑器中打开 EAP_HOME/standalone/configuration/standalone-full.xml，并找到 < system-properties> 标签。

3. 在 < system-properties > 标签中添加以下属性，其中 & lt;DATASOURCE > 是数据源的 JNDI 名称，< HIBERNATE_DIALECT > 是数据库的休眠。

   注意

   org.kie.server.persistence.ds 属性的默认值为 java:jboss/datasources/ExampleDS。org.kie.server.persistence.dialect 属性的默认值为 org.hibernate.dialect.H2Dialect。

   <property name="org.kie.server.persistence.ds" value="<DATASOURCE>"/>
   <property name="org.kie.server.persistence.dialect" value="<HIBERNATE_DIALECT>"/>

   以下示例演示了如何为 PostgreSQL hibernate dialect 配置数据源：

   <system-properties>
       <property name="org.kie.server.repo" value="${jboss.server.data.dir}"/>
       <property name="org.kie.example" value="true"/>
       <property name="org.jbpm.designer.perspective" value="full"/>
       <property name="designerdataobjects" value="false"/>
       <property name="org.kie.server.user" value="rhpamUser"/>
       <property name="org.kie.server.pwd" value="rhpam123!"/>
       <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>
       <property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/>
       <property name="org.kie.server.controller.user" value="kieserver"/>
       <property name="org.kie.server.controller.pwd" value="kieserver1!"/>
       <property name="org.kie.server.id" value="local-server-123"/>
   
       <!-- Data source properties. -->
       <property name="org.kie.server.persistence.ds" value="java:jboss/datasources/KieServerDS"/>
       <property name="org.kie.server.persistence.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
   </system-properties>

流程

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

   1. 运行以下命令以应用 kie-fs-realm 补丁：

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

   2. 打开每个 kie-fs-realm-users gcloud/<USER>.xml 文件，其中 <USER > 是 Red Hat Process Automation Manager 用户。
   3. 将 <attribute name="roles" value= 替换为 & lt;attribute name="role" value=。
2. 在终端应用中，前往 EAP_HOME/bin 目录。

3. 创建一个具有 admin、rest-all 和 kie-server 角色的用户，用来登录到 Business Central。

   注意

   具有 admin 角色的用户是 Business Central 管理员。具有 rest-all 角色的用户可以访问 Business Central REST 功能。具有 kie-server 角色的用户可以访问 KIE Server (KIE 服务器) REST 功能。对于需要访问 Business Central 中的 Manage 和 Track 视图的用户，需要有 kie-server 角色。

   在以下命令中，将 &lt ;USERNAME& gt ; 和 <PASSWORD > 替换为您选择的用户名和密码：

   $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password=<PASSWORD>}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,rest-all,kie-server])"

   注意

   确保指定的用户名与现有用户、角色或组不同。例如，不要创建用户名 admin 的用户。

   密码必须至少有 8 个字符，且必须至少包含一个数字，以及一个非字母数字字符，但不能包括 & (ampersand)。

4. 创建一个具有 kie-server 角色的用户，用于登录到 KIE Server。

   $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[kie-server])"

5. 记录您的用户名和密码。

6. 可选： 如果您在同一服务器实例中安装 Business Central 和 KIE 服务器，您可以创建具有这两个角色的单个用户：

   $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,rest-all,kie-server])"

   注意

   您应该在生产环境中的不同服务器上安装 Business Central 和 KIE 服务器。

7. 可选： 要一次创建多个用户，请创建一个包含用户数据的文件，并运行以下命令，其中 < USER_DATA>.cli 是包含用户数据的文件：

   $ ./bin/jboss-cli.sh --file=<USER_DATA>.cli

   <USER_DATA>.cli 文件应包含类似以下示例的数据：

   embed-server --std-out=echo
   
   # first user
   /subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>)
   /subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'})
   /subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,role,group])
   
   # second user
   ...

流程

1. 在 Red Hat Process Automation Manager 安装目录中，进入 standalone-full.xml 文件。例如，如果您为 Red Hat Process Automation Manager 使用 Red Hat JBoss EAP 安装，请转到 $EAP_HOME/standalone/configuration/standalone-full.xml。

2. 打开 standalone-full.xml 文件，并在 &lt ;system-properties& gt; 标签下设置以下 JVM 属性：

   表 14.1. KIE 服务器实例的 JVM 属性

   属性	值	备注
   org.kie.server.id	default-kie-server	KIE 服务器 ID。
   org.kie.server.controller	http://localhost:8080/business-central/rest/controller	Business Central 的位置。连接到 Business Central API 的 URL。
   org.kie.server.controller.user	controllerUser	具有角色 rest-all 的用户名，可以登录到 Business Central。
   org.kie.server.controller.pwd	controllerUser1234;	可以登录到 Business Central 的用户的密码。
   org.kie.server.location	http://localhost:8080/kie-server/services/rest/server	KIE 服务器的位置。连接到 KIE Server API 的 URL。

   表 14.2. Business Central 实例的 JVM 属性

   属性	值	备注
   org.kie.server.user	controllerUser	带有角色 kie-server 的用户名。
   org.kie.server.pwd	controllerUser1234;	用户的密码。

   以下示例演示了如何配置 KIE 服务器实例：

   <property name="org.kie.server.id" value="default-kie-server"/>
   <property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/>
   <property name="org.kie.server.controller.user" value="controllerUser"/>
   <property name="org.kie.server.controller.pwd" value="controllerUser1234;"/>
   <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>

   以下示例演示了如何为 Business Central 实例配置 ：

   <property name="org.kie.server.user" value="controllerUser"/>
   <property name="org.kie.server.pwd" value="controllerUser1234;"/>

3. 要验证 KIE 服务器是否已成功启动，请在 KIE 服务器运行时向 http://SERVER:PORT/kie-server/services/rest/server/ 发送 GET 请求。有关在 KIE 服务器中运行红帽流程自动化管理器的更多信息，请参阅 运行 Red Hat Process Automation Manager。

   成功验证后，您会收到类似以下示例的 XML 响应：

   <response type="SUCCESS" msg="Kie Server info">
       <kie-server-info>
           <capabilities>KieServer</capabilities>
           <capabilities>BRM</capabilities>
           <capabilities>BPM</capabilities>
           <capabilities>CaseMgmt</capabilities>
           <capabilities>BPM-UI</capabilities>
           <capabilities>BRP</capabilities>
           <capabilities>DMN</capabilities>
           <capabilities>Swagger</capabilities>
           <location>http://localhost:8230/kie-server/services/rest/server</location>
           <messages>
               <content>Server KieServerInfo{serverId='first-kie-server', version='7.5.1.Final-redhat-1', location='http://localhost:8230/kie-server/services/rest/server', capabilities=[KieServer, BRM, BPM, CaseMgmt, BPM-UI, BRP, DMN, Swagger]}started successfully at Mon Feb 05 15:44:35 AEST 2018</content>
               <severity>INFO</severity>
               <timestamp>2018-02-05T15:44:35.355+10:00</timestamp>
           </messages>
           <name>first-kie-server</name>
           <id>first-kie-server</id>
           <version>7.5.1.Final-redhat-1</version>
       </kie-server-info>
   </response>

4. 验证注册是否成功：

   1. 登录 Business Central。

   2. 点 Menu → Deploy → Execution Servers。

      如果注册成功，您将看到注册的服务器 ID。

1. 在 Red Hat Process Automation Manager 安装目录中，进入 standalone-full.xml 文件。例如，如果您为 Red Hat Process Automation Manager 使用 Red Hat JBoss EAP 安装，请转到 $EAP_HOME/standalone/configuration/standalone-full.xml。
2. 打开 standalone-full.xml 文件。
3. 在 & lt;system-properties > 标签下，将以下 JVM 属性的值设置为 CPU 数加上一：

流程

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

   • 产品： 流程自动化管理器
   • Version: 7.12
2. 下载 Red Hat Process Automation Manager 7.12.0 Add Ons ( rhpam-7.12.0-add-ons.zip 文件)。
3. 提取 rhpam-7.12.0-add-ons.zip 文件。rhpam-7.12.0-controller-ee7.zip 文件位于提取的目录中。
4. 将 rhpam-7.12.0-controller-ee7.zip 存档提取到临时目录。在以下示例中，此目录名为 TEMP_DIR。

5. 将 TEMP_DIR/rhpam-7.12.0-controller-ee7/controller.war 目录复制到 EAP_HOME/standalone/deployments/。

   警告

   确保您复制的无头进程 Automation Manager 控制器部署的名称不会与 Red Hat JBoss EAP 实例中的现有部署冲突。

6. 将 TEMP_DIR/rhpam-7.12.0-controller-ee7/SecurityPolicy/ 目录的内容复制到 EAP_HOME/bin。
7. 当提示覆盖文件时，请选择 是。
8. 在 EAP_HOME/standalone/deployments/ 目录中，创建一个名为 controller.war.dodeploy 的空文件。此文件确保服务器启动时会自动部署无头进程 Automation Manager 控制器。

流程

1. 在终端应用中，前往 EAP_HOME/bin。

2. 如果您在与安装 KIE Server 的 Red Hat JBoss EAP 实例相同的 Red Hat JBoss EAP 实例上安装了无头处理 Automation Manager 控制器，请输入以下命令之一：

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

     $ ./standalone.sh -c standalone-full.xml

   • 在 Windows 中：

     standalone.bat -c standalone-full.xml

3. 如果您在与安装 KIE 服务器的 Red Hat JBoss EAP 实例独立的 Red Hat JBoss EAP 实例上安装了无头处理 Automation Manager 控制器，请使用 standalone.sh 脚本启动无头进程 Automation Manager 控制器：

   注意

   在这种情况下，请确保您对 standalone.xml 文件进行了所有必要的配置更改。

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

     $ ./standalone.sh

   • 在 Windows 中：

     standalone.bat

4. 要验证无头进程 Automation Manager 控制器是否在 Red Hat JBoss EAP 上工作，请输入以下命令，其中 < CONTROLLER&gt ; 和 <CONTROLLER_PWD > 是您在 第 19.1.1 节 “创建无头进程 Automation Manager 控制器用户” 中创建的用户名和密码组合。此命令的输出提供有关 KIE 服务器实例的信息。

   curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H  "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'

流程

1. 在 pom.xml 文件中声明 Red Hat Business Automation BOM：

   <dependencyManagement>
    <dependencies>
     <dependency>
      <groupId>com.redhat.ba</groupId>
      <artifactId>ba-platform-bom</artifactId>
      <version>7.12.0.redhat-00008</version>
      <type>pom</type>
      <scope>import</scope>
     </dependency>
    </dependencies>
   </dependencyManagement>
   <dependencies>
   <!-- Your dependencies -->
   </dependencies>

2. 在 <dependencies> 标签中声明项目 所需的依赖项。将产品 BOM 导入到项目中后，定义了面向用户的产品依赖项的版本，因此您不需要指定这些 <dependency> 元素的 <version> 的子元素。但是，您必须使用 & lt;dependency > 元素来声明要在项目中使用的依赖项。

3. 对于未在 Business Central 中编写的独立项目，请指定项目所需的所有依赖关系。在您在 Business Central 中编写的项目中，业务中心会自动提供基本决策引擎和流程引擎依赖项。

   • 对于基本的 Red Hat Process Automation Manager 项目，请根据您要使用的功能声明以下依赖项：

     嵌入式进程引擎依赖项

     <!-- Public KIE API -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <!-- Core dependencies for process engine -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow-builder</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-bpmn2</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-runtime-manager</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-persistence-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-query-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-audit</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <!-- Dependency needed for default WorkItemHandler implementations. -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-workitems-core</artifactId>
     </dependency>
     
     <!-- Logging dependency. You can use any logging framework compatible with slf4j. -->
     <dependency>
       <groupId>ch.qos.logback</groupId>
       <artifactId>logback-classic</artifactId>
       <version>${logback.version}</version>
     </dependency>

   • 对于使用 CDI 的 Red Hat Process Automation Manager 项目，您通常声明以下依赖项：

     启用 CDI 的进程引擎依赖项

     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-services-cdi</artifactId>
     </dependency>

   • 对于基本的 Red Hat Process Automation Manager 项目，请声明以下依赖项：

     嵌入式决策引擎依赖项

     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-compiler</artifactId>
     </dependency>
     
     <!-- Dependency for persistence support. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-persistence-jpa</artifactId>
     </dependency>
     
     <!-- Dependencies for decision tables, templates, and scorecards.
     For other assets, declare org.drools:business-central-models-* dependencies. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-decisiontables</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-templates</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-scorecards</artifactId>
     </dependency>
     
     <!-- Dependency for loading KJARs from a Maven repository using KieScanner. -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-ci</artifactId>
     </dependency>

   • 要使用 KIE 服务器，请声明以下依赖项：

     客户端应用程序 KIE 服务器依赖项

     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-client</artifactId>
     </dependency>

   • 要为 Red Hat Process Automation Manager 创建远程客户端，请声明以下依赖项：

     客户端依赖项

     <dependency>
       <groupId>org.uberfire</groupId>
       <artifactId>uberfire-rest-client</artifactId>
     </dependency>

   • 在创建包含资产（如规则和进程定义）的 JAR 文件时，请将 Maven 项目的打包类型指定为 kjar，并使用 org.kie:kie-maven-plugin 来处理 < project > 元素下的 kjar 打包类型。在以下示例中，${kie.version} 是 Red Hat Process Automation Manager 和 Maven 库版本之间的映射中列出的 Maven 库版本？

     <packaging>kjar</packaging>
     <build>
      <plugins>
       <plugin>
        <groupId>org.kie</groupId>
        <artifactId>kie-maven-plugin</artifactId>
        <version>${kie.version}</version>
        <extensions>true</extensions>
       </plugin>
      </plugins>
     </build>

流程

1. 使用连接和访问外部存储库的详情，创建一个 Maven settings.xml 文件。有关 settings.xml 文件的详情，请查看 Maven Settings Reference。
2. 将文件保存到已知位置，例如 /opt/custom-config/settings.xml。
3. 在 Red Hat Process Automation Manager 安装目录中，进入 standalone-full.xml 文件。例如，如果您为 Red Hat Process Automation Manager 使用 Red Hat JBoss EAP 安装，请转到 $EAP_HOME/standalone/configuration/standalone-full.xml。

4. 打开 standalone-full.xml 并在 & lt;system-properties > 标签下，将 kie.maven.settings.custom 属性设置为 settings.xml 文件的完整路径名称。

   例如：

   <property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>

5. 启动或重新启动 Business Central 和 KIE 服务器.

流程

1. 在与公共互联网的传出连接的计算机上，完成以下步骤：

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

   • 产品： Red Hat Process Automation Manager

   • Version: 7.12

     1. 下载并提取 Red Hat Process Automation Manager 7.12.0 Offliner 内容列表 (rhpam-7.12.0-offliner.zip)产品提供可交付的文件。
     2. 将 rhpam-7.12.0-offliner.zip 文件的内容提取到任何目录中。

     3. 进入该目录并输入以下命令：

        ./offline-repo-builder.sh offliner.txt

        此命令会创建 存储库 子目录，并将所需的工件下载到此子目录中。这是镜像存储库。

        如果消息报告了一些下载失败，请再次运行相同的命令。如果下载再次失败，请联系红帽支持。

3. 如果您在 Business Central 之外开发服务，并且有额外的依赖项，请将依赖项添加到镜像存储库。如果将服务作为 Maven 项目开发，您可以使用以下步骤自动准备这些依赖项。在与公共互联网传出连接的计算机上完成步骤。

   1. 创建本地 Maven 缓存目录(~/.m2/repository)的备份，然后清除该目录。
   2. 使用 mvn clean install 命令构建项目源。

   3. 对于每个项目，输入以下命令来确保 Maven 下载项目生成的所有工件的所有运行时依赖项：

      mvn -e -DskipTests dependency:go-offline -f /path/to/project/pom.xml --batch-mode -Djava.net.preferIPv4Stack=true

      将 /path/to/project/pom.xml 替换为项目的 pom.xml 文件的路径。

   4. 将本地 Maven 缓存目录(~/.m2/repository)的内容复制到所创建的 存储库 子目录中。
4. 将存储库 子目录的内容复制到您在其上部署 Red Hat Process Automation Manager 的目录中。此目录成为离线 Maven 镜像存储库。
5. 为您的 Red Hat Process Automation Manager 部署创建和配置 settings.xml 文件，如 第 21.2 节 “为 Business Central 和 KIE 服务器配置外部 Maven 存储库” 所述。

6. 在 settings.xml 文件中进行以下更改：

   • 在 &lt ;profile& gt; 标签下，如果缺少 <repositories & gt; 或 <pluginRepositores > 标签，请添加缺少的标签。

   • 在 <repositories > 下添加以下内容：

     <repository>
       <id>offline-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     将 /path/to/repo 替换为本地 Maven 镜像存储库目录的完整路径。

   • 在 <pluginRepositories > 下添加以下内容：

     <repository>
       <id>offline-plugin-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     将 /path/to/repo 替换为本地 Maven 镜像存储库目录的完整路径。

7. 将 Business Central 的 kie.maven.offline.force 属性设置为 true。有关为 Business Central 设置属性的说明，请参阅在 Red Hat JBoss EAP 7.4 上安装和配置 Red Hat Process Automation Manager。

流程

1. 启动红帽 JBoss EAP 并在 Web 浏览器中打开 Business Central。
2. 将 SVG 格式镜像复制到红帽流程自动化管理器安装中的 EAP_HOME/standalone/deployments/ business-central.war/img/ 目录中。
3. 在 EAP_HOME/standalone/deployments/ business-central.war/img/ 目录中，移动或重命名现有的 redhat_logo.png 文件。
4. 重命名您的 PNG 文件 redhat_logo.png。
5. 要更改在 User name 和 Password 字段上方的项目徽标，请将默认镜像 BC_Logo.png 替换为一个新的 SVG 文件。
6. 强制完全重新加载登录页面，绕过缓存来查看更改。例如，在大多数 Linux 和 Windows Web 浏览器中，按 Ctrl+F5。

流程

1. 启动 Red Hat JBoss EAP，在 Web 浏览器中打开 Business Central，并使用您的用户凭证登录。
2. 将 SVG 格式的新应用程序标头镜像复制到红帽流程自动化管理器 安装中EAP_HOME/standalone/deployments/ business-central.war/banner/ 目录。
3. 在文本编辑器中打开 EAP_HOME/standalone/deployments/ business-central.war/banner/banner.html 文件。

4. 将 < img> 标签中的 logo.png 替换为新镜像的文件名：admin-and-config/

   <img src="banner/logo.png"/>

5. 强制完全重新加载登录页面，绕过缓存来查看更改。例如，在大多数 Linux 和 Windows Web 浏览器中，按 Ctrl+F5。

流程

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

   • 产品： Data Grid
   • Version: 8.1
2. 将 Red Hat Data Grid 8.1.0 Server (redhat-datagrid-8.1.0-server.zip)安装文件提取到系统上的首选位置。在以下示例中，提取的目录称为 JDG_HOME。
3. 将 Red Hat Data Grid 更新至最新版本。如需更多信息，请参阅 Red Hat Data Grid Red Hat Data Grid User Guide。

4. 要添加 Red Hat Data Grid 用户，请导航到 JDG_HOME/bin 并输入以下命令：

   $ ./cli.sh user create <DATAGRID_USER_NAME> -p <DATA_GRID_PASSWORD> -r default

5. 要更改 Red Hat Data Grid 服务器内存参数，请打开 JDG_HOME/bin/server.conf 文件并找到以下行：

   -Xms64m -Xmx512m -XX:MetaspaceSize=64M

6. 使用以下内容替换这一行：

   -Xms256m -Xmx2048m -XX:MetaspaceSize=256M

7. 打开 JDG_HOME/server/conf/infinispan.xml 文件并找到以下行：

   <hotrod-connector name="hotrod"/>

8. 使用以下内容替换这一行：

   <hotrod-connector name="hotrod">
       <authentication>
           <sasl mechanisms="SCRAM-SHA-512 SCRAM-SHA-384 SCRAM-SHA-256
                   SCRAM-SHA-1 DIGEST-SHA-512 DIGEST-SHA-384
                   DIGEST-SHA-256 DIGEST-SHA DIGEST-MD5 PLAIN"
               server-name="infinispan"
               qop="auth"/>
       </authentication>
   </hotrod-connector>

9. 要运行 Red Hat Data Grid，请导航到 JDG_HOME 并输入以下命令：

   $ ./server.sh -b <HOST>

   将 <HOST > 替换为安装 Red Hat Data Grid 的服务器的 IP 地址或主机名。

流程

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

   • 产品：AMQ Broker
   • Version: 7.8.2
2. 点 Red Hat AMQ Broker 7.8.2 旁边的 Download (amq-broker-7.8.2-bin.zip)。
3. 提取 amq-broker-7.8.2-bin.zip 文件。
4. 将目录更改为 amq-broker-7.8.2-bin/amq-broker-7.8.2/bin。

5. 输入以下命令来创建代理和代理用户：

   ./artemis create --host <HOST> --user <AMQ_USER> --password <AMQ_PASSWORD> --require-login <BROKER_NAME>

   在本例中，替换以下占位符：

   • <HOST > 是安装 AMQ Broker 的服务器的 IP 地址或主机名。
   • <AMQ_USER > 和 <AMQ_PASSWORD > 是您选择的用户名和密码组合。
   • <BROKER_NAME > 是您要创建的代理的名称。

6. 要运行 AMQ Broker，请导航到 amq-broker-7.8.2-bin/amq-broker-7.8.2/bin 目录，然后输入以下命令：

   <BROKER_NAME>/bin/artemis run

流程

1. 配置服务器以导出 NFS 版本 4 共享。有关在 Red Hat Enterprise Linux 上导出 NFS 共享的说明，请参阅 管理文件系统 中的 导出 NFS 共享。有关创建 NFS 服务器的详情，请参考 如何在 RHEL 7 中配置 NFS。
2. 在服务器上，在文本编辑器中打开 /etc/exports 文件。

3. 将以下行添加到 /etc/exports 文件中，其中 &lt ;HOST_LIST > 是被授权连接到服务器的主机的 IP 地址和选项的列表：

   /opt/kie/data <HOST_LIST>

   例如：

   /opt/kie/data 192.168.1.0/24(rw,sync) 192.168.1.1/24(no_root_squash)

   这会创建一个带有 rw,sync,no_root_squash 最小选项的 /opt/kie/data 共享，这些选项是 NFS 所需的。

   注意

   您可以使用不同的共享名称而不是 /opt/kie/data。如果这样做，配置运行 Business Central 的所有节点时，必须使用其他名称。

流程

1. 在集群的每个节点上下载 Red Hat JBoss EAP 7.4：

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

      • 产品：企业应用平台
      • Version: 7.4
   2. 点 Red Hat JBoss Enterprise Application Platform 7.4.1 旁边的 Download。(JBEAP-7.4.1/jboss-eap-7.4.1.zip).
2. 提取 jboss-eap-7.4.1.zip 文件。在以下步骤中，EAP_HOME 是 jboss-eap-7.4/jboss-eap-7.4 目录。
3. 下载并应用最新的红帽 JBoss EAP 补丁（如果可用）。

4. 在集群的每个节点上下载 Red Hat Process Automation Manager：

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

      • 产品：流程自动化管理器
      • Version: 7.12
   2. 下载 Red Hat Process Automation Manager 7.12.0 Business Central Deployable for Red Hat JBoss EAP 7 (rhpam-7.12.0- business-central-central-eap7-deployable.zip)。
5. 将 rhpam-7.12.0- business-central-eap7-deployable.zip 文件提取到临时目录中。在以下命令中，此目录名为 TEMP_DIR。
6. 将 TEMP_DIR/rhpam-7.12.0- business-central-eap7-deployable/jboss-eap-7.4 的内容复制到 EAP_HOME。
7. 下载并应用最新的红帽流程自动化管理器补丁（如果可用）。
8. 为您的高可用性环境配置红帽单点登录。如需更多信息，请参阅将 Red Hat Process Automation Manager 与 Red Hat Single Sign-On 和 Red Hat Single Sign-On 服务器管理指南 集成。

流程

1. 要将 NFS 共享的目录挂载为 /data，请以 root 用户身份输入以下命令：

   mkdir /data
   mount <NFS_SERVER_IP>:<DATA_SHARE> /data

   将 <NFS_SERVER_IP > 替换为 NFS 服务器系统的 IP 地址或主机名。将 <DATA_SHARE > 替换为您要配置的共享名称（例如 /opt/kie/data）。

2. 在 /data NFS 目录中创建一个 kie-wb-playground 目录：

   mkdir /kie-wb-playground

3. 在 EAP_HOME/bin 目录中创建一个 kie-wb-playground 目录并挂载目录：

   mount -o rw,sync,actimeo=1 <NFS_SERVER_IP>:<DATA_SHARE>/kie-wb-playground kie-wb-playground

4. 在文本编辑器中打开 EAP_HOME/standalone/configuration/standalone-full.xml 文件。

5. 编辑或添加 < system-properties& gt; 元素下的属性，并替换以下占位符：

   • <AMQ_USER & gt; 和 <AMQ_PASSWORD > 是您在创建 AMQ Broker 时定义的凭证。
   • <AMQ_BROKER_IP_ADDRESS > 是 AMQ Broker 的 IP 地址。
   • <DATA_GRID_NODE_IP > 是安装 Red Hat Data Grid 的 IP 地址。
   • <SERVER_NAME > 是 Red Hat Data Grid 服务器配置中指定的服务器名称。
   • <SASL_QOP> 是 Red Hat Data Grid 服务器配置的 auth, auth-int 和 auth-conf 值的组合。

   • <DATAGRID_USER_NAME & gt; 和 <DATA_GRID_PASSWORD > 是您在创建 Red Hat Data Grid 时定义的凭证。

     <system-properties>
       <property name="appformer-jms-connection-mode" value="REMOTE"/>
       <property name="appformer-jms-username" value="<AMQ_USER>"/>
       <property name="appformer-jms-password" value="<AMQ_USER_PASSWORD>"/>
       <property name="appformer-jms-url"
          value="tcp://<AMQ_BROKER_IP_ADDRESS>:61616?ha=true&amp;retryInterval=1000&amp;retryIntervalMultiplier=1.0&amp;reconnectAttempts=-1"/>
       <property name="org.appformer.ext.metadata.infinispan.port"
          value="11222"/>
       <property name="org.appformer.ext.metadata.infinispan.host"
          value="<DATA_GRID_NODE_IP>"/>
       <property name="org.appformer.ext.metadata.infinispan.realm"
          value="ApplicationRealm"/>
       <property name="org.appformer.ext.metadata.infinispan.cluster"
          value="kie-cluster"/>
       <property name="org.appformer.ext.metadata.index"
          value="infinispan"/>
       <property name="org.uberfire.nio.git.dir"
          value="/data"/>
       <property name="es.set.netty.runtime.available.processors"
          value="false"/>
       <property name="org.appformer.ext.metadata.infinispan.username" value="<DATAGRID_USER_NAME>"/>
       <property name="org.appformer.ext.metadata.infinispan.password" value="<DATA_GRID_PASSWORD>"/>
       <property name="org.appformer.ext.metadata.index" value="infinispan"/>
       <property name="org.appformer.ext.metadata.infinispan.sasl.qop" value="auth"/>
       <property name="org.appformer.ext.metadata.infinispan.server.name" value="infinispan"/>
       <property name="org.appformer.ext.metadata.infinispan.realm" value="default"/>
       <property name="org.appformer.concurrent.managed.thread.limit" value="1000"/>
       <property name="org.appformer.concurrent.unmanaged.thread.limit" value="1000"/>
       <property name="org.appformer.concurrent.indexing.thread.limit" value="0"/>
       <property name="org.appformer.ext.metadata.infinispan.server.name"
          value="<SERVER_NAME>"/>
       <property name="org.appformer.ext.metadata.infinispan.sasl.qop"
          value="<SASL_QOP>"/>
     </system-properties>

6. 保存 standalone-full.xml 文件。

7. 要启动集群，进入 EAP_HOME/bin 并输入以下命令：

   $ ./standalone.sh -c standalone-full.xml -b <HOST>

   将 <HOST > 替换为安装 Red Hat Process Automation Manager 的服务器的 IP 地址或主机名。

流程

1. 测试网络速度：

   1. 在每个服务器节点的命令终端中，安装 iPerf3 ：

      $ dnf install iperf3

   2. 在 NFS 服务器节点（服务器节点 3）的命令终端中，以服务器模式启动 iPerf3 ：

      $ iperf3 -s

   3. 在每个 Business Central 服务器节点的命令终端中，输入以下命令在客户端模式中启动 iPerf3，并将 NFS 服务器节点设置为主机：

      $ iperf3 -c <NFS_SERVER_IP>
      +
      In this example, replace `<NFS_SERVER_IP>` with the IP address of the NFS server.

   4. 将每个服务器节点的结果与以下最小值示例进行比较：

      iperf3 -c 172.31.47.103
      Connecting to host 172.31.47.103, port 5201
      [  5] local 172.31.39.4 port 44820 connected to 172.31.47.103 port 5201
      [ ID] Interval           Transfer     Bitrate         Retr  Cwnd
      [  5]   0.00-1.00   sec   143 MBytes  1.20 Gbits/sec    0    419 KBytes
      [  5]   1.00-2.00   sec   111 MBytes   928 Mbits/sec    6    848 KBytes
      [  5]   2.00-3.00   sec  53.8 MBytes   451 Mbits/sec    0   1.08 MBytes
      [  5]   3.00-4.00   sec  52.5 MBytes   440 Mbits/sec    1   1022 KBytes
      [  5]   4.00-5.00   sec  53.8 MBytes   451 Mbits/sec    1    935 KBytes
      [  5]   5.00-6.00   sec  53.8 MBytes   451 Mbits/sec    1    848 KBytes
      [  5]   6.00-7.00   sec  52.5 MBytes   440 Mbits/sec    0   1.08 MBytes
      [  5]   7.00-8.00   sec  53.8 MBytes   451 Mbits/sec    1   1.01 MBytes
      [  5]   8.00-9.00   sec  53.8 MBytes   451 Mbits/sec    1    953 KBytes
      [  5]   9.00-10.00  sec  52.5 MBytes   440 Mbits/sec    1    856 KBytes
      - - - - - - - - - - - - - - - - - - - - - - - - -
      [ ID] Interval           Transfer     Bitrate         Retr
      [  5]   0.00-10.00  sec   680 MBytes   570 Mbits/sec   12             sender
      [  5]   0.00-10.04  sec   677 MBytes   566 Mbits/sec                  receiver
      
      iperf Done.

2. 验证 NFS 信息：

   1. 在每个 Business Central 服务器节点的命令终端中，挂载 NFS 节点：

      $ mount -o actimeo=1 <NFS_SERVER_IP>:/opt/nfs/kie /opt/kie/niogit

   2. 在每个挂载的节点的命令终端中，输入 nfsiostat ：

      $ nfsiostat

   3. 将每个服务器节点的结果与以下最小值示例进行比较：

      nfsiostat
      ops/s	rpc bklog
      6.415	0.000
      
      read:
      ops/s	kB/s	kB/op	retrans	avg RTT (ms)	avg exe (ms)	avg queue (ms)	errors
      0.031	0.045	1.452	0 (0.0%)	0.129		0.166		0.019		0 (0.0%)
      
      write:
      ops/s	kB/s	kB/op	retrans	avg RTT (ms)	avg exe (ms)	avg queue (ms)	errors
      0.517	0.467	0.903	0 (0.0%)	1.235		1.269		0.01 8		0 (0.0%)

3. 验证磁盘是否为 SSD：

   1. 在 NFS 服务器的命令终端中，输入 df -h 来识别磁盘，如下例所示：

      $ df -h
      Filesystem               Size  Used Avail Use% Mounted on
      devtmpfs                 3.8G     0  3.8G   0% /dev
      tmpfs                    3.9G     0  3.9G   0% /dev/shm
      tmpfs                    3.9G   33M  3.8G   1% /run
      tmpfs                    3.9G     0  3.9G   0% /sys/fs/cgroup
      /dev/xvda2                25G  3.2G   22G  13% /
      tmpfs                    781M     0  781M   0% /run/user/1000
      172.31.47.103:/root/nfs   25G  2.1G   23G   9% /root/nfs

   2. 输入 lsblk -d 以验证磁盘是否为 SSD：

      $ lsblk -d

   3. 输入 hdparm -Tt 来测试磁盘：

      $ hdparm -Tt /dev/xvda2

   4. 将每个服务器节点的结果与以下最小值示例进行比较：

      $ hdparm -Tt /dev/xvda2
      
      /dev/xvda2:
       Timing cached reads:   18670 MB in  1.99 seconds = 9389.01 MB/sec
       Timing buffered disk reads: 216 MB in  3.03 seconds =  71.40 MB/sec

流程

1. 在 Web 浏览器中，输入 &lt ;node-IP-address>:8080/ business-central。将 <node-IP-address > 替换为特定节点的 IP 地址。
2. 输入您在安装过程中创建的 admin 用户凭证。此时会显示 Business Central 主页。
3. 选择 Menu → Design → Projects。
4. 打开 MySpace 空间。
5. 点 Try Samples → Mortgages → OK。此时会显示 Assets 窗口。
6. 点 Add Asset → Data Object。
7. 在 Data Object 字段中输入 MyDataObject，然后点 OK。
8. 点 Spaces → MySpace → Mortgages，并确认 MyDataObject 是否在资产列表中。

9. 在网页浏览器中输入以下 URL，其中 &lt ;node_IP_address > 是集群的不同节点的地址：

   http://<node_IP_address>:8080/business-central

10. 输入您用来登录到第一个节点上的 Business Central 的相同凭证，其中创建了 MyDataObject 资产。
11. 选择 Menu→ Design → Projects。
12. 打开 MySpace 空间。
13. 选择 Mortgages 项目。
14. 验证 MyDataObject 是否在资产列表中。
15. 删除 Mortgages 项目。

流程

1. 在集群的每个节点上下载 Red Hat JBoss EAP 7.4：

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

      • 产品：企业应用平台
      • Version: 7.4
   2. 点 Red Hat JBoss Enterprise Application Platform 7.4.1 旁边的 Download。(jboss-eap-7.4.1.zip)。
2. 提取 jboss-eap-7.4.1.zip 文件。jboss-eap-7.4/jboss-eap-7.4 目录称为 EAP_HOME。
3. 下载并应用最新的红帽 JBoss EAP 补丁（如果可用）。

4. 下载 KIE 服务器：

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

      • 产品：流程自动化管理器
      • Version: 7.12
   2. 下载 适用于所有支持的 EE8 容器的 Red Hat Process Automation Manager 7.12.0 KIE Server (rhpam-7.12.0-kie-server-ee8.zip)。
5. 将 rhpam-7.12.0-kie-server-ee8.zip 归档提取到临时目录中。在以下示例中，此目录名为 TEMP_DIR。

6. 将 TEMP_DIR/rhpam-7.12.0-kie-kie-server-ee8/rhpam-7.12.0-kie-server-ee8/kie-server.war 目录复制到 EAP_HOME/standalone/deployments/。

   警告

   确保您复制的 Red Hat Process Automation Manager 部署的名称不会与 Red Hat JBoss EAP 实例中的现有部署冲突。

7. 将 TEMP_DIR/rhpam-7.12.0-kie-kie-server-ee8/rhpam-7.12.0-kie-server-ee8/SecurityPolicy/ 复制到 EAP_HOME/bin。
8. 当提示覆盖文件时，点 替换。
9. 在 EAP_HOME/standalone/deployments/ 目录中，创建一个名为 kie-server.war.dodeploy 的空文件。此文件确保服务器启动时自动部署 KIE 服务器。
10. 下载并应用最新的红帽流程自动化管理器补丁（如果可用）。
11. 前往 EAP_HOME/bin 目录。

12. 创建一个具有 kie-server 角色的用户，用于登录到 KIE Server。

    $ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=['kie-server'])"

13. 记录您的用户名和密码。

流程

1. 在作为此集群一部分的所有红帽 JBoss EAP 实例上安装 JDBC 驱动程序。如需更多信息，请参阅 Red Hat JBoss EAP 7.4 配置指南中的 "JDBC 驱动程序"部分。
2. 在文本编辑器中打开 EAP_HOME/standalone/configuration/standalone-full.xml 文件。

3. 编辑 data-stores 属性以及上方的 timer-service thread-pool-name ：

   • datasource-jndi-name 是此流程开头上指定的数据库的 JNDI 名称。
   • 您可以为 partition 属性的值输入任何名称。但是，节点只能看到具有相同分区名称的其他节点的计时器。通过分配分区名称将节点分组到分区中，您可以将大型集群分成几个较小的集群。这样做可提高性能。例如，除了具有 100 个节点的集群外，所有 100 个节点都试图执行并刷新同一计时器，您可以通过为每个包括 5 个节点的组指定一个不同的分区名称来创建 20 个每个包括 5 个节点的集群。
   • 将 default-data-store 属性值替换为 ejb_timer_ds。

   • 以毫秒为单位设置 refresh-interval 的值，以指定 EJB 计时器连接到数据库的频率，以同步和加载要处理的任务。

     <timer-service thread-pool-name="default" default-data-store="ejb_timer_ds">
     <data-stores>
         <database-data-store name="ejb_timer_ds" datasource-jndi-name="java:jboss/datasources/ejb_timer" database="postgresql" partition="ejb_timer_part" refresh-interval="30000"/>
     </data-stores>
     </timer-service>

     下表列出了支持的数据库和对应的 数据库 属性值：

     表 29.1. 支持的数据库

     数据库	属性值
     Hyper SQL （仅用于演示目的，不支持）	hsql
     PostgreSQL	postgresql
     Oracle	oracle
     IBM DB2	db2
     Microsoft SQL Server	mssql
     MySQL 和 MariaDB	mysql

4. 将 KIE 服务器和 EJB 计时器数据源添加到 standalone-full.xml 文件。在这些示例中，&lt ;DATABASE& gt; 是数据库的名称，< SERVER_NAME&gt; 是 JNDI 数据库的主机名，< USER_NAME> 和 & lt;USER_PWD > 是该数据库的凭证。

   • 添加数据源以允许 KIE 服务器连接到数据库，例如：

     <xa-datasource jndi-name="java:/jboss/datasources/rhpam" pool-name="rhpam-RHPAM" use-java-context="true" enabled="true">
       <xa-datasource-property name="DatabaseName"><DATABASE></xa-datasource-property>
       <xa-datasource-property name="PortNumber">5432</xa-datasource-property>
       <xa-datasource-property name="ServerName"><SERVER_NAME></xa-datasource-property>
       <driver>postgresql</driver>
       <security>
         <user-name><USER_NAME></user-name>
         <password><USER_PWD></password>
     </security>
     </xa-datasource>

   • 添加数据源以启用 EJB 计时器，例如：

     <xa-datasource jndi-name="java:jboss/datasources/ejb_timer" pool-name="ejb_timer" use-java-context="true" enabled="true">
         <xa-datasource-property name="DatabaseName"><DATABASE></xa-datasource-property>
         <xa-datasource-property name="PortNumber">5432</xa-datasource-property>
         <xa-datasource-property name="ServerName"><SERVER_NAME></xa-datasource-property>
         <driver>postgresql</driver>
         <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
         <security>
             <user-name><USER_NAME></user-name>
             <password><USER_PWD></password>
         </security>
     </xa-datasource>

     警告

     您必须为 KIE 服务器运行时数据和 EJB 计时器数据使用两个不同的数据库。

5. 在 < system-properties > 元素中添加以下属性，并替换以下占位符：

   • <JNDI_NAME > 是数据源的 JNDI 名称。对于 Red Hat Process Automation Manager，这是 java:/jboss/datasources/rhpam。

   • <DIALECT> 是数据库的休眠位置。

     支持以下 dialects：

     • DB2： org.hibernate.dialect.DB2Dialect
     • MSSQL： org.hibernate.dialect.SQLServer2012Dialect
     • MySQL: org.hibernate.dialect.MySQL5InnoDBDialect
     • mariadb: org.hibernate.dialect.MySQL5InnoDBDialect
     • Oracle： org.hibernate.dialect.Oracle10gDialect
     • PostgreSQL： org.hibernate.dialect.PostgreSQL82Dialect

     • PostgreSQL 加上： org.hibernate.dialect.PostgresPlusDialect

       <system-properties>
         <property name="org.kie.server.persistence.ds" value="<JNDI_NAME>"/>
         <property name="org.kie.server.persistence.dialect" value="<DIALECT>"/>
         <property name="org.jbpm.ejb.timer.tx" value="true"/>
       </system-properties>

6. 保存 standalone-full.xml 文件。

7. 要启动集群，请导航到 EAP_HOME/bin 并输入以下命令之一：

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

     $ ./standalone.sh -c standalone-full.xml

   • 在 Windows 中：

     standalone.bat -c standalone-full.xml

流程

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

   • 产品：流程自动化管理器
   • Version: 7.12
2. 下载 Red Hat Process Automation Manager 7.12.0 Add Ons ( rhpam-7.12.0-add-ons.zip 文件)。
3. 提取 rhpam-7.12.0-add-ons.zip 文件。rhpam-7.12.0-controller-ee7.zip 文件位于提取的目录中。
4. 将 rhpam-7.12.0-controller-ee7.zip 存档提取到临时目录。在以下示例中，此目录名为 TEMP_DIR。

5. 将 TEMP_DIR/rhpam-7.12.0-controller-ee7/controller.war 目录复制到 EAP_HOME/standalone/deployments/。

   警告

   确保您复制的无头进程 Automation Manager 控制器部署的名称不会与 Red Hat JBoss EAP 实例中的现有部署冲突。

6. 将 TEMP_DIR/rhpam-7.12.0-controller-ee7/SecurityPolicy/ 目录的内容复制到 EAP_HOME/bin。
7. 当系统提示覆盖文件时，请单击 Yes。
8. 在 EAP_HOME/standalone/deployments/ 目录中，创建一个名为 controller.war.dodeploy 的空文件。此文件确保服务器启动时会自动部署无头进程 Automation Manager 控制器。
9. 在文本编辑器中打开 EAP_HOME/standalone/configuration/standalone.xml 文件。

10. 在 < system-properties> 元素中添加以下属性，并将 &lt ;NFS_STORAGE > 替换为存储模板配置的 NFS 存储的绝对路径：

    <system-properties>
      <property name="org.kie.server.controller.templatefile.watcher.enabled" value="true"/>
      <property name="org.kie.server.controller.templatefile" value="<NFS_STORAGE>"/>
    </system-properties>

    模板文件包含特定部署场景的默认配置。

    如果 org.kie.server.controller.templatefile.watcher.enabled 属性的值设置为 true，则启动一个单独的线程来监视模板文件的修改。这些检查的默认间隔为 30000 毫秒，可以由 org.kie.server.controller.templatefile.watcher.interval 系统属性进一步控制。如果此属性的值设为 false，则只有在服务器重启时，才会检测到模板文件的更改。

11. 要启动无头进程 Automation Manager 控制器，请导航到 EAP_HOME/bin 并输入以下命令：

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

      $ ./standalone.sh

    • 在 Windows 中：

      standalone.bat

流程

1. 准备环境：

   1. 验证 standalone.xml 文件中是否存在以下扩展，并根据需要添加它们：

      <extension module="org.jboss.as.clustering.infinispan"/>
      <extension module="org.jboss.as.clustering.jgroups"/>

   2. 在 standalone.xml 文件中，找到 &lt ;subsystem xmlns="urn:jboss:domain:infinispan:9.0" > 子系统，并创建一个名为 jbpm 的缓存的容器条目，其中包含一个名为 nodes 的缓存以及一个名为 jobs 的缓存，如下例所示：

      <cache-container name="jbpm">
        <transport lock-timeout="60000"/>
        <replicated-cache name="nodes">
            <transaction mode="BATCH"/>
        </replicated-cache>
        <replicated-cache name="jobs">
            <transaction mode="BATCH"/>
        </replicated-cache>
      </cache-container>

   3. 为复制和分布式缓存添加 jgroups 子系统：

      <subsystem xmlns="urn:jboss:domain:jgroups:7.0">
          <channels default="ee">
              <channel name="ee" stack="udp" cluster="ejb"/>
          </channels>
          <stacks>
              <stack name="udp">
                  <transport type="UDP" socket-binding="jgroups-udp"/>
                  <protocol type="PING"/>
                  <protocol type="MERGE3"/>
                  <socket-protocol type="FD_SOCK" socket-binding="jgroups-udp-fd"/>
                  <protocol type="FD_ALL"/>
                  <protocol type="VERIFY_SUSPECT"/>
                  <protocol type="pbcast.NAKACK2"/>
                  <protocol type="UNICAST3"/>
                  <protocol type="pbcast.STABLE"/>
                  <protocol type="pbcast.GMS"/>
                  <protocol type="UFC"/>
                  <protocol type="MFC"/>
                  <protocol type="FRAG3"/>
                </stack>
                <stack name="tcp">
                  <transport type="TCP" socket-binding="jgroups-tcp"/>
                  <socket-protocol type="MPING" socket-binding="jgroups-mping"/>
                  <protocol type="MERGE3"/>
                  <socket-protocol type="FD_SOCK" socket-binding="jgroups-tcp-fd"/>
                  <protocol type="FD_ALL"/>
                  <protocol type="VERIFY_SUSPECT"/>
                  <protocol type="pbcast.NAKACK2"/>
                  <protocol type="UNICAST3"/>
                  <protocol type="pbcast.STABLE"/>
                  <protocol type="pbcast.GMS"/>
                  <protocol type="MFC"/>
                  <protocol type="FRAG3"/>
                </stack>
            </stacks>
          </subsystem>

   4. 配置以下接口：

      <interface name="private">
          <inet-address value="${jboss.bind.address.private:127.0.0.1}"/>
      </interface>

   5. 配置以下套接字：

      <socket-binding name="jgroups-mping" interface="private" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/>
      
        <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
        <socket-binding name="jgroups-tcp-fd" interface="private" port="57600"/>
        <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/>
        <socket-binding name="jgroups-udp-fd" interface="private" port="54200"/>

2. 将 Infinispan 扩展添加到 KIE 服务器：

   1. 在文本编辑器中打开 kie-server.war/WEB-INF/jboss-deployment-structure.xml 文件，并将以下依赖项添加到文件中：

          <module name="org.infinispan" services="export"/>
          <module name="org.jgroups" />

   2. 下载 JAR 文件。

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

         • 产品： 流程自动化管理器
         • Version: 7.12
      2. 下载 Red Hat Process Automation Manager 7.12.0 Maven Repository (rhpam-7.12.0-maven-repository.zip)并提取 ZIP 文件。
      3. 导航到包含提取的文件的目录，并将 maven-repository/org/kie/kie/server/kie-server-services-jbpm-cluster/7.59.0.Final-redhat-00006/kie-server-services-jbpm-cluster-7.59.0.Final-redhat-00006.jar 文件复制到 kie-server.war/WEB-INF/lib 目录。

流程

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

   • 产品：流程自动化管理器
   • Version: 7.12
2. 下载 Red Hat Process Automation Manager 7.12.0 附加组件。
3. 将下载的 rhpam-7.12.0-add-ons.zip 文件提取到临时目录中。rhpam-7.12.0-smart-router.jar 文件位于提取的 rhpam-7.12.0-add-ons 目录中。
4. 将 rhpam-7.12.0-smart-router.jar 文件复制到您要运行该文件的位置。

5. 输入以下命令启动智能路由器：

   java
   -Dorg.kie.server.router.host=<ROUTER_HOST>
   -Dorg.kie.server.router.port=<ROUTER_PORT>
   -Dorg.kie.server.controller=<CONTROLLER_URL>
   -Dorg.kie.server.controller.user=<CONTROLLER_USER>
   -Dorg.kie.server.controller.pwd=<CONTROLLER_PWD>
   -Dorg.kie.server.router.config.watcher.enabled=true
   -Dorg.kie.server.router.repo=<NFS_STORAGE>
   -jar rhpam-7.12.0-smart-router.jar

   以上命令中的属性有以下默认值：

   org.kie.server.router.host=localhost
   org.kie.server.router.port=9000
   org.kie.server.controller= N/A
   org.kie.server.controller.user=kieserver
   org.kie.server.controller.pwd=kieserver1!
   org.kie.server.router.repo= <CURRENT_WORKING_DIR>
   org.kie.server.router.config.watcher.enabled=false

   org.kie.server.controller 是服务器控制器的 URL，例如：

   org.kie.server.controller=http://<HOST>:<PORT>/controller/rest/controller

   org.kie.server.router.config.watcher.enabled 是一个可选设置，以启用 watcher 服务系统属性。

   注意

   您可以使用配置文件，而不是在命令行中指定配置属性。有关使用文件配置智能路由器的详情，请参考 第 30.5 节 “使用配置文件配置智能路由器设置”。

6. 在必须连接到智能路由器的每个 KIE 服务器实例中，将 org.kie.server.router 系统属性设置为智能路由器 URL。

7. 要从客户端访问智能路由器，请使用 智能路由器 URL 而不是 KIE 服务器 URL，例如：

   KieServicesConfiguration config = KieServicesFactory.newRestConfiguration("http://smartrouter.example.com:9000", "USERNAME", "PASSWORD");

   在本例中，smartrouter.example.com 是 Smart Router URL，USERNAME 和 PASSWORD 是智能路由器配置的登录凭据。

8. 要在 umanaged KIE 服务器中创建新容器，以便您可以使用示例数据填充它，请发送以下 HTTP 请求：

   $ curl -v -X POST -H 'Content-type: application/xml' -H 'X-KIE-Content-Type: xstream' -d @create-container.xml -u ${KIE_CRED} http://${KIE-SERVER-HOST}:${KIE-SERVER-PORT}/kie-server/services/rest/server/config/

9. 查看 create-container.xml 文件的内容：

   <script>
     <create-container>
       <container container-id="example:timer-test:1.1">
         <release-id>
           <group-id>example</group-id>
           <artifact-id>timer-test</artifact-id>
           <version>1.1</version>
         </release-id>
         <config-items>
           <itemName>RuntimeStrategy</itemName>
           <itemValue>PER_PROCESS_INSTANCE</itemValue>
           <itemType></itemType>
         </config-items>
       </container>
     </create-container>
   </script>

   Smart Router 控制台中会显示有关部署容器的消息。例如：

   INFO: Added http://localhost:8180/kie-server/services/rest/server as server location for container example:timer-test:1.1

10. 要显示容器列表，请输入以下命令：

    $ curl http://localhost:9000/mgmt/list

    此时会显示容器列表：

    {
      "containerInfo": [{
        "alias": "timer-test",
        "containerId": "example:timer-test:1.1",
        "releaseId": "example:timer-test:1.1"
      }],
      "containers": [
        {"example:timer-test:1.1": ["http://localhost:8180/kie-server/services/rest/server"]},
        {"timer-test": ["http://localhost:8180/kie-server/services/rest/server"]}
      ],
      "servers": [
        {"kieserver2": []},
        {"kieserver1": ["http://localhost:8180/kie-server/services/rest/server"]}
      ]
    }

11. 要使用智能路由器 URL 启动进程，请输入以下命令：

    $ curl -s -X POST -H 'Content-type: application/json' -H 'X-KIE-Content-Type: json' -d '{"timerDuration":"9s"}' -u kieserver:kieserver1! http://localhost:9000/containers/example:timer-test:1.1/processes/timer-test.TimerProcess/instances

流程

1. 创建配置文件。此文件可以包含 property=value 格式的任意数量的行。

   该文件可以包含以下任何一个属性：所有属性都是可选的。

   表 30.2. 智能路由器配置文件中支持的属性

   属性名称	描述	默认值
   org.kie.server.router.id	智能路由器的标识符，以识别其他组件。	N/A
   org.kie.server.router.name	智能路由器的名称，用于识别其他组件。	N/A
   org.kie.server.router.host	运行智能路由器的机器的主机名	localhost
   org.kie.server.router.port	传入 HTTP 连接的端口。如果配置 TLS 连接，您可以将此属性设置为 0 以禁用 HTTP 连接。	9000
   org.kie.server.router.url.external	用于访问智能路由器的外部 URL	N/A
   org.kie.server.router.tls.port	传入 TLS 连接的端口	N/A
   org.kie.server.router.tls.keystore	TLS 连接的密钥存储文件	N/A
   org.kie.server.router.tls.keystore.password	TLS 连接的密钥存储密码	N/A
   org.kie.server.router.tls.keystore.keyalias	在密钥存储中引用 TLS 证书的别名名称	N/A
   org.kie.server.router.repo	用于存储当前存储库的目录	当前工作目录
   org.kie.router.identity.provider	用于使用智能路由器验证 KIE 服务器实例的可选自定义提供程序类。对于此接口的源代码，此类必须实施 org.kie.server.router.identity.IdentityManager 接口，请参阅 GitHub 存储库。	N/A
   org.kie.server.controller	连接到控制器的 URL	N/A
   org.kie.server.controller.user	连接到控制器的用户名	kieserver
   org.kie.server.controller.pwd	连接到控制器的密码	kieserver1!
   org.kie.server.controller.token	用于连接到控制器的身份验证令牌	N/A
   org.kie.server.controller.retry.interval	如果失败，重试与控制器的连接的时间间隔（以秒为单位）	10
   org.kie.server.controller.retry.limit	与控制器连接的最大重试次数（如果失败）	无限
   org.kie.server.router.config.watcher.enabled	如果设置为 true，智能路由器会定期扫描配置文件并应用任何更改	false
   org.kie.server.router.config.watcher.interval	重新扫描配置文件的时间间隔（以秒为单位）	5
   org.kie.server.router.management.password	如果设置为 true，则智能路由器需要密码来验证来自 KIE Server 的连接	false

2. 使用以下命令启动智能路由器：

   java -Dorg.kie.server.router.config.file=<CONFIG_FILE> -jar rhpam-7.12.0-smart-router.jar

   将 <CONFIG_FILE > 替换为配置文件的名称。

流程

1. 在终端窗口中，导航到您下载安装程序 JAR 文件的目录，然后输入以下命令：

   java -jar rhpam-installer-7.12.0.jar

   注意

   在 Windows 上运行安装程序时，可能会提示您在安装过程中提供管理员凭据。要防止此要求，请在安装命令中添加 izpack.mode=privileged 选项：

   java -Dizpack.mode=privileged -jar
   rhpam-installer-7.12.0.jar

   另外，在 32 位 Java 虚拟机上运行安装程序时，您可能会遇到内存限制。要防止这个问题，请运行以下命令：

   java -XX:MaxHeapSize=4g -jar
   rhpam-installer-7.12.0.jar

   图形安装程序显示启动屏幕和许可证协议页面。

2. 单击 I accept the terms of this license agreement，然后单击 Next。
3. 指定您要安装 Red Hat Process Automation Manager 的 Red Hat JBoss Web Server 5.5.1 服务器主页，然后点 Next。

4. 选择您要安装的组件，然后点 Next。

   您不能在红帽 JBoss Web 服务器上安装 Business Central。您只能在红帽 JBoss EAP 上安装它。但是，您可以在 Red Hat JBoss Web Server 上安装 KIE Server 和无头流程 Automation Manager 控制器。无头进程 Automation Manager 控制器用于管理 KIE 服务器。如果您计划管理多个 KIE 服务器实例，请安装无头进程的 Automation Manager 控制器。

5. 创建用户，然后单击下一步。默认情况下，如果您在同一容器中安装 Business Central 和 KIE Server，则新用户将获得 admin、kie-server 和 rest-all 角色。如果您只安装 KIE Server，则会给出 kie-server 角色。访问 KIE 服务器 REST 功能需要 kie-server 角色。

   注意

   确保指定的用户名与现有用户、角色或组不同。例如，不要创建用户名 admin 的用户。

   密码必须至少有 8 个字符，且必须至少包含一个数字，以及一个非字母数字字符，但不能包括 & (ampersand)。

   记录用户名和密码。您需要他们访问 Business Central 和 KIE 服务器。

6. 在 Installation Overview 页面中，查看您要安装的组件并点 Next 开始安装。
7. 安装完成后，单击 下一步。

8. 如果安装了 KIE Server，则 组件安装 下会显示 Configure Runtime 步骤。在 Configure Runtime Environment 页面中，选择执行默认安装或执行高级配置。

   如果您选择 Perform advanced configuration，您可以选择配置数据库设置或自定义某些 KIE Server 选项。

9. 如果您选择了 Customize database settings，在 JDBC Drive Configuration 页面中指定数据源 JDBC 驱动程序供应商，请选择一个或多个驱动程序 JAR 文件，然后单击 Next。

   数据源是一种对象，它允许 Java 数据库连接(JDBC)客户端（如应用服务器）与数据库建立连接。应用程序在 Java 命名和目录接口(JNDI)树或本地应用程序上下文中查找数据源，并请求数据库连接来检索数据。您必须为 KIE 服务器配置数据源，以确保服务器与指定数据库之间的正确数据交换。

10. 如果您选择了 Customize KIE Server properties，在 KIE Server Properties Configuration 页面中更改以下任何属性：

    • 更改 KIE 服务器 ID 的值，以更改 KIE Server 属性的名称。
    • 取消选择您要禁用的任何 KIE 服务器功能。
11. 点 Next 配置运行时环境。
12. 当在屏幕的顶部出现 Processing finished 时，点 Next 来完成安装。

13. 可选：点 Generate Installation Script and Properties File 将安装数据保存在 XML 文件中，然后点 Done。

    安装程序生成两个文件。auto.xml 文件自动执行将来的安装，auto.xml.variables 文件存储用户密码和其他敏感变量。使用 auto.xml 文件在多个具有相同类型的服务器以及与原始安装相同的配置的情况下重复 Red Hat Process Automation Manager 安装。如有必要，更新 auto.xml 文件中的 installpath 参数。要使用 XML 文件执行安装，请输入以下命令：

    java -jar rhpam-installer-7.12.0.jar <path-to-auto.xml-file>

流程

1. 在终端窗口中，进入您下载安装程序文件的目录，并输入以下命令：

   java -jar rhpam-installer-7.12.0.jar -console

   命令行交互流程将启动并显示最终用户许可协议。

   press 1 to continue, 2 to quit, 3 to redisplay.

2. 阅读许可证协议，输入 1，然后按 Enter 继续：

   Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7 or Red Hat JBoss Web Server 5. For more information, see https://access.redhat.com/articles/3405381[Red Hat Process Automation Manager 7 Supported Configurations].

3. 输入现有 Red Hat JBoss Web Server 5.5.1 安装的父目录。

   安装程序将在提供的位置验证安装位置。输入 1 确认并继续。

4. 按照安装程序中的说明完成安装。

   注意

   当您创建用户名和密码时，请确保指定的用户名与角色或组群的任何已知标题没有冲突。例如，如果有一个名为 admin 的角色，则不应创建一个名为 admin 的用户。

   密码必须至少有 8 个字符，且必须至少包含一个数字，以及一个非字母数字字符(不能包括字符 &)。

   记录用户名和密码。您需要他们访问 Business Central 和 KIE 服务器。

5. 安装完成后，您将看到这个信息：

   Would you like to generate an automatic installation script and properties file?

6. 输入 y 创建包含安装数据的 XML 文件，或输入 n 来完成安装。如果输入 y，系统会提示您指定 XML 文件的路径。

7. 输入路径或按 Enter 键接受推荐的路径。

   安装程序生成两个文件。auto.xml 文件自动执行将来的安装，auto.xml.variables 文件存储用户密码和其他敏感变量。在多个系统上使用 auto.xml 文件，在与原始安装相同的配置相同的服务器上轻松重复 Red Hat Process Automation Manager 安装。如有必要，更新 auto.xml 文件中的 installpath 参数。要使用 XML 文件执行安装，请输入以下命令：

   java -jar rhpam-installer-7.12.0.jar <path-to-auto.xml-file>

8. 如果您只安装 KIE Server，请重复这些步骤，以便在单独的服务器上安装无头进程 Automation Manager 控制器。

流程

1. 提取 rhpam-7.12.0-add-ons.zip 文件。

2. 从提取的 rhpam-7.12.0-add-ons.zip 文件中提取以下文件：

   • rhpam-7.12.0-kie-server-jws.zip
   • rhpam-7.12.0-process-engine.zip

   在以下说明中，包含提取的 rhpam-7.12.0-kie-server-jws.zip 文件的目录称为 JWS_TEMP_DIR，包含提取的 rhpam-7.12.0-process-engine.zip 文件的目录名为 ENGINE_TEMP_DIR。

3. 将 JWS_TEMP_DIR/rhpam-7.12.0-kie-server-jws/kie-server.war 目录复制到 JWS_HOME/tomcat/webapps 目录。

   注意

   确保您复制的 Red Hat Process Automation Manager 部署的名称不会与 Red Hat JBoss Web Server 实例中的现有部署冲突。

4. 从 kie-server.war 目录中删除 .war 扩展。
5. 将 kie-tomcat-integration-7.59.0.Final-redhat-00006.jar 文件从 ENGINE_TEMP_DIR 目录移到 JWS_HOME/tomcat/lib 目录。
6. 将 jboss-jacc-api-<VERSION>.jar,slf4j-api-<VERSION>.jar, 和 slf4j-jdk14-<VERSION>.jar 文件从 ENGINE_TEMP_DIR/lib 目录移动到 JWS_HOME/tomcat/lib 目录，其中 <VERSION > 是 lib 目录中的版本工件文件名。

7. 在上个 Valve 定义后，将以下行添加到 JWS_HOME/tomcat/conf/server.xml 文件中的 < host > 元素中：

   <Valve className="org.kie.integration.tomcat.JACCValve" />

8. 在文本编辑器中打开 JWS_HOME/tomcat/conf/tomcat-users.xml 文件。

9. 将用户和角色添加到 JWS_HOME/tomcat/conf/tomcat-users.xml 文件中。在以下示例中，< ROLE_NAME&gt; 是 Red Hat Process Automation Manager 支持的角色。<USER_NAME> 和 <USER_PWD> 是您选择的用户名和密码：

   <role rolename="<ROLE_NAME>"/>
   <user username="<USER_NAME>" password="<USER_PWD>" roles="<ROLE_NAME>"/>

   如果用户有多个角色，如下例所示，使用逗号分隔角色：

   <role rolename="admin"/>
   <role rolename="kie-server"/>
   <user username="rhpamUser" password="user1234" roles="admin,kie-server"/>

10. 在 JWS_HOME/tomcat/bin 目录中完成以下步骤之一：

    • 在 Linux 或 UNIX 中，使用以下内容创建 setenv.sh 文件：

      CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk"

    • 在 Windows 上，将以下内容添加到 setenv.bat 文件中：

      set CATALINA_OPTS=-Xmx1024m -Dorg.jboss.logging.provider=jdk

流程

1. 完成以下步骤以准备数据库：

   1. 将 rhpam-7.12.0-add-ons.zip 提取到临时目录中，如 TEMP_DIR。
   2. 提取 TEMP_DIR/rhpam-7.12.0-migration-tool.zip。
   3. 将您的当前目录更改为 TEMP_DIR/rhpam-7.12.0-migration-tool/ddl-scripts 目录。此目录包含多种数据库类型的 DDL 脚本。

   4. 将数据库类型的 DDL 脚本导入到您要使用的数据库中，例如：

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注意

      如果您将 PostgreSQL 或 Oracle 与 Spring Boot 结合使用，您必须导入相应的 Spring Boot DDL 脚本，如 /ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql 或 /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql。

2. 提取 rhpam-7.12.0-maven-repository.zip 离线 Maven 存储库文件。

3. 将提取的离线 Maven 存储库中的以下库复制到 JWS_HOME/tomcat/lib 文件夹，其中 VERSION 是该库的版本：

   org/jboss/spec/javax/transaction/jboss-transaction-api_1.2_spec/{VERSION}/jboss-transaction-api_1.2_spec-{VERSION}.jar
   org/jboss/integration/narayana-tomcat/{VERSION}/narayana-tomcat-{VERSION}.jar
   org/jboss/narayana/jta/narayana-jta/{VERSION}/narayana-jta-{VERSION}.jar
   org/jboss/jboss-transaction-spi/{VERSION}/jboss-transaction-spi-{VERSION}.jar

4. 将数据库 JDBC 驱动程序复制到 JWS_HOME/tomcat/lib 文件夹。

5. 在 JWS_HOME/tomcat/conf/context.xml 文件中配置池 XA 数据源：

   注意

   以下示例中的一些属性可能不适用于您的数据库服务器。检查您的 JDBC 驱动程序的文档，以确定要设置的属性。

   1. 配置 XA 数据源，无需池功能。此 XA 数据源用于创建到目标数据库的新连接。在以下示例中，AXx 数据源是 xads，变量在 表 36.1 “XA 数据源变量” 中定义：

      <?xml version="1.0" encoding="UTF-8"?>
      <Context>
      <Resource
      auth="Container"
      databaseName="${datasource.dbName}"
      description="XA Data Source"
      factory="org.apache.tomcat.jdbc.naming.GenericNamingResourcesFactory" loginTimeout="0"
      name="xads"
      uniqueName="xads"
      portNumber="${datasource.port}"
      serverName="${datasource.hostname}"
      testOnBorrow="false"
      type="${datasource.class}"
      url="${datasource.url}"
      URL="${datasource.url}"
      user="${datasource.username}"
      password="${datasource.password}"
      driverType="4"
      schema="${datasource.schema}"
      />
      </Context>

      表 36.1. XA 数据源变量

      变量	描述
      <datasource.dbName>	数据库的名称。
      <datasource.port>	数据库的端口号。
      <datasource.hostname>	数据库主机的名称。
      <datasource.class>	JDBC 驱动程序的 XADataSource 类。
      <datasource.url>	JDBC 数据库连接 URL。对于某些数据库，URL 属性是 url，而其他数据库（如 H2 数据库）此属性为 URL。
      <datasource.username>	数据库连接的用户名。
      <datasource.password>	数据库连接的密码。
      <datasource.schema>	数据库架构。

   2. 配置一个池数据源，该源依赖于 XA 数据源创建新连接。在本例中，数据源是 poolingXaDs，&lt;datasource.username > 是数据库连接的用户名，&lt ;datasource.password > 是数据库连接的密码：

      <?xml version="1.0" encoding="UTF-8"?>
      <Context>
      <Resource
      name="poolingXaDs"
      uniqueName="poolingXaDs"
      auth="Container"
      description="Pooling XA Data Source" factory="org.jboss.narayana.tomcat.jta.TransactionalDataSourceFactory" testOnBorrow="true"
      transactionManager="TransactionManager" transactionSynchronizationRegistry="TransactionSynchronizationRegistry" type="javax.sql.XADataSource"
      username="${datasource.username}"
      password="${datasource.password}"
      xaDataSource="xads"
      />
      </Context>

      数据源现在包括在 java:comp/env/poolingXaDs JNDI 名称下，并通过 org.kie.server.persistence.ds 系统属性传递给 KIE Server，如后续步骤中所述。

      注意

      池数据源配置依赖于之前在 kie-server 应用程序中的 context.xml 文件中配置的其他资源，特别是 TransactionManager 和 TransactionSynchronizationRegistry。

6. 将 KIE 服务器配置为使用数据源：

   1. 在文本编辑器中打开以下脚本之一：

      注意

      setenv.sh 或 setenv.bat 脚本应该已经存在。但是，如果没有，请创建它。

      • 对于 Linux 或 Unix：

        JWS_HOME/tomcat/bin/setenv.sh

      • 对于 Windows:

        JWS_HOME/tomcat/bin/setenv.bat

   2. 在 CATALINA_OPS 中添加以下属性，其中 & lt;hibernate.dialect > 是数据库的 Hibernate 空间：

      CATALINA_OPTS="-Xmx1024m
      -Dorg.jboss.logging.provider=jdk
      -Dorg.kie.server.persistence.ds=java:comp/env/poolingXaDs
      -Dorg.kie.server.persistence.tm=JBossTS
      -Dorg.kie.server.persistence.dialect=${<hibernate.dialect>}"

流程

1. 生成 Maven 项目。创建 Maven 项目时会自动生成 pom.xml 文件。

2. 编辑 pom.xml 文件，以添加更多依赖项和新存储库。

   在编译和打包项目时，Maven 从 Maven 存储库下载所有 JAR 文件和依赖 JAR 文件。

流程

1. 在 settings.xml 文件中，声明 Red Hat Process Automation Manager 项目使用的存储库。通常，这是您从红帽客户门户网站下载的在线红帽流程自动化管理器 Maven 存储库或 Red Hat Process Automation Manager Maven 存储库，以及用于您要使用的自定义工件的任何存储库。

2. 确保 Business Central 或 KIE 服务器被配置为使用 settings.xml 文件。例如，指定 kie.maven.settings.custom=<SETTINGS_FILE_PATH> 属性，其中 & lt;SETTINGS_FILE_PATH > 是 settings.xml 文件的路径。

   在 Red Hat JBoss Web 服务器上，对于 KIE Server，将 -Dkie.maven.settings.custom=<SETTINGS_FILE_PATH > 添加到 setenv.sh (Linux)或 setenv.bat (Windows)文件的 CATALINA_OPTS 部分。对于独立的 Business Central，请输入以下命令：

   java -jar rhpam-7.12.0-business-central-standalone.jar --cli-script=application-script.cli -Dkie.maven.settings.custom=<SETTINGS_FILE_PATH>

流程

1. 在 pom.xml 文件中声明 Red Hat Business Automation BOM：

   <dependencyManagement>
    <dependencies>
     <dependency>
      <groupId>com.redhat.ba</groupId>
      <artifactId>ba-platform-bom</artifactId>
      <version>7.12.0.redhat-00008</version>
      <type>pom</type>
      <scope>import</scope>
     </dependency>
    </dependencies>
   </dependencyManagement>
   <dependencies>
   <!-- Your dependencies -->
   </dependencies>

2. 在 <dependencies> 标签中声明项目 所需的依赖项。将产品 BOM 导入到项目中后，定义了面向用户的产品依赖项的版本，因此您不需要指定这些 <dependency> 元素的 <version> 的子元素。但是，您必须使用 & lt;dependency > 元素来声明要在项目中使用的依赖项。

3. 对于未在 Business Central 中编写的独立项目，请指定项目所需的所有依赖关系。在您在 Business Central 中编写的项目中，业务中心会自动提供基本决策引擎和流程引擎依赖项。

   • 对于基本的 Red Hat Process Automation Manager 项目，请根据您要使用的功能声明以下依赖项：

     嵌入式进程引擎依赖项

     <!-- Public KIE API -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <!-- Core dependencies for process engine -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-flow-builder</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-bpmn2</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-runtime-manager</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-persistence-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-query-jpa</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-audit</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <!-- Dependency needed for default WorkItemHandler implementations. -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-workitems-core</artifactId>
     </dependency>
     
     <!-- Logging dependency. You can use any logging framework compatible with slf4j. -->
     <dependency>
       <groupId>ch.qos.logback</groupId>
       <artifactId>logback-classic</artifactId>
       <version>${logback.version}</version>
     </dependency>

   • 对于使用 CDI 的 Red Hat Process Automation Manager 项目，您通常声明以下依赖项：

     启用 CDI 的进程引擎依赖项

     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-services-cdi</artifactId>
     </dependency>

   • 对于基本的 Red Hat Process Automation Manager 项目，请声明以下依赖项：

     嵌入式决策引擎依赖项

     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-compiler</artifactId>
     </dependency>
     
     <!-- Dependency for persistence support. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-persistence-jpa</artifactId>
     </dependency>
     
     <!-- Dependencies for decision tables, templates, and scorecards.
     For other assets, declare org.drools:business-central-models-* dependencies. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-decisiontables</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-templates</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-scorecards</artifactId>
     </dependency>
     
     <!-- Dependency for loading KJARs from a Maven repository using KieScanner. -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-ci</artifactId>
     </dependency>

   • 要使用 KIE 服务器，请声明以下依赖项：

     客户端应用程序 KIE 服务器依赖项

     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-client</artifactId>
     </dependency>

   • 要为 Red Hat Process Automation Manager 创建远程客户端，请声明以下依赖项：

     客户端依赖项

     <dependency>
       <groupId>org.uberfire</groupId>
       <artifactId>uberfire-rest-client</artifactId>
     </dependency>

   • 在创建包含资产（如规则和进程定义）的 JAR 文件时，请将 Maven 项目的打包类型指定为 kjar，并使用 org.kie:kie-maven-plugin 来处理 < project > 元素下的 kjar 打包类型。在以下示例中，${kie.version} 是 Red Hat Process Automation Manager 和 Maven 库版本之间的映射中列出的 Maven 库版本？

     <packaging>kjar</packaging>
     <build>
      <plugins>
       <plugin>
        <groupId>org.kie</groupId>
        <artifactId>kie-maven-plugin</artifactId>
        <version>${kie.version}</version>
        <extensions>true</extensions>
       </plugin>
      </plugins>
     </build>

流程

1. 在与公共互联网的传出连接的计算机上，完成以下步骤：

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

   • 产品： Red Hat Process Automation Manager

   • Version: 7.12

     1. 下载并提取 Red Hat Process Automation Manager 7.12.0 Offliner 内容列表 (rhpam-7.12.0-offliner.zip)产品提供可交付的文件。
     2. 将 rhpam-7.12.0-offliner.zip 文件的内容提取到任何目录中。

     3. 进入该目录并输入以下命令：

        ./offline-repo-builder.sh offliner.txt

        此命令会创建 存储库 子目录，并将所需的工件下载到此子目录中。这是镜像存储库。

        如果消息报告了一些下载失败，请再次运行相同的命令。如果下载再次失败，请联系红帽支持。

3. 如果您在 Business Central 之外开发服务，并且有额外的依赖项，请将依赖项添加到镜像存储库。如果将服务作为 Maven 项目开发，您可以使用以下步骤自动准备这些依赖项。在与公共互联网传出连接的计算机上完成步骤。

   1. 创建本地 Maven 缓存目录(~/.m2/repository)的备份，然后清除该目录。
   2. 使用 mvn clean install 命令构建项目源。

   3. 对于每个项目，输入以下命令来确保 Maven 下载项目生成的所有工件的所有运行时依赖项：

      mvn -e -DskipTests dependency:go-offline -f /path/to/project/pom.xml --batch-mode -Djava.net.preferIPv4Stack=true

      将 /path/to/project/pom.xml 替换为项目的 pom.xml 文件的路径。

   4. 将本地 Maven 缓存目录(~/.m2/repository)的内容复制到所创建的 存储库 子目录中。
4. 将存储库 子目录的内容复制到您在其上部署 Red Hat Process Automation Manager 的目录中。此目录成为离线 Maven 镜像存储库。
5. 为您的 Red Hat Process Automation Manager 部署创建和配置 settings.xml 文件，如 第 41.2 节 “修改 Maven 设置文件” 所述。

6. 在 settings.xml 文件中进行以下更改：

   • 在 &lt ;profile& gt; 标签下，如果缺少 <repositories & gt; 或 <pluginRepositores > 标签，请添加缺少的标签。

   • 在 <repositories > 下添加以下内容：

     <repository>
       <id>offline-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     将 /path/to/repo 替换为本地 Maven 镜像存储库目录的完整路径。

   • 在 <pluginRepositories > 下添加以下内容：

     <repository>
       <id>offline-plugin-repository</id>
       <url>file:///path/to/repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>

     将 /path/to/repo 替换为本地 Maven 镜像存储库目录的完整路径。

流程

1. 在 WebSphere Integrated Solutions 控制台中，点 Security → Global Security，并确保选择了 Enable Application Security 选项。这可能会在服务器级别选择并覆盖。
2. 点 Security Configuration Wizard 并点 Next。
3. 选择包含用户信息的存储库。例如，为本地配置选择 Federated 存储库。
4. 点 Next
5. 输入 Primary administrative user name 和 Password。
6. 单击 "下一步"，然后单击 "完成 "。

7. 点 Messages 窗口中的 Save，将您的更改保存到主配置中。

   图 47.1. 保存安全更新

   

8. 在命令终端中，导航到安装期间指定的 IBM WebSphere Application Server /bin 目录位置，并运行以下命令来停止并重启 IBM WebSphere 以应用安全更改：

   sudo ./stopServer.sh <SERVER_NAME>

   sudo ./startServer.sh <SERVER_NAME>

   将 <SERVER_NAME > 替换为 Servers → Server Types → IBM WebSphere Application Servers 控制台中定义的 IBM WebSphere Application Server 名称。

流程

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

   • 产品： 流程自动化管理器
   • Version: 7.12
2. 下载 Red Hat Process Automation Manager 7.12.0 附加组件。

3. 完成以下步骤以准备数据库：

   1. 将 rhpam-7.12.0-add-ons.zip 提取到临时目录中，如 TEMP_DIR。
   2. 提取 TEMP_DIR/rhpam-7.12.0-migration-tool.zip。
   3. 将您的当前目录更改为 TEMP_DIR/rhpam-7.12.0-migration-tool/ddl-scripts 目录。此目录包含多种数据库类型的 DDL 脚本。

   4. 将数据库类型的 DDL 脚本导入到您要使用的数据库中，例如：

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注意

      如果您将 PostgreSQL 或 Oracle 与 Spring Boot 结合使用，您必须导入相应的 Spring Boot DDL 脚本，如 /ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql 或 /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql。

4. 在 WebSphere Integrated Solutions 控制台中，导航到 Resources → JDBC → Data sources。
5. 选择应用程序可以使用数据源的范围。您可以选择单元、节点、集群或服务器。
6. 点 New 打开 Create a data source 向导。

7. 在 Data source name 字段中输入唯一名称，并在 JNDI name 字段中输入 Java Naming and Directory Interface (JNDI)名称。应用服务器使用 JNDI 名称将应用的资源引用绑定到此数据源。

   不要在不同的资源类型之间分配重复的 JNDI 名称，如数据源与 J2C 连接工厂或 JMS 连接工厂。

   不要为同一范围内相同类型的多个资源分配重复的 JNDI 名称。

8. 单击 Next，再选择 Select an existing JDBC provider if the provider is created, or select Create new JDBC provider 来定义新提供程序的详细信息。（建议此前创建 JDBC 提供程序，作为添加数据源的先决条件。）
9. 在 数据源面板的 Enter 数据库特定属性 上，如果容器管理持久性(CMP)企业级 Bean 必须访问此数据源，请单击 Use this data source in container managed persistence (CMP)。然后填写任何其他数据库特定属性。

10. 可选：为数据源配置安全别名。您可以为任何身份验证方法选择 None，或者选择以下类型之一：

    • 组件管理的身份验证别名： 指定在组件资源引用 res-auth 值是 Application 时使用的身份验证别名。要定义新别名，请导航到 Related Items → J2EE Connector Architecture (J2C)身份验证数据条目。组件管理的别名代表应用程序中指定的 ID 和密码组合，用于数据源身份验证。因此，您在数据源上设置的别名必须与应用程序代码中的别名相同。
    • mapping-configuration 别名： 仅在组件资源引用上没有登录配置时使用。当 res-auth 值设置为 Container 时，指定登录配置和组件资源引用的相关属性是定义身份验证策略的首选方法。如果您指定了 DefaultPrincipalMapping 登录配置，则 associated 属性是一个 JAAS - J2C 身份验证数据条目别名。
    • 容器管理的身份验证别名： 仅在组件资源引用上没有登录配置时使用。当 res-auth 值设置为 Container 时，登录配置以及组件资源引用上的关联属性决定了容器管理的验证策略。

11. 点 Next，查看数据源的信息，然后点 Finish 保存配置并退出向导。

    Data sources 面板在表中显示您的新配置，以及为同一范围配置的任何其他数据源。

流程

1. 在 WebSphere Integrated Solutions 控制台中，导航到 Servers → Server Types → IBM WebSphere Application Servers。
2. 在应用服务器列表中，选择您要在其上部署 KIE Server 的服务器。

3. 在 Server Infrastructure 下，点 Java and Process Management → Process Definition。

   图 47.2. WebSphere 配置页面

   

4. 在 附加属性 下，点 Java Virtual Machine。

   图 47.3. 进程定义配置页面

   

   这将打开用于启动 IBM WebSphere 的 JVM 的配置属性。

5. 将 Initial 堆大小 和 最大堆大小设置为 2048，然后单击 Apply 以增加 Java 虚拟机(JVM)内存大小。KIE 服务器已使用这些值进行测试。如果您没有增大 JVM 内存大小，IBM WebSphere Application Server 在部署 KIE 服务器时冻结或导致部署错误。
6. 在 附加属性 下，点 Custom Properties。

7. 点击 New → Custom JVM Properties 并在 IBM WebSphere 中添加以下属性：

   表 47.4. KIE 服务器的系统属性

   名称	值	描述
   kie.server.jms.queues.response	jms/KIE.SERVER.RESPONSE	用于 KIE 服务器使用的响应的 JMS 队列的 JNDI 名称。
   org.kie.server.domain	WSLogin	JAAS LoginContext 域，用于在使用 JMS 时对用户进行身份验证。
   org.kie.server.persistence.ds	jdbc/jbpm	KIE 服务器的数据源 JNDI 名称.
   org.kie.server.persistence.tm	org.hibernate.engine.transaction.jta.platform.internal.WebSphereJtaPlatform	用于设置 Hibernate 属性的事务管理器平台。
   org.kie.server.persistence.dialect	示例： org.hibernate.dialect.H2Dialect	指定要使用的 Hibernate dialect。根据数据源设置。
   org.kie.executor.jms.queue	JMS/KIE.SERVER.EXECUTOR	KIE 服务器的作业执行程序 JMS 队列.
   org.kie.executor.jms.cf	jms/cf/KIE.SERVER.EXECUTOR	KIE 服务器的作业执行者 JMS 连接工厂。
   org.kie.server.router	示例： http://localhost:9000	（可选）指定应用服务器是集群 KIE 服务器环境中的一个或多个 KIE 服务器路由器(Smart routers)的一个或多个 URL。
   org.jboss.logging.provider	jdk	只有在环境中安装 CA SiteMinder TAI (SMTAI) 时，才需要此属性。使用此属性强制 Hibernate 使用 JDK 而不是 log4j 在 Dashbuilder 中记录。CA SiteMinder TAI (SMTAI) 包含旧版本的 log4j，这会导致冲突。

8. 点 Save 将更改保存到主配置。

流程

1. 在 WebSphere Integrated Solutions 控制台中，点 Users and Groups → Manage Groups。
2. 在 Manage Groups 屏幕中，点 Create。
3. 在 Create a Group 屏幕中，在 组名称 框中输入 kie-server，然后单击 Create。
4. 要创建要添加到 kie-server 组的用户，请点击 Users and Groups → Manage Users。
5. 在 Create a User 屏幕中，完成所需信息。
6. 单击 Group Membership。
7. 在 Group Membership 屏幕中，单击 kie-server，将它移到 Mapped To，然后单击 Close。
8. 在 Create a User 屏幕上，单击 Create。

流程

1. 在 WebSphere Integrated Solutions 控制台中，导航到 Applications → Application Types → WebSphere Enterprise Applications，然后选择新安装的 kie-server 应用程序。
2. 在 Details Properties 下，点 Security Role to User/Group Mapping。
3. 选择 kie-server 角色，然后单击 Map Groups 以搜索 kie-server 组。

4. 将 kie-server 组从 Available 列表移到 Selected 列表中，再单击 OK。

   此映射可让 IBM WebSphere Application Server kie-server 组中的用户访问 KIE Server。

5. 点 Save 以完成映射。

流程

1. 导航到 Applications → Application Types → WebSphere Enterprise Applications，再点 kie-server。
2. 在左侧的 Details Properties 标题下，单击 Class Loading 和 Update Detection。
3. 在属性中，将 Class Loader Order 更改为 使用本地类加载器的类，首先（父） 和 WAR Class Loader Policy 用于应用程序。
4. 保存对主配置的更改。

流程

1. 要验证服务器是否正在运行，请完成以下任务之一：

   • 导航到 KIE Server URL http://<HOST>:<PORT>/kie-server。

   • 向 http://<HOST>:<PORT>/kie-server/services/rest/server 发送 GET 请求，以检查 KIE Server REST API 响应。

     在这些示例中，替换以下占位符：

     • <HOST > 是无头进程 Automation Manager 控制器的 ID 或名称，如 localhost 或 192.7.8.9。
     • <PORT > 是 KIE Server 主机的端口号，例如 9060。
2. 如果 KIE 服务器没有运行，请停止并重启 IBM WebSphere Application Server 实例，并尝试访问 KIE 服务器 URL 或 API。

流程

1. 导航到 Applications → Application Types → WebSphere Enterprise Applications，再点 kie-server。
2. 在左侧的 Details Properties 标题下，单击 Class Loading 和 Update Detection。
3. 在属性中，将 Class Loader Order 更改为 使用本地类加载器的类，首先（父） 和 WAR Class Loader Policy 用于应用程序。
4. 保存对主配置的更改。

流程

1. 在安装了无头进程 Automation Manager 控制器的应用程序服务器实例上指定以下 JVM 属性值：

   表 49.1. 无头进程 Automation Manager 控制器所需的属性

   名称	要求
   org.kie.server.user	具有 kie-server 角色的用户
   org.kie.server.pwd	org.kie.server.user 属性中指定的用户密码

2. 在安装了 KIE Server 的应用程序服务器实例中指定以下 JVM 属性值：

   表 49.2. 安装无头进程 Automation Manager 控制器时，KIE Server 的必要属性

   名称	要求
   org.kie.server.controller.user	具有 kie-server 角色的用户
   org.kie.server.controller.pwd	为 org.kie.server.controller.user 属性指定的用户的密码
   org.kie.server.id	KIE 服务器安装的 ID 或名称，如 rhdm700-decision-server-1
   org.kie.server.location	KIE 服务器的 URL、http://<HOST>:<PORT>/kie-server/services/rest/server
   org.kie.server.controller	无头进程 Automation Manager 控制器的 URL，http://<HOST>:<PORT>/controller/rest/controller

   <HOST > 是 KIE Server 主机的 ID 或名称，如 localhost 或 192.7.8.9。

   <PORT > 是 KIE Server 主机的端口号，如 7001。

流程

1. 在 WebSphere Integrated Solutions 控制台中，创建 kie-server 组和该组的用户，如创建 KIE Server 组和角色 中所述。
2. 导航到 Applications → Application Types → WebSphere Enterprise Applications，然后选择新安装的无头进程 Automation Manager 控制器。
3. 在 Details Properties 下，点 Security Role to User/Group Mapping。
4. 选择 kie-server 角色，然后单击 Map Groups 以搜索 kie-server 组。

5. 将 kie-server 组从 Available 列表移到 Selected 列表中，再单击 OK。

   此映射可让之前创建的管理员用户访问进程 Automation Manager。

6. 点 Save 以完成映射。

流程

1. 在 WebLogic 管理控制台中，单击 Security Realms。
2. 选择您所需的安全域或点 New 来创建新的安全域。
3. 导航到 Users and Groups → Groups → New，再创建 kie-server 组。
4. 导航到 Users → New 并创建新用户。

5. 输入用户，如 server-user，以及此新用户的密码，然后单击确定。

   重要

   确保所选用户名与角色或组的已知标题没有冲突。例如，如果有一个名为 kie-server 的角色，则不要创建具有用户名 kie-server 的用户。

6. 单击新创建的用户，然后返回到 组 选项卡。
7. 使用选择工具将 kie-server 组从 Available 字段移到 Chosen 字段，然后单击 Save。

流程

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

   • 产品： 流程自动化管理器
   • Version: 7.12
2. 下载 Red Hat Process Automation Manager 7.12.0 附加组件。

3. 完成以下步骤以准备数据库：

   1. 将 rhpam-7.12.0-add-ons.zip 提取到临时目录中，如 TEMP_DIR。
   2. 提取 TEMP_DIR/rhpam-7.12.0-migration-tool.zip。
   3. 将您的当前目录更改为 TEMP_DIR/rhpam-7.12.0-migration-tool/ddl-scripts 目录。此目录包含多种数据库类型的 DDL 脚本。

   4. 将数据库类型的 DDL 脚本导入到您要使用的数据库中，例如：

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注意

      如果您将 PostgreSQL 或 Oracle 与 Spring Boot 结合使用，您必须导入相应的 Spring Boot DDL 脚本，如 /ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql 或 /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql。

4. 在 WebLogic 管理控制台中，导航到 Change Center → Lock & Edit。
5. 在 Domain Structure 下，点 Services → Data Sources。
6. 在 Summary of Data Sources 页面中，点击 New → Generic Data Source。

7. 在 JDBC Data Sources Properties 页面中，输入或选择以下信息：

   • Name： 输入此 JDBC 数据源的名称。在配置文件(config.xml)和管理控制台中每当引用此数据源时使用此名称。
   • JNDI Name： 输入此 JDBC 数据源将被绑定的 JNDI 路径。应用在保留连接时通过此名称在 JNDI 树中查找数据源。
   • Database Type： 选择您要连接到的数据库的 DBMS。如果没有列出您的 DBMS，请选择 其他选项。
8. 单击 Next 以继续。
9. 选择您要用于 连接数据库的数据库驱动程序。列表包括所选 DBMS 的通用 JDBC 驱动程序，以及之前安装的任何其他 JDBC 驱动程序。

10. 在 Transaction Options 页面上，保留选择 Supports Global Transactions 选项，然后从可用的事务选项中选择。您还可以清除此复选框，以禁用此数据源中的全局事务（忽略）全局事务。在大多数情况下，应保留选择以优化数据效率的选项。

    • 2-Phase Commit：选择这个选项来启用标准 XA 处理。这个选项只有在您选择 XA JDBC 驱动程序来创建数据库连接时才可用。
    • logging Last Resource： 选择这个选项来启用非 XA JDBC 连接，以使用日志记录 Last Resource (LLR)事务优化来参与全局事务。建议将此选项代替 Emulate Two-Phase Commit。只有在您选择非 XA JDBC 驱动程序进行数据库连接时，此选项才可用。
    • 模拟两个Phase Commit： 选择这个选项来启用非 XA JDBC 连接，以使用 JTA 模拟参与分布式事务。只有在您的应用程序可以容忍 heuristic 条件时，才选择这个选项。只有在您选择非 XA JDBC 驱动程序进行数据库连接时，此选项才可用。
    • One-Phase Commit： 选择这个选项来启用非 XA 连接，以参与作为唯一的事务参与者的全局事务。只有在您选择非 XA JDBC 驱动程序进行数据库连接时，此选项才可用。
11. 单击 Next 以继续。

12. 在 Connection Properties 页面中，输入以下属性的值：

    • Service Name： 指定要连接的数据库的服务名称。如果提供了多个数据源，则每个数据源必须相同。只有在为 Oracle Real Application Clusters (RAC)选择了其中一个可用 service-instance 连接驱动程序时，此字段才可用。
    • 数据库名称 ： 输入您要连接到的数据库的名称。确切的数据库名称要求因 JDBC 驱动程序和 DBMS 而异。
    • Host Name ： 输入托管数据库的服务器的 DNS 名称或 IP 地址。如果您要创建 Oracle GridLink service-instance 连接，如果提供了多个数据源，则每个数据源必须相同。
    • 端口： 输入数据库服务器侦听连接请求的端口。
    • 数据库用户名： 输入您要用于数据源中的每个连接的数据库用户帐户名称。
    • password /Confirm Password： 输入数据库用户帐户的密码。
    • Oracle.jdbc.DRCPConnectionClass： 可选，如果您的环境需要，请输入 Database Resident Connection Pooling (DCRP)连接类。
13. 单击 Next 以继续。

14. 在 Test Database Connection 页面上，检查连接参数，再单击 Test Configuration。

    Oracle WebLogic Server 尝试从管理服务器创建与数据库的连接。连接测试的结果会显示在页面的顶部。如果测试失败，请更正任何配置错误并重试测试。

15. 如果您在管理服务器上未安装 JDBC 驱动程序，请单击 Next 以继续或跳过这一步。
16. 在 Select Targets 页面中，选择要在其上部署数据源的服务器或集群，然后点击 Finish。
17. 返回到 WebLogic 管理控制台的主菜单，并选择 Change Center → Activate Changes。