转帖网上的一篇文章关于ActiveBPEL2.X版本的安装与配置。
本文档描述如何安装ActiveBPEL引擎2.0版,主要是翻译ActiveBPEL网站上的UserGuide并加入自己的说明。
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.0.25)。
1.2
下载
ActiveBPEl
网址为http://www.activebpel.org/download。文件的名字为activebpel-version-type.tar.gz 或activebpel-version-type.zip。版本号是:2.0.0。类型为"src" (source), "bin" (binaries), or "all" (source and binaries)。解压缩下载的文件包,会创建一个名字为activebpel-2.0的目录。可以重新命名,或者移动到任何地方。以下的文档中,简称这个目录为"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和相关的JDBC驱动,并且保证有权限做数据库操作。并且要把文件拷贝到${CATALINA_HOME}/common/lib下。
2.2
建库建表
启动安装好的数据库,执行\activebpel\dist\sql\activebpel\ddl目录下的ActiveBPEL_MySQL.sql语句,在数据库中创建名为ActiveBPEL的数据库,同时创建基本表。
2.3
设置数据源
打开${CATALINA_HOME}\conf目录下的omcat-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 = org.gjt.mm.mysql.Driver
User Name =root
Password =
2.3.6
按保存按钮,并一定注意要提交(上方有一个Commit按钮)。
2.4
修改
aeEngineconfig.xml
文件
将activebpel/dist/conf下的aeEngineConfig-Persistent.xml文件拷贝到%CATILINA_HOME%\bpr目录下,并且重命名为 aeEngineconfig.xml,原来的aeEngineconfig.xml文件则被覆盖掉。
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引擎。
3
、配置发布自己的流程
ActiveBPEL
的流程需要创建一个配置文档(.jar和.bpr文件),并且把他们拷贝到servelet容器中。为了创建这些文件,需要组织一个特殊结构的目录,并创建一两个相应的配置文件,然后才能通过这些目录来创建文档。
3.1
建立目录
创建一个目录,我们假设这个例子叫mybpel,然后按照下边的列表创建它的子目录:
* bpel
* META-INF
* wsdl
* partners (optional)
其中wsdl目录中包含了所有定义过的WSDL文件,在META-INFM目录中包含了wsdlCatalog.xml文件, partner definition目录定义了 .pdef文件.以.pdd为后缀的文件是流程的配置描述。
3.2
编写文件
作为一个例子,在各个的目录中放入对应的文件,假设有两个WSDL的服务,BPEL的流程名字为 my_process.bpl,各目录结构如下所示:
mybpel
META-INF
wsdlCatalog.xml
bpel
my_process.bpl
my_process.pdd
wsdl
service1.wsdl
service2.wsdl
除非有.pdef文件,否则不需要partners目录。
3.3
发布应用
打包并拷贝到servelet容器中。面的命令说明了如何配置BPEL流程到TOMCAT(如果没有partners目录,则把partners从jar的命令行中去掉):
Windows:
C:\> cd mybpel
C:\mybpel> jar cf mybpel.bpr *.pdd META-INF bpel partners wsdl
C:\> cp mybpel.bpr $CATALINA_HOME/bpr
在配置文档中有多个.bpel或.pdd文件是允许的。另外,WSDL文件可以放在任意位置,即使是另一台机器,只要把他们打包,在.pdd文件中说明,让BPEL引擎知道它们在哪就可以。
HongSoft,
工学硕士,AgileFlow开源工作流引擎负责人,多年工作流产品和技术相关经验,曾任CSDN工作流专题主编,BEA广州UserGroup邀请讲座嘉宾,在《程序员》《微型机与应用》等杂志发表技术文章多篇。
posted on 2006-09-18 13:03
matthew 阅读(1653)
评论(2) 编辑 收藏 所属分类:
Web Services and SOA