BRMS 管​理​员​指​南​

过程 2.1. 安​装​独​立​软​件​包​

1. 下​载​

   从​红​帽​客​户​支​持​入​口​ https://access.redhat.com 下​载​独​立​软​件​包​ ZIP 文​件​。​进​入​ Downloads - BRMS Platform，然​后​选​择​版​本​。​当​前​的​版​本​是​ 5.2.0。​下​面​所​有​的​说​明​都​采​用​ 5.2.0 软​件​包​名​，但​除​非​特​别​注​明​，它​也​可​应​用​于​早​期​版​本​。​

2. 解​压​

   独​立​软​件​包​包​含​带​有​已​作​为​展​开​归​档​部​署​的​ JBoss 企​业​级​ BRMS 平​台​的​ JBoss 企​业​级​ Web 平​台​。​解​压​ ZIP 文​件​到​这​个​安​装​目​录​。​

   [localhost ]$ unzip brms-standalone-5.2.0.zip

   Copy to Clipboard Toggle word wrap
   JBoss 企​业​级​ BRMS 平​台​部​署​在​ production 以​及​ default 服​务​器​配​置​里​：brms-standalone-5.2.0/jboss-as-web/server/PROFILE/deploy/jboss-brms.war/。​

   注意

   如​上​所​示​，本​指​南​在​目​录​路​径​里​使​用​ PROFILE 来​指​定​ production 或​ default 配​置​。​

3. 启​用​用​户​

   缺​省​的​配​置​使​用​ brms JAAS 应​用​程​序​配​置​。​这​个​配​置​在​ PROFILE/conf/props/brms-users.properties 文​件​里​存​储​用​户​名​和​密​码​。​
   你​可​以​通​过​在​这​个​文​件​里​添​加​条​目​来​增​加​用​户​，其​格​式​是​ username=password。​在​一​行​的​开​始​使​用​井​字​符​（#）可​以​注​释​该​行​的​内​容​。​

   #admin=password
   jsmith=s@r@hSm1th
   tandrews=pp3rrss0nn3ll

   Copy to Clipboard Toggle word wrap
   关​于​修​改​ JAAS 配​置​以​支​持​不​同​的​验​证​系​统​（如​ LDAP），请​参​考​『​第 6.1 节 “验​证​”』​。​

4. 可​选​：安​装​ ModeShape 库​

   ModeShape 是​一​个​ Java Content Repository (JCR)，它​可​以​替​代​ Apache Jackrabbit。​更​多​信​息​请​参​考​『​第 2.2.3 节 “ 安​装​和​启​用​ ModeShape”』​。​

   注意

   Modeshape 是​ BRMS 5.2 里​的​技​术​预​览​。​

5. 可​选​：启​用​规​则​软​件​包​签​名​

   规​则​软​件​包​签​名​（Rule Package Signing）使​用​公​共​密​钥​加​密​（Public Key Cryptography）来​确​保​软​件​包​在​从​ BRMS 平​台​服​务​器​下​载​到​客​户​端​应​用​程​序​时​不​会​被​损​坏​或​改​动​。​红​帽​推​荐​你​在​产​品​环​境​里​启​用​这​个​功​能​。​
   请​参​考​『​第 6.3 节 “ 规​则​软​件​包​签​名​（Rule Package Signing）”』​以​学​习​这​个​主​题​。​

6. 数​据​库​配​置​

   缺​省​配​置​使​用​了​不​适​合​产​品​环​境​的​数​据​库​。​在​部​署​到​产​品​环​境​之​前​，你​必​须​修​改​这​个​配​置​以​使​用​被​支​持​的​数​据​库​服​务​器​。​
   请​参​考​『​第 4 章 数​据​库​配​置​』​。​

7. 启​动​服​务​器​

   要​从​命​令​行​启​动​服​务​器​，请​使​用​ run.sh（UNIX 或​ Linux 系​统​），或​ run.bat（Windows 系​统​ ）。​-c 参​数​应​用​来​指​定​所​使​用​的​服​务​器​配​置​。​

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   run.sh 和​ run.bat 脚​本​位​于​ bin 目​录​里​。​
   例​如​，BRMS 5.2.0 独​立​服​务​器​的​ bin 目​录​的​完​整​路​径​是​ brms-standalone-5.2.0/jboss-as-web/bin/。​
   关​于​启​动​服​务​器​的​其​他​参​数​，请​参​考​ JBoss 企​业​级​ Web 平​台​ 5 的​文​档​：http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/。​

8. 测​试​登​录​

   登​录​到​ JBoss 企​业​级​ BRMS 平​台​ web 应​用​程​序​来​确​认​它​已​经​成​功​安​装​和​运​行​。​详​情​请​参​考​『​第 2.3 节 “ 第​一​次​登​录​”』​。​

过程 2.2. 安​装​可​部​署​软​件​包​

1. 下​载​

   从​红​帽​客​户​支​持​入​口​ https://access.redhat.com 下​载​独​立​软​件​包​ ZIP 文​件​。​进​入​ Downloads - BRMS Platform，然​后​选​择​版​本​。​当​前​的​版​本​是​ 5.2.0。​下​面​所​有​的​说​明​都​采​用​ 5.2.0 软​件​包​名​，但​除​非​特​别​注​明​，它​也​可​应​用​于​早​期​版​本​。​

2. 解​压​软​件​

   从​ ZIP 文​件​里​解​压​ BRMS 可​部​署​文​件​。​

   [localhost ]$ unzip brms-deployable-5.2.0.zip

   Copy to Clipboard Toggle word wrap
   这​会​创​建​下​列​文​件​：
   • jboss-brms.engine.zip
   • jboss-brms.manager.zip
   • modeshape.zip

     注意

     在​ BRMS 5.2 版​本​可​部​署​软​件​包​里​，modeshape.zip 只​是​一​个​技​术​预​览​。​
   从​ jboss-brms-manager.zip 里​解​压​ jboss-brms.war。​例​如​：

   [localhost ]$ unzip brms-manager.zip

   Copy to Clipboard Toggle word wrap
   这​会​创​建​一​个​ jboss-brms.war 目​录​，它​包​含​展​开​归​档​形​式​的​ JBoss 企​业​级​ BRMS 平​台​ web 应​用​程​序​。​
   从​ jboss-brms-engine.zip 里​解​压​客​户​端​库​到​一​个​目​录​里​。​例​如​：

   [localhost ]$ unzip brms-engine.zip -d client

   Copy to Clipboard Toggle word wrap
   这​会​创​建​一​个​包​含​客​户​端​库​ Jar 文​件​的​目​录​。​

3. 复​制​到​应​用​服​务​器​

   复​制​展​开​的​ web 应​用​程​序​归​档​到​应​用​服​务​器​的​ deploy 目​录​。​请​确​保​这​个​归​档​的​文​件​名​是​ jboss-brms.war。​下​面​的​例​子​演​示​了​在​ Linux 命​令​行​下​执​行​这​个​操​作​。​

   [localhost ]$ cp -rf ~/temp/jboss-brms.war /opt/brms-server/jboss-as/server/production/deploy/

   Copy to Clipboard Toggle word wrap
   直​到​应​用​服​务​器​启​动​后​，这​个​应​用​程​序​才​会​被​部​署​。​
   从​前​一​步​骤​创​建​的​ client 目​录​里​复​制​ JAR 文​件​到​应​用​服​务​器​。​详​情​请​参​考​应​用​服​务​器​的​文​档​。​

4. 启​用​用​户​

   缺​省​的​验​证​配​置​使​用​ jmx-console JAAS 配​置​。​如​果​部​署​到​一​个​现​有​的​应​用​服​务​器​，这​个​配​置​可​能​已​经​被​修​改​过​了​。​此​时​，请​参​考​应​用​服​务​器​的​文​档​中​关​于​添​加​新​用​户​的​说​明​。​

   注意

   应​用​服​务​器​里​定​义​的​任​何​用​户​都​能​够​登​录​到​ JBoss 企​业​级​ BRMS 平​台​安​装​里​。​
   红​帽​推​荐​对​ JBoss 企​业​级​ BRMS 平​台​用​户​使​用​单​独​的​验​证​系​统​。​请​参​考​『​第 6.1 节 “验​证​”』​以​学​习​如​何​修​改​ JAAS 配​置​。​
   JBoss 产​品​里​的​ jmx-console 配​置​的​缺​省​配​置​使​用​了​ UsersRolesLoginModule 登​录​模​块​在​ PROFILE/conf/props/jmx-console-users.properties 文​件​里​存​储​用​户​名​和​密​码​。​
   你​可​以​通​过​在​这​个​文​件​里​添​加​条​目​来​增​加​用​户​，其​格​式​是​ username=password。​通​过​井​字​符​（#）可​以​注​释​一​行​的​内​容​。​

   #admin=sekretz
   jsmith=s@r@hSm1th
   tandrews=p3r50n311

   Copy to Clipboard Toggle word wrap

   注意

   如​上​所​示​，本​指​南​在​目​录​路​径​里​使​用​ PROFILE 来​指​定​ production 或​ default 配​置​。​

5. 可​选​：启​用​规​则​软​件​包​签​名​

   规​则​软​件​包​签​名​（Rule Package Signing）使​用​公​共​密​钥​加​密​（Public Key Cryptography）来​确​保​软​件​包​在​从​ BRMS 平​台​服​务​器​下​载​到​客​户​端​应​用​程​序​时​不​会​被​损​坏​或​改​动​。​红​帽​推​荐​你​在​产​品​环​境​里​启​用​这​个​功​能​。​
   请​参​考​『​第 6.3 节 “ 规​则​软​件​包​签​名​（Rule Package Signing）”』​以​学​习​这​个​主​题​。​

6. 数​据​库​配​置​

   缺​省​配​置​使​用​了​不​适​合​产​品​环​境​的​数​据​库​。​在​部​署​到​产​品​环​境​之​前​，你​必​须​修​改​这​个​配​置​以​使​用​被​支​持​的​数​据​库​服​务​器​。​
   请​参​考​『​第 4 章 数​据​库​配​置​』​。​

7. 启​动​服​务​器​

   使​用​ run.sh（Linux）或​ run.bat（Windows） 来​启​动​服​务​器​。​-c 参​数​可​用​来​指​定​所​使​用​的​服​务​器​配​置​集​。​

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   run.sh 和​ run.bat 脚​本​位​于​ bin 目​录​里​。​
   例​如​，BRMS 5.2.0 独​立​服​务​器​的​ bin 目​录​的​完​整​路​径​是​ brms-standalone-5.2.0/jboss-as-web/bin/。​
   关​于​启​动​服​务​器​的​其​他​参​数​，请​参​考​ JBoss 企​业​级​ Web 平​台​ 5 的​文​档​：http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/。​

8. 登​录​

   登​录​到​ JBoss 企​业​级​ BRMS 平​台​ web 应​用​程​序​来​确​认​它​已​经​成​功​安​装​和​运​行​。​详​情​请​参​考​『​第 2.3 节 “ 第​一​次​登​录​”』​。​

过程 2.3. 配​置​ ModeShape

1. 下​载​并​解​压​

   注意

   只​有​ 5.1.0 版​本​需​要​这​个​步​骤​。​5.2.0 独​立​软​件​包​附​带​了​ ModeShape。​
   从​红​帽​支​持​入​口​ https://access.redhat.com 下​载​ ModeShape 软​件​包​（modeshape.zip）。​
   从​ ZIP 文​件​里​解​压​ modeshape 目​录​到​ BRMS 的​安​装​目​录​里​。​对​于​ JBoss 企​业​级​ BRMS 平​台​的​独​立​版​本​而​言​，它​是​ brms-standalone-5.1.0。​

   [localhost ]$ unzip modeshape.zip

   Copy to Clipboard Toggle word wrap
   解​压​后​，其​目​录​具​有​下​列​的​结​构​：

   - brms-standalone-5.2.0
       |- jboss-as-web
       |- mod_cluster
       |- modeshape
       |- picketlink
       |- resteasy
       `- seam

   Copy to Clipboard Toggle word wrap

2. 运​行​安​装​程​序​

   注意

   5.1.0 和​ 5.2.0 版​本​都​需​要​下​列​步​骤​，从​现​在​开​始​这​些​说​明​都​指​的​是​5.2.0。​
   要​在​所​需​的​服​务​器​配​置​集​里​安​装​ ModeShape，请​用​命​令​行​运​行​ ant，在​提​示​时​指​定​服​务​器​配​置​集​。​

   [localhost modeshape]$ ant
   Buildfile: /opt/BRMS/5.1.0/brms-standalone-5.1.0/modeshape/build.xml
   
   determine_home:
   
   set-web-home:
   
   set-as-home:
   
   set-soa-home:
   
   init:
        [echo] JBoss Home is ../jboss-as-web
   
   prompt:
       [input] Enter profile to install ModeShape to:  [default]
   
   

   Copy to Clipboard Toggle word wrap
   按​照​脚​本​将​ ModeShape 服​务​安​装​到​指​定​的​服​务​器​配​置​集​里​。​

3. 设​置​用​户​和​角​色​

   添​加​用​户​帐​号​ admin 和​ mailman，并​分​配​下​面​指​定​的​角​色​。​缺​省​的​配​置​使​用​文​本​文​件​来​存​储​用​户​名​、​密​码​以​及​分​配​的​角​色​。​这​里​的​指​令​假​定​授​权​配​置​未​被​修​改​。​如​果​进​行​了​修​改​，请​按​照​这​种​配​置​添​加​用​户​。​详​情​请​参​考​『​第 6 章 安​全​性​』​。​

   1. 添​加​用​户​ admin 和​ mailman。​

      在​文​本​编​辑​器​里​打​开​ PROFILE/conf/props/brms-users.properties 并​添​加​用​户​ admin 和​ mailman 到​一​新​行​里​，其​语​法​是​：username=password。​

      admin=s3kr3t5
      mailman=53cur3m@1l

      Copy to Clipboard Toggle word wrap

   2. 分​配​角​色​

      用​文​本​编​辑​器​打​开​ PROFILE/conf/props/brms-roles.properties，为​每​个​用​户​添​加​一​行​来​分​配​下​面​指​定​的​角​色​到​这​两​个​用​户​：username=role1, role2, role3。​
      admin 用​户​必​须​分​配​ JBossAdmin、​HttpInvoker、​user 和​ admin 角​色​。​
      mailman 用​户​必​须​分​配​ JBossAdmin、​readwrite 角​色​。​

      admin=JBossAdmin, HttpInvoker, user, admin
      mailman=JBossAdmin, readwrite

      Copy to Clipboard Toggle word wrap

   3. 可​选​：加​密​密​码​

      密​码​也​可​以​以​加​密​方​式​而​不​是​明​文​进​行​存​储​。​

      [localhost]$ java -cp client/jboss-logging-spi.jar:lib/jbosssx.jar org.jboss.resource.security.SecureIdentityLoginModule PASSWORD
      Encoded password: 5f78dc15b9a559cbdf8592078de921bc

      Copy to Clipboard Toggle word wrap
      然​后​用​这​个​加​密​的​版​本​替​换​ PROFILE/conf/props/brms-users.properties 里​的​密​码​。​

4. 可​选​：数​据​库​配​置​

   Modeshape 的​缺​省​配​置​使​用​了​不​适​合​产​品​环​境​的​数​据​库​。​在​部​署​到​产​品​环​境​之​前​，你​必​须​修​改​这​个​配​置​以​使​用​被​支​持​的​数​据​库​服​务​器​。​
   请​参​考​『​第 4 章 数​据​库​配​置​』​里​的​说​明​。​

5. 删​除​未​使​用​的​ JAR 文​件​

   删​除​ server/PROFILE/deploy/jboss-brms.war/WEB-INF/lib/ 里​的​下​列​ JAR 文​件​。​
   • jackrabbit-api-2.1.0.jar
   • jackrabbit-core-2.1.0.jar
   • jackrabbit-jcr-commons-2.1.0.jar
   • jackrabbit-spi-2.1.0.jar
   • hibernate-commons-annotations-3.1.0.GA.jar
   • hibernate-core-3.3.2.GA.jar
   • hibernate-validator-3.1.0.GA.jar
   • lucene-core-2.4.1.jar
   • jcr-2.0.jar

6. 在​ WAR 里​启​用​

   编​辑​ jboss-brms.war/WEB-INF/components.xml 文​件​，删​除​ Apache Jackrabbit 配​置​并​添​加​ ModeShape 配​置​。​
   要​删​除​ Apache Jackrabbit 配​置​，可​以​删​除​或​注​释​下​面​的​内​容​：

   <property name="properties">
   <key>org.drools.repository.configurator</key>
   <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
   <!--  the root directory for the repo storage the directory must exist. -->
   <!--  <key>repository.root.directory</key><value>/opt/yourpath</value>  -->
   </property>

   Copy to Clipboard Toggle word wrap
   缺​省​配​置​里​是​注​释​ ModeShape 配​置​的​，你​可​以​取​消​其​注​释​：

   <property name="properties">
   <key>org.drools.repository.configurator</key>
   <value>org.drools.repository.modeshape.ModeShapeRepositoryConfigurator</value>
   <key>org.modeshape.jcr.URL</key><value>jndi:jcr/local?repositoryName=brms</value>
   <key>org.drools.repository.secure.passwords</key><value>false</value>
   <key>org.drools.repository.admin.password</key><value>admin</value>
   <key>org.drools.repository.mailman.password</key><value>mailman</value>
   </property>
   

   Copy to Clipboard Toggle word wrap

7. 设​置​密​码​

   ModeShape 要​求​两​个​用​户​帐​号​的​存​在​：admin 和​ mailman。​这​些​帐​号​的​密​码​必​须​在​前​一​步​骤​的​ ModeShape 配​置​里​进​行​指​定​。​

   <key>org.drools.repository.secure.passwords</key><value>false</value>
   <key>org.drools.repository.admin.password</key><value>password</value>
   <key>org.drools.repository.mailman.password</key><value>password</value>

   Copy to Clipboard Toggle word wrap

8. 启​动​服​务​器​

   使​用​ run.sh（Linux）或​ run.bat（Windows） 来​启​动​服​务​器​。​-c 参​数​可​用​来​指​定​所​使​用​的​服​务​器​配​置​集​。​

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   run.sh 和​ run.bat 脚​本​位​于​ bin 目​录​里​。​
   例​如​，BRMS 5.2.0 独​立​服​务​器​的​ bin 目​录​的​完​整​路​径​是​ brms-standalone-5.2.0/jboss-as-web/bin/。​
   关​于​启​动​服​务​器​的​其​他​参​数​，请​参​考​ JBoss 企​业​级​ Web 平​台​ 5 的​文​档​：http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/。​

9. 登​录​

   登​录​到​ JBoss 企​业​级​ BRMS 平​台​ web 应​用​程​序​来​确​认​它​已​经​成​功​安​装​和​运​行​。​详​情​请​参​考​『​第 2.3 节 “ 第​一​次​登​录​”』​。​

过程 4.1. 修​改​库​数​据​库​

1. 关​闭​应​用​服​务​器​

   在​进​行​这​些​修​改​前​关​闭​应​用​服​务​器​。​

2. 安​装​ JDBC 驱​动​ JAR

   复​制​包​含​ JDBC 驱​动​的​ JAR 文​件​到​服​务​器​配​置​的​ lib 目​录​，如​ jboss-as-web/PROFILE/production/lib/。​

3. 在​文​本​编​辑​器​里​打​开​ repository.xml

   在​文​本​编​辑​器​里​打​开​ repository.xml。​使​用​ JBoss 时​，这​个​文​件​将​驻​留​在​应​用​服​务​器​的​ bin 目​录​里​，除​非​指​定​了​其​他​位​置​（如​『​第 4.3.1 节 “修​改​ JackRabbit 库​的​位​置​”』​里​所​描​述​的​）。​

4. 更​新​ PersistenceManager 配​置​

   找​到​ <Workspace> 里​的​ <PersistenceManager> 元​素​。​
   例​如​：

   <PersistenceManager class=
     "org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
       <param name="url" value="jdbc:derby:${wsp.home}/db;create=true"/>
   	<param name="schemaObjectPrefix" value="${wsp.name}_"/>
   </PersistenceManager>

   Copy to Clipboard Toggle word wrap
   用​合​适​的​数​据​库​配​置​替​换​这​些​内​容​。​请​参​考​『​附录 C, 持​久​化​管​理​者​配​置​示​例​』​里​的​例​子​。​

5. 设​置​ schemaObjectPrefix 参​数​

   这​个​值​是​通​过​持​久​化​管​理​者​管​理​的​每​个​数​据​库​表​的​名​称​前​缀​来​指​定​的​（对​于​每​个​数​据​库​它​必​须​是​唯​一​的​）。​缺​省​配​置​使​用​包​含​当​前​工​作​区​的​ ${wsp.name} 变​量​。​

   <param name="schemaObjectPrefix" value="${wsp.name}_"/>

   Copy to Clipboard Toggle word wrap

6. 删​除​旧​的​工​作​区​

   删​除​ workspaces/Default/ 目​录​。​

7. 重​新​启​动​

   重​启​应​用​服​务​器​。​

过程 4.2. 修​改​版​本​数​据​库​

1. 关​闭​应​用​服​务​器​

   在​进​行​这​些​修​改​前​关​闭​应​用​服​务​器​。​

2. 安​装​ JDBC 驱​动​ JAR

   复​制​包​含​ JDBC 驱​动​的​ JAR 文​件​到​服​务​器​配​置​的​ lib 目​录​，如​ jboss-as/server/PROFILE/lib/。​

3. 在​文​本​编​辑​器​里​打​开​ repository.xml

   在​文​本​编​辑​器​里​打​开​ repository.xml。​使​用​ JBoss 时​，这​个​文​件​将​驻​留​在​应​用​服​务​器​的​ bin 目​录​里​，除​非​指​定​了​其​他​位​置​（如​『​第 4.3.1 节 “修​改​ JackRabbit 库​的​位​置​”』​里​所​描​述​的​）。​

4. 更​新​ PersistenceManager 配​置​

   找​到​ <Workspace> 里​的​ <PersistenceManager> 元​素​。​
   例​如​：

   <PersistenceManager class=
     "org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
     <param name="url" value="jdbc:derby:${rep.home}/version/db;create=true"/>
     <param name="schemaObjectPrefix" value="version_"/>
   </PersistenceManager>

   Copy to Clipboard Toggle word wrap
   用​合​适​的​数​据​库​配​置​替​换​这​些​内​容​。​请​参​考​『​附录 C, 持​久​化​管​理​者​配​置​示​例​』​里​的​例​子​。​

5. 设​置​ schemaObjectPrefix 参​数​

   这​个​值​是​通​过​持​久​化​管​理​者​管​理​的​每​个​数​据​库​表​的​名​称​前​缀​来​指​定​的​（对​于​每​个​数​据​库​它​必​须​是​唯​一​的​）。​如​果​相​同​的​数​据​库​用​于​版​本​以​及​数​据​存​储​，请​确​保​没​有​使​用​相​同​的​ schemaObjectPrefix（缺​省​配​置​使​用​ version_）。​

   <param name="schemaObjectPrefix" value="version_"/>

   Copy to Clipboard Toggle word wrap

6. 重​新​启​动​

   重​启​应​用​服​务​器​。​

过程 4.3. 修​改​库​位​置​

1. 关​闭​应​用​服​务​器​

   在​进​行​这​些​修​改​之​前​先​请​停​止​应​用​服​务​器​。​

2. 找​到​ components.xml 文​件​

   components.xml 文​件​位​于​已​部​署​的​ BRMS web 归​档​的​ WEB-INF/ 目​录​下​（deploy/jboss-brms.war/WEB-INF/）。​它​是​一​个​标​准​的​ JBoss Seam 配​置​文​件​，它​可​以​对​应​用​程​序​的​不​同​方​面​进​行​定​制​。​

3. 找​到​ repository.root.directory 键​-值​属​性​。​

   在​文​本​编​辑​器​里​打​开​ components.xml 并​找​到​ repository.root.directory 属​性​。​它​包​含​在​ repositoryConfiguration 组​件​里​且​缺​省​是​被​注​释​的​。​

   <property name="properties">
      <key>org.drools.repository.configurator</key>
      <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
      <!--  the root directory for the repo storage the directory must exist. -->
      <!--  <key>repository.root.directory</key><value>/opt/yourpath</value>  -->
   </property>

   Copy to Clipboard Toggle word wrap

   注意

   对​于​ BRMS 5.1 之​前​的​版​本​，请​遵​循​下​面​的​步​骤​：

   • 找​到​ homeDirectory 属​性​
   • 在​文​本​编​辑​器​里​打​开​ components.xml 并​找​到​ homeDirectory 属​性​。​它​包​含​在​ repositoryConfiguration 组​件​里​且​缺​省​是​被​注​释​的​。​

   <component name="repositoryConfiguration"> 
   <!-- 
   *** This is for configuring the "home" directory for the repository
    storage. the directory must exist. ***
   <property name="homeDirectory">
       /home/michael/RulesRepository_001
   </property>
   -->  
   </component> 
   

   Copy to Clipboard Toggle word wrap

4. 更​新​ repository.root.directory 属​性​。​

   删​除​ repository.root.directory 属​性​周​围​的​注​释​标​记​并​将​其​值​修​改​为​数​据​库​所​在​的​路​径​（这​个​目​录​必​须​已​经​存​在​）。​

   <property name="properties">
      <key>org.drools.repository.configurator</key>
      <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
      <!--  the root directory for the repo storage the directory must exist. -->
      <key>repository.root.directory</key>
      <value>/opt/brms-standalone-5.2.0/BRMSRulesRepository</value>
   </property>
   

   Copy to Clipboard Toggle word wrap

   注意

   对​于​ BRMS 5.1 之​前​的​版​本​，其​代​码​是​：

   <component name="repositoryConfiguration"> 
       <property name="homeDirectory">/opt/jboss-soa-platform/BRMSRulesRepository</property>
   </component>
   

   Copy to Clipboard Toggle word wrap

5. 移​动​现​有​的​数​据​库​（可​选​）

   JBoss 企​业​级​ BRMS 平​台​将​在​这​个​位​置​创​建​一​个​新​的​数​据​库​（如​果​之​前​不​存​在​）。​要​保​留​现​有​的​数​据​库​，在​重​启​服​务​器​之​前​复​制​现​有​的​文​件​到​到​新​的​位​置​。​

6. 重​启​应​用​服​务​器​

   重​启​服​务​器​。​如​果​没​有​移​动​现​有​的​数​据​库​到​新​的​位​置​，新​的​数​据​库​将​被​创​建​。​

过程 4.4. 用​ Repository Configuration 工​具​配​置​外​部​ RDBMS

1. 登​录​用​户​界​面​

   打​开​一​个​ web 浏​览​器​并​输​入​ URL http://localhost:8080/jboss-brms/，请​用​访​问​登​录​对​话​框​的​服​务​器​的​主​机​名​代​替​ localhost。​

2. 选​择​ Repository Configuration 工​具​

   在​导​航​面​板​里​，选​择​ Administration，然​后​再​选​择​ Repository Configuration。​
   

   View larger image

   

   图 4.1. 库​配​置​（Repository Configuration）工​具​

3. 选​择​ RDBMS 类​型​

   从​ Select RDBMS type: 下​拉​菜​单​里​，选​择​ RDBMS 类​型​。​
   

   View larger image

   

   图 4.2. RDBMS 类​型​

4. 输​入​ RDBMS 细​节​

   如​果​配​置​了​ JNDI，选​中​ USE JNDI 复​选​框​。​
   点​击​ Continue 并​输​入​在​部​署​的​数​据​源​里​配​置​的​ JNDI 名​称​。​
   如​果​没​有​使​用​ JNDI，输​入​所​需​的​ RDBMS 信​息​：
   • 驱​动​
   • URL
   • 用​户​
   • 密​码​
   

   View larger image

   

   图 4.3. RDBMS 信​息​

5. 生​成​库​的​配​置​文​件​

   选​择​ Generate repository config 以​生​成​ repository.xml 文​件​。​
   你​可​以​剪​切​或​粘​贴​生​成​的​文​本​到​一​个​文​件​里​并​保​存​为​ repository.xml，或​者​是​选​择​ Save Configuration 将​这​些​文​本​作​为​文​件​下​载​。​用​新​的​ repository.xml 替​换​现​有​的​ repository.xml。​除​非​指​定​了​不​同​的​主​目​录​（如​ 第 4.3.1 节 “修​改​ JackRabbit 库​的​位​置​” 里​所​描​述​的​），repository.xml 将​位​于​应​用​服​务​器​的​ bin 目​录​里​。​

过程 6.1. 验​证​示​例​：UserRolesLoginModule

1. 确​保​已​经​正​确​配​置​了​验​证​系​统​

   登​录​模​块​使​用​两​个​文​件​来​存​储​登​录​名​、​密​码​以​及​分​配​给​用​户​的​角​色​。​在​ jboss-as-web/server/PROFILE/conf/props/ 目​录​里​创​建​ brms-users.properties 和​ brms-roles.properties 文​件​并​用​这​个​格​式​在​ brms-users.properties 里​指​定​至​少​一​个​用​户​：username=password。​（brms-roles.properties 可​以​为​空​）

2. 关​闭​应​用​服​务​器​

   在​进​行​这​些​修​改​前​关​闭​应​用​服​务​器​。​

3. 配​置​ JBoss 登​录​模​块​

   要​配​置​ JBoss 登​录​模​块​，打​开​ jboss-as-web/server/PROFILE/conf/login-config.xml 文​件​。​它​是​一​个​包​含​ <policy> 元​素​以​及​几​个​ <application-policy> 子​元​素​的​ XML 文​件​。​每​个​ <application-policy> 元​素​都​定​义​了​一​个​不​同​的​验​证​模​式​。​添​加​下​列​ <application-policy> XML 片​段​作​为​ <policy> 元​素​的​新​的​子​元​素​。​

   <!--BRMS Platform Security Domain-->
   <application-policy name="brms">
      <authentication>
          <login-module
              code="org.jboss.security.auth.spi.UsersRolesLoginModule"
              flag="required">
               <module-option name="usersProperties">
                   props/brms-users.properties
               </module-option>
               <module-option name="rolesProperties">
                   props/brms-roles.properties
               </module-option>
           </login-module>
       </authentication>
   </application-policy>
   

   Copy to Clipboard Toggle word wrap

4. 配​置​ BRMS 平​台​以​使​用​登​录​模​块​

   打​开​ jboss-as-web/server/PROFILE/deploy/jboss-brms.war/WEB-INF/components.xml 为​。​它​包​含​一​个​ <components> 元​素​并​带​有​几​个​子​元​素​，其​中​包​括​ <security:identity>。​
   注​释​现​有​的​ <security:identity> 元​素​以​防​止​冲​突​。​添​加​下​列​ <security:identity> 元​素​。​

   <security:identity authenticate-
   method="#{authenticator.authenticate}" jaas-config-name="brms"/>
   

   Copy to Clipboard Toggle word wrap
   jaas-config-name 属​性​必​须​和​ application-policy 相​同​。​如​果​在​前​一​步​骤​修​改​了​ application-policy，也​请​修​改​这​里​的​ jaas-config-name 属​性​进​行​匹​配​。​

5. 重​新​启​动​

   重​启​应​用​服​务​器​

过程 6.2. 验​证​示​例​ 2：LDAP

1. 确​保​已​经​正​确​配​置​了​ LDAP 服​务​器​

   确​定​防​火​墙​和​网​络​配​置​没​有​阻​断​应​用​服​务​器​和​ LDAP 服​务​器​间​的​通​讯​。​

2. 关​闭​应​用​服​务​器​

   在​进​行​这​些​修​改​前​关​闭​应​用​服​务​器​。​

3. 配​置​ JBoss 登​录​模​块​

   要​配​置​ JBoss 登​录​模​块​，打​开​ jboss-as-web/server/PROFILE/conf/login-config.xml 文​件​。​它​是​一​个​包​含​ <policy> 元​素​以​及​几​个​ <application-policy> 子​元​素​的​ XML 文​件​。​每​个​ <application-policy> 元​素​都​定​义​了​一​个​不​同​的​验​证​模​式​。​添​加​下​列​ <application-policy> XML 片​段​作​为​ <policy> 元​素​的​新​的​子​元​素​。​

   <application-policy name="brms">
    <authentication>
     <login-module code="org.jboss.security.auth.spi.LdapExtLoginModule" 
         flag="required" >
       <module-option name="java.naming.provider.url">
           ldap://ldap.company.com:389
       </module-option>
       <module-option name="bindDN">DEPARTMENT\someadmin</module-option>
       <module-option name="bindCredential">password</module-option>
       <module-option name="baseCtxDN">cn=Users,dc=company,dc=com
       </module-option>
       <module-option name="baseFilter">(sAMAccountName={0})</module-option>
       <module-option name="rolesCtxDN">cn=Users,dc=company,dc=com
       </module-option>
       <module-option name="roleFilter">(sAMAccountName={0})</module-option>
       <module-option name="roleAttributeID">memberOf</module-option>
       <module-option name="roleAttributeIsDN">true</module-option>
       <module-option name="roleNameAttributeID">cn</module-option>
       <module-option name="roleRecursion">-1</module-option>
       <module-option name="searchScope">ONELEVEL_SCOPE</module-option>
     </login-module>
    </authentication>
   </application-policy>

   Copy to Clipboard Toggle word wrap
   用​适​合​你​的​ LDAP 服​务​器​的​值​更​新​这​个​配​置​文​件​。​

4. 配​置​ BRMS 平​台​以​使​用​登​录​模​块​

   打​开​ jboss-as-web/server/PROFILE/deploy/jboss-brms.war/WEB-INF/components.xml 为​。​它​包​含​一​个​ <components> 元​素​并​带​有​几​个​子​元​素​，其​中​包​括​ <security:identity>。​
   注​释​现​有​的​ <security:identity> 元​素​以​防​止​冲​突​。​添​加​下​列​ <security:identity> 元​素​。​

   <security:identity authenticate-method="#{authenticator.authenticate}" jaas-config-name="brms"/>

   Copy to Clipboard Toggle word wrap
   jaas-config-name 属​性​必​须​和​ application-policy 相​同​。​如​果​在​前​一​步​骤​修​改​了​ application-policy，也​请​修​改​这​里​的​ jaas-config-name 属​性​进​行​匹​配​。​

5. 重​新​启​动​

   重​启​应​用​服​务​器​