ActiveBPEL engine5.0.2 配置手册

activeBPEL  engine5.0.2 配置手册

本文档描述如何安装ActiveBPEL引擎5.0.2版，根据网上的一篇文章关于ActiveBPEL2.X版本的安装与配置来写出5.0.2的配置文档。
1 、安装和配置 ActiveBPEL 引擎体验版
要使用ActiveBPEL引擎首先要求安装配置servlet容器。ActiveBPEL引擎可以运行在任何标准的servlet容器下。但它主要在Tomcat和Mysql下进行开发，我们也用Tomcat和Mysql作为蓝本进行说明。体验版没有考虑Mysql。
1.1 下载 Tomcat5.x
安装Tomcat (http://jakarta.apache.org/tomcat),并设置环境变量CATALINA_HOME(这个变量在代码和配置中有很多次的应用)。（经过测试的版本为Tomcat 5.5.26）。 由于tomcat5.5.26里面没有包含admin包，所以去apache的官网（http://tomcat.apache.org/download-55.cgi）下载Administration Web Application，然后直接解压覆盖到tomcat里。打开%CATILINA_HOME%\conf目录下的tomcat-users.xml文件，增加一个“admin”的角色，<role rolename="admin"/>，然后增加一个角色为admin的新用户：用户名admin，密码：admin。
1.2 下载 ActiveBPEl
网址为http://www.activebpel.org/download。文件的名字为activebpel-version-type.tar.gz 或activebpel-version-type.zip。版本号是：5.0.2。类型为"src" (source), "bin" (binaries), or "all" (source and binaries)。解压缩下载的文件包，会创建一个名字为activebpel的目录。可以重新命名，或者移动到任何地方。以下的文档中，简称这个目录为"activebpel"。
1.3 运行脚本 install.bat
执行命令行如下：（Windows）
    C:\> cd \activebpel
    C:\activebpel> install.bat
脚本将把lib下的内容拷贝到$CATALINA_HOME/shared/lib目录下，并且创建$CATALINA_HOME/bpr目录，这就是存放流程的配置文件.bpr的目录。
1.4 更改引擎的配置参数
在aeEngineConfig.xml文件里可以配置一些服务的参数，这个文件在$CATALINA_HOME/bpr。配置的改变是通过BpelAdmin配置页改变的，可以访问http://localhost:8080/BpelAdmin/config.jsp页，并保存配置。
1.5 启动 ActiveBPEL 引擎
要启动ActiveBPEL引擎,只需要启动Tomcat就可以了。
1.6 查看引擎的状态信息
当tomcat启动后，有两个WEB页可以显示服务器的信息
Axis WEB 服务列表http://localhost:8080/active-bpel/services    
ActiveBPEL 引擎管理http://localhost:8080/BpelAdmin/ 
在此页面可以修改引擎的配置参数，可查看帮助页来进行学习。

2 、 ActiveBPEL2.0 引擎的 Mysql 版安装
 
要使得ActiveBPEL引擎作为一个可持久化的引擎，需要做以下事情：
2.1 装数据库和驱动
安装数据库Mysql（Mysql5.0.18）和相关的JDBC（mysql-connector-java-5.0.3-bin.jar）驱动，并且保证有权限做数据库操作。并且要把文件拷贝到${CATALINA_HOME}/common/lib下。
2.2 建库建表
启动安装好的数据库，执行\activebpel\dist\sql\activebpel\ddl目录下的ActiveBPEL_MySQL.sql语句，在数据库中创建名为ActiveBPEL的数据库，同时创建基本表。
2.3 设置数据源
打开${CATALINA_HOME}\conf目录下的tomcat-users.xml文件，增加一个“admin”的角色，<role rolename="admin"/>，然后增加一个角色为admin的新用户。 增加数据源的操作如下：
2.3.1 重启Tomcat,并访问它的管理页http://localhost:8080/admin/ 
2.3.2 输入用户名和密码
2.3.3 按照以下顺序点击左侧的Frame
Server\Service\Host\Context(/active-bpel)\Resources\Data Sources
2.3.4 从 the list of Data Source Actions中选择 "Create New Data Source"
2.3.5按如下数值配置 Data Source信息。（注：在此之前要确保相关的JDBC驱动已经拷贝到tomcat\common\lib下）              
JNDI = jdbc/ActiveBPELDB
Data Source URL = jdbc:mysql://127.0.0.1:3306/ActiveBPEL
JDBC Driver Class = com.mysql.jdbc.Driver
User Name =root
Password = admin
2.3.6 按保存按钮，并一定注意要提交（上方有一个Commit按钮）。
2.4 修改 aeEngineconfig.xml 文件
   将activebpel/dist/conf下的aeEngineConfig-Persistent.xml文件拷贝到%CATILINA_HOME%\bpr目录下，并且重命名为 aeEngineconfig.xml，原来的aeEngineconfig.xml文件则被覆盖掉。   并在该文件中修改”databaseType”的value值为  ”mysql” 。
2.5 ActiveBPEL 的内存管理模式
如果要使ActiveBPEL引擎 转换到应用内存管理的模式，可以把/activebpel/dist/conf下的  aeEngineConfig-InMemory.xml文件拷贝到 %CATILINA_HOME%\bpr目录下。
2.6 启动
重启tomcat，启动数据库，打开http://localhost:8080/BpelAdmin/页，在Home页可以看到一个“Start Engine”的按钮，启动引擎，当表中的status为running,则表示启动成功。此时，即为以一个可持续的方式启动了ActiveBPEL引擎。