起步指南

1. 进入 Red Hat Customer Portal 并登陆。
2. 选择 Downloads → Red Hat JBoss Middleware → Download Software。
3. 从 Product 下拉菜单里，选择 BRMS Platform。
4. 从“Version”下拉菜单里，选择版本 6.0.2。
5. 选择 Red Hat JBoss BRMS 6.0.2 Deployable for EAP 6.1.1 并单击 Download。

1. 移动下载的 ZIP 文件到Red Hat JBoss EAP 的主目录 （EAP_HOME，jboss-eap-6.1 目录）。
2. 解压下载的 ZIP 归档文件：确保它合并到 EAP_HOME 目录 (jboss-eap-6.1)。

   警告

   这个步骤必须由之前安装 EAP 的同一个用户帐号来执行。这个帐号不能是超级用户帐号。
3. 你需要用下载的 ZIP 文件里的版本覆盖现有的 EAP_HOME 里的文件。在遇到提示时，请覆盖原来的文件。

1. 下载 ZIP 文件并准备手动合并文件到 Red Hat JBoss EAP 的主目录 （EAP_HOME，jboss-eap-6.1 目录）。
2. 解压下载的 ZIP 归档；然而，请不要覆盖所有的文件。将下列文件手动合并到EAP_HOME（jboss-eap-6.1 目录）。
   • jboss-eap-6.1/domain/configuration/*
   • jboss-eap-6.1/standalone/configuration/*
   • jboss-eap-6.1/modules/layers.conf
   • jboss-eap-6.1/bin/product.conf

   警告

   请确保这个步骤是由安装 EAP 的用户帐号执行的。这个帐号不能是超级用户帐号。
3. 请确保目标 EAP 没有包含会导致名称冲突的部署。将文件夹 jboss-eap-6.1/standalone/deployments 从 BRMS 复制到 EAP_HOME 目录。
4. 请确保没有名为 BRMS 的 EAP 模块层并将文件夹 jboss-eap-6.1/modules/system/layers/brms 复制到 EAP 6.1.1 文件夹。

1. 从 bin 目录里运行 add-user.sh（类 Unix 系统）或 add-user.bat（Windows）。
2. 在用户类型提示下输入 b 选择 “Application User”并按 Enter。
3. 按 Enter 接受默认的 Realm (ApplicationRealm) 选项。
4. 在用户名提示下，输入用户名并确认。例如：helloworlduser。
5. 在密码提示里输入用户的密码两次。例如： Helloworld@123。

   注意

   密码应该至少有 8 个字符，且包含大写和小写字母（A-Z, a-z），且至少有一个数字（0-9）和至少一个特殊字符（如 ~ ! @ # $ % ^ * ( ) - _ + =）。
6. 在角色提示里输入用逗号隔开的角色列表（请参考 第 3.3 节 “定义角色”）。
   商业中心用户需要具有 analyst 或 admin 角色。
7. 确认你要添加这个用户。
8. 在下一个提示里输入 yes（这是为了有需要时启用群集）。

过程 3.1. 安装 Generic Deployable Package

1. 要从红帽客户支持门户下载 Generic Deployable Package，请登录 https://access.redhat.com。
2. 选择 Downloads → Red Hat JBoss Middleware → Download Software。
3. 从 Product 下拉菜单里，选择 BRMS Platform。
4. 从 Version 下拉菜单里，选择产品版本。
5. 选择 Red Hat JBoss BRMS 6.0.2 Deployable for all supported containers 并点击 Download。
6. 解压下载的归档文件并创建下面的 ZIP 归档：
   • jboss-brms-engine.zip
   • jboss-brms-manager.zip
7. 从 jboss-brms-manager.zip 里解压 business-central.war 并复制到 tomcat7/webapps/。
8. 从 business-central.war 删除 .war 扩展，所以这个目录现在是 business-central。
9. 在 tomcat7/conf/tomcat-users.xml 里定义用户和角色如下：

     <role rolename="admin"/>
     <role rolename="analyst"/>
     <user username="user" password="password" roles="admin,analyst"/>

   Copy to Clipboard Toggle word wrap
10. 编辑 tomcat7/webapps/business-central/WEB-INF 里的 web.xml 文件，取消所有用 TOMCAT-JEE-SECURITY 标记的条目的注释。

    <!-- TOMCAT-JEE-SECURITY -->
        <!--
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
        -->
    
    

    Copy to Clipboard Toggle word wrap
    应该像这样取消注释：

    <!-- TOMCAT-JEE-SECURITY -->
    
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
    
    

    Copy to Clipboard Toggle word wrap
11. 从 BRMS 的 business-central/WEB-INF/lib 里复制 kie-tomcat-integration-VERSION.jar 文件到 tomcat7/lib。
12. 从 BRMS 的 business-central/WEB-INF/lib 里复制 slf4j-api-VERSION.jar 和 slf4j-ext-VERSION.jar 文件到 tomcat7/lib。
13. 下载下面的文件并放入 tomcat7/lib 目录。
    • javax.security.jacc-api.jar
14. 添加下列 Tomcat Valve 声明到 tomcat7/conf/server.xml（在相关的 <host> 元素内部）：

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

    Copy to Clipboard Toggle word wrap
15. 将 business-central/WEB-INF/classes/META-INF/services 里的 org.uberfire.security.auth.AuthenticationSource 重命名为 org.uberfire.security.auth.AuthenticationSource-ORIGIN，并将org.uberfire.security.auth.AuthenticationSource-TOMCAT-JEE-SECURITY 重命名为 org.uberfire.security.auth.AuthenticationSource。
16. 在 tomcat7/bin 目录里运行 startup.sh 启动 JBoss Web 服务器。

    ./startup.sh

    Copy to Clipboard Toggle word wrap
17. 在 Web 浏览器里访问 http://localhost:8080/business-central。
18. 用你定义用户角色的 tomcat-users.xml 文件提供的正确用户名和密码登录。

1. 在命令行，进入 $SERVER_HOME/bin/ 目录。
2. 在 Unix 环境里，请运行：

   ./standalone.sh

   Copy to Clipboard Toggle word wrap
   在 Windows 环境里，请运行：

   ./standalone.bat

   Copy to Clipboard Toggle word wrap

1. 在命令行，进入 $SERVER_HOME/bin/ 目录。
2. 在 Unix 环境里，请运行：

   ./standalone-secure.sh

   Copy to Clipboard Toggle word wrap
   在 Windows 环境里，请运行：

   ./standalone-secure.bat

   Copy to Clipboard Toggle word wrap

1. 在浏览器里打开商业中心（如果在本地则运行 http://localhost:8080/business-central）并用具有 admin 角色（helloworlduser）的用户登录。
2. 在 Artifact 资料库里创建一个组织单元：
   1. 进入 Authoring → Administration。
   2. 在 perspective 菜单上，点击 Organizational Units → Manage Organizational Units。
   3. 在显示的 Organizational Unit Manager 视图里，点击 Add。
      在显示的 Add New Organizational Unit 对话框里，定义单元属性并点击 OK：
      • 名称：helloworld
      • 所有者：helloworlduser
3. 在 helloworld 组织单元里创建新的资料库：
   1. 进入 Authoring → Administration。
   2. 在 perspective 菜单上，点击 Repositories → New repository。
   3. 在显示的 Create Repository 对话框里，定义资料库属性：
      • 资料库名称：helloworldrepo
      • 组织单元：helloworld
4. 进入 Authoring → Project Authoring。
5. 在组织单元的下拉菜单里的 Project Explorer 里，选择 helloworld，然后在资料库下拉菜单里选择 helloworldrepo。
   

   View larger image

   

   图 5.1. 在 Project Explorer 里的 helloworld 组织单元里选择 helloworldrepo 资料库

6. 在 helloworld 资料库里创建一个项目：
   1. 在 perspective 菜单上，点击 New Item → Project。
   2. 在显示的 Create new 对话框里，定义项目属性：
      • 资源名称（项目名称）：HelloWorld
      • 路径：default://master@helloworldrepo/
   3. 在 New Project Wizard 对话框里，定义项目的 Maven 属性。在输入每个条目后按 Enter 确认：
      • Group ID: org.brms
      • Artifact ID: HelloWorld
      • Version ID: 1.0
   4. 点击 Finish。

1. 在 Project Explorer 里，选择 helloworld 组织单元、 helloworldrepo 资料库、HelloWorld 项目和 default 软件包。

   注意

   请确保选择了 default 软件包。选择错误的软件包会导致部署失败。
2. 创建 DRL 文件：
   1. 在 perspective 菜单上，点击 New Item → DRL file。
   2. 在 Create new 对话框里，定义资源名为 helloworldrule 并检查目的路径是 default://master@helloworldrepo/HelloWorld/src/main/resources。
   3. 点击确定。
3. 在 DRL 编辑器里打开 helloworldrule.drl 文件，定义规则：

   rule "helloworldrule"
   ruleflow-group "helloworldgroup"
   when 
   then
   	System.out.println("Hello World!");
   end
   

   Copy to Clipboard Toggle word wrap
   这个规则没有定义任何 when 条件，也就是被调用时总是为 true，所以 Hello World! 短语将被输出。
4. 点击 Save。
5. Save this item 提示将会出现。输入 Check-in comment 并点击 Save。

   注意

   check-in 评论可以是对你所作修改的简单描述，在每次保存资产时都应输入。

1. 在商业中心的主菜单里，进入 Authoring → Project Authoring。
2. 在 Project Explorer 里，找到 Hello World 项目。
3. 在项目编辑器里打开项目，在 perspective 菜单上，点击 Tools → Project Editor。
4. 检查 Project Screen 上显示的项目细节并点击 Project Screen 视图右上方的 Build & Deploy 按钮。
   

   View larger image

   

   图 5.2. 显示 helloWorld 项目属性的项目编辑器

过程 6.1. 安装 Drools JBoss Developer Studio 插件

1. 启动 JBoss Developer Studio。
2. 选择 Help → Install New Software。
3. 点击 Add 进入 Add Repository 菜单。
4. 在 Name 之后的字段里为软件站点命名，并在 Location 字段添加下列 URL：https://devstudio.jboss.com/updates/7.0/integration-stack/。
5. 点OK
6. 从可用选项里选择 JBoss Business Process and Rule Development 功能并点击 Next，然后再次点击 Next。
7. 阅读许可证并选择合适的单选按钮接受它，然后点击 Finish。
8. 在插件安装完成后重启 JBoss Developer Studio。

过程 6.2. 配置 BRMS Runtime

1. 从 JBoss Developer Studio 菜单，选择 Window 并单击 Preferences。
2. 选择 Drools → Installed Drools Runtimes。
3. 单击 Add...，输入新 runtime 的名称，单击 Browse 进入 runtime 所在的目录。然后点击 OK 在 JBDS 里注册所选的 runtime。
4. 单击旁边的复选框将你创建的 runtime 标记为默认的 Drools runtime。
5. 点击 OK。如果你有现存的项目，将出现一个对话框，提示你重启 JBoss Developer Studio 来更新 Runtime。

过程 6.3. 配置服务器

1. 选择 Window → Open Perspective → Other 以及 Drools，然后点击 OK 来打开 Drools 视图。
2. 通过选择 Window → Show View → Other... 并选择 Server → Servers 来添加服务器视图。
3. 右击 Servers 面板并选择 New → Server 来打开服务器菜单。
4. 选择 JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.1+ 并点击 Next 来定义服务器。
5. 点击 Add... 链接和 Browse 按钮来设置主目录。选择已安装了 JBoss BRMS 的 JBoss EAP 6.1.1 的安装目录。
6. 在 Name 字段里输入服务器的名称，确保配置文件被设置为 standalone.xml 并点击 Finish。

过程 6.4. 导入本地 GIT 资料库

1. 从 Server 标签页里选择服务器并点击 Start 图标来启动 Red Hat JBoss BRMS 服务器（如果还未运行）。
2. 选择 File → Import... 并导航至 Git 文件夹。打开 Git 文件夹以选择 Projects from Git 并点击 Next。
3. 选择资料库源为Existing local repository 并点击 Next。
   

   View larger image

   

   图 6.1. GIT 资料库细节

4. 从可用资料库里选择要配置的资料库。
5. 在下一窗口将这个项目导入为普通项目并点击 Next。为它命名并点击 Finish。

过程 6.5. 克隆远程的 GIT 资料库

1. 从 Server 标签页里选择服务器并点击 Start 图标来启动 Red Hat JBoss BRMS 服务器（如果还未运行）。
2. 使用下列命令同时启动 Secure Shell 服务器（如果还有在运行）。这个命令是 Linux 和 Mac 专有的。在其他平台上，如果已经启动了 sshd，这个命令会失败，您可以忽略这个步骤。

   /sbin/service sshd start

   Copy to Clipboard Toggle word wrap
3. 选择 File → Import... 并导航至 Git 文件夹。打开 Git 文件夹以选择 Projects from Git 并点击 Next。
4. 选择资料库源为 Clone URI 并点击 Next。
5. 在下一个窗口输入 GIT 资料库的细节并点击 Next。

   

   View larger image

   

   图 6.2. GIT 资料库细节

6. 在下一个窗口选择你要导入的分支并点击 Next。
7. 你会被提示是否为这个项目定义本地存储。输入（或选择）一个非空目录，修改配置并点击 Next。
8. 在下一窗口将这个项目导入为普通项目并点击 Next。为它命名并点击 Finish。

过程 6.6. 创建一个新的 Red Hat JBoss Developer Studio 项目

1. 从主菜单里，选择 File → New → Project。
   选择 Drools → Drools Project 并点击 Next。
2. 在 Project name: 文本框里输入项目的名称并点击 Next。

   注意

   JBoss Developer Studio 提供添加 HelloWorld 规则文件示例到项目里的选项。点击 Next 可以接受并用下列步骤测试项目示例。
3. 选择 Drools runtime（或使用默认值）。
4. 选择和 Drools 6.0.x 兼容的代码。输入 GroupID、ArtifactID 和 Version，然后点击 Finish。
5. 要测试这个项目，右击包含 main 方法的 Java 文件并选择 Run → run as → Java Application。
   输出会显示在 Console 标签页上。

1. 访问 Red Hat Customer Portal 并用你的用户凭证登录。
2. 选择 Downloads → Red Hat JBoss Middleware → Download Software。
3. 从 Products 下拉菜单里，选择 BPM Suite。
4. 从 Version 下拉菜单里，选择产品版本 6.0.2。
5. 选择 Red Hat JBoss BPM Suite 6.0.2 Business Resource Planner 并点击 Download。

1. 在命令行上，进入 examples/ 目录。
2. 在 Unix 环境里，运行下列命令：

   ./runExamples.sh

   Copy to Clipboard Toggle word wrap
   在 Windows 里，运行下列命令：

   ./runExamples.bat

   Copy to Clipboard Toggle word wrap
3. 从 GUI 程序范例里挑选一个例程并在你的 IDE 里运行它。