最近准备使用jbpm, 从Jboss网站上下载回来jbpm-installer-3.3.1.GA.jar和jboss 4.2.3,机器上原先装有mysql 5. 本来以为安装没有问题，没想到竟然费了一番周折才搞掟，现把整个过程写下来，供有需要的朋友参考。
1. 把jboss 4.2.3 展开到某一个文件夹中，我们假定它为{jboss.home};
2. 安装jbpm-nstaller-3.3.1. 通过命令 java -jar jbpm-installer-3.3.1.GA.jar可以启动安装向导。在安装过程中指定jboss所在的文件夹，数据库选择为mysql. 一路Next后完成后会生成{jboss.home}\server\default\deploy\jbpm,称其为{jboss-jbpm.home}，jbpm还会生成另一份专门存放自己的文件夹，称其为{jbpm.home}.
3. 麻烦开始了。当启动jboss4.2.3时，总是报错，即使换成jboss 5 也是一样。
  
11:04:16,201 INFO  [DatasourceConnectionProvider] Using datasource: java:JbpmDS
11:04:16,201 WARN  [JBossManagedConnectionPool] Throwable while trying to match ManagedConnection, destroying connection: org.jboss.resource.connectionmanager.TxConnectionManager$TxConnectionEventListener@6ca1a6[state=NORMAL mc=org.jboss.resource.adapter.jdbc.xa.XAManagedConnection@1ae8bac handles=0 lastUse=1234195414812 permit=false trackByTx=false mcp=org.jboss.resource.connectionmanager.JBossManagedConnectionPool$OnePool@ed55ec context=org.jboss.resource.connectionmanager.InternalManagedConnectionPool@1a40fff xaResource=org.jboss.resource.connectionmanager.xa.JcaXAResourceWrapper@53d34c txSync=null]
java.lang.NoClassDefFoundError: org/jboss/resource/adapter/jdbc/ValidConnectionChecker
    at java.lang.ClassLoader.defineClass1(Native Method)
    at java.lang.ClassLoader.defineClass(ClassLoader.java:621)
    at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:124)
    at java.net.URLClassLoader.defineClass(URLClassLoader.java:260)
    at java.net.URLClassLoader.access$000(URLClassLoader.java:56)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:195)

 后来查阅jboss官方说明书，内容极其笼统简略，没有任何参考价值。也不怪jboss, 人家的文档是要卖钱的。
 又Google、baidu了半天，直到遇到ColorKnight的一个贴子才解决问题, 在这里严重感谢ColorKnight，原贴地址：http://blog.csdn.net/colorknight/archive/2008/12/11/3495408.aspx。
4. 通过仔细阅读，发现了问题所在，原来不能直接使用｛jboss-jbpm.home}\jbpm-mysql-ds.xml中的配置。它的缺省配置使用xa-datasource,这导致了上述exception的发生。将它改为local-tx-datasource.下面是我的配置：
   
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
     <local-tx-datasource>
            <jndi-name>JbpmDS</jndi-name>
            <connection-url>jdbc:mysql://localhost:3306/jbpm</connection-url>
            <driver-class>com.mysql.jdbc.Driver</driver-class>
            <user-name>jbpm</user-name>
            <password>jbpm</password>
            <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name>
   
            <!-- corresponding type-mapping in the standardjbosscmp-jdbc.xml (optional) -->
            <metadata>
               <type-mapping>mySQL</type-mapping>
            </metadata>
     </local-tx-datasource>
  
</datasources>
5. 这步完成后就可以启动Jboss了，不再有任何错误。在Firefox中可以打开http://localhost:8080/jbpm-console页面。但是login会失败的，因为数据库中没有任何数据，安全配置也没有做。
6. 不用着急，ColorKnight给出了很重要的参考。之所以重要，是因为他的方向正确；之所以说是参考，是因为他用的是Oracle,我的是mysql，略有不同。好吧，快生成数据吧。
 
insert into JBPM_ID_USER (ID_, CLASS_, NAME_, EMAIL_, PASSWORD_) values ('1', 'U', 'user', 'sample.user@sample.domain', 'user');

insert into JBPM_ID_USER (ID_,CLASS_, NAME_, EMAIL_, PASSWORD_) values ('2', 'U', 'manager', 'sample.manager@sample.domain', 'manager');

insert into JBPM_ID_USER (ID_,CLASS_, NAME_, EMAIL_, PASSWORD_) values ('3', 'U', 'shipper', 'sample.shipper@sample.domain', 'shipper');

insert into JBPM_ID_USER (ID_,CLASS_, NAME_, EMAIL_, PASSWORD_) values ('4', 'U', 'admin', 'sample.admin@sample.domain', 'admin');

insert into JBPM_ID_GROUP VALUES(1,'G','admin','security-role',NULL);

insert into JBPM_ID_GROUP VALUES(2,'G','manager','security-role',NULL);

insert into JBPM_ID_GROUP VALUES(3,'G','user','organisation',NULL);

insert into JBPM_ID_MEMBERSHIP VALUES(1,'M',NULL,'user',1,3);

insert into JBPM_ID_MEMBERSHIP VALUES(2,'M',NULL,'admin',2,1);

insert into JBPM_ID_MEMBERSHIP VALUES(3,'M',NULL,'manager',2,2);

insert into JBPM_ID_MEMBERSHIP VALUES(4,'M',NULL,'user',2,3);

insert into JBPM_ID_MEMBERSHIP VALUES(5,'M',NULL,'user',3,3);

insert into JBPM_ID_MEMBERSHIP VALUES(6,'M',NULL,'admin',4,1);

insert into JBPM_ID_MEMBERSHIP VALUES(7,'M',NULL,'user',4,3);
7. 配置jboss的认证管理。打开{jboss.home}/server/default/conf/login-config.xml文件，在文件中加入
   
       <application-policy name = "jbpm-console">
              <authentication>
                <login-module code="org.jboss.security.auth.spi.DatabaseServerLoginModule"
                              flag="required">
                  <module-option name="dsJndiName">java:/JbpmDS</module-option>
                  <module-option name="principalsQuery">
                    SELECT PASSWORD_ FROM JBPM_ID_USER WHERE NAME_=?
                  </module-option>
                  <module-option name="rolesQuery">
                    SELECT g.NAME_ ,'Roles'
                    FROM JBPM_ID_USER u,
                         JBPM_ID_MEMBERSHIP m,
                         JBPM_ID_GROUP g
                    WHERE g.TYPE_='security-role'
                      AND m.GROUP_ = g.ID_
                      AND m.USER_ = u.ID_
                      AND u.NAME_=?
                  </module-option>
                </login-module>
              </authentication>
       </application-policy>

   其中jbpm-console必须与{Jboss-Jbpm.home}/jsf-console.war/WEB-INF/jboss-web.xml中的<security-domain>所设置的名字一致。
   
   8. 配置jboss-console的web.xml 使admin能登录进来。 打开${Jboss-Jbpm.hom}/jsf-console.war/WEB-INF/web.xml文件，增加下例代码中黄色Highlight的部分。
            
<security-constraint>
        <web-resource-collection>
            <web-resource-name>Secure Area</web-resource-name>
            <url-pattern>/sa/*</url-pattern>
            <http-method>GET</http-method>
            <http-method>POST</http-method>
        </web-resource-collection>

        <auth-constraint>
            <role-name>user</role-name>
            <role-name>admin</role-name>
        </auth-constraint>
</security-constraint>
    
 9.最后重新启动jboss,再次登录http://localhost:8080/jbpm-console,以admin/admin登录进去，look一下界面吧：