ActiveBPEL的安装和配置

一、安装和配置activebpel引擎

本文档描述了如何安装activebpel引擎

（一）、依赖关系activebpel引擎要求安装和正确的配置servlet容器。activebpel引擎的安装脚本是用作环境变量，也就是tomcat的最上层目录。activebpel引擎应该运行在任何标准的servlet容器下。

1、下载tomcat 5.x (http://jakarta.apache.org/tomcat).安装tomcat,并设置环境变量catalina_home。（经过测试的版本为tomcat 5.0.25.）2、下载软件：(http://www.activebpel.org/download)其中有两张格式a.tar.gz或者a.zip.两张格式包含的文件是相同的。文件的名字为activebpel-version-type.tar.gz 或activebpel-version-type.zip。版本号是：1.0.1类型为"src" (source), "bin" (binaries), or "all" (source and binaries)。解压缩下载的文件包，会创建一个名字为activebpel-1.0.1的目录。可以重新命名，或者一动到任何地方。以下的文档中，简称这个目录为"activebpel"。 

（二）、安装activebpel引擎

1、运行脚本install.bat。它将拷贝lib下的内容到$catalina_home/shared/lib目录下，并且创建$catalina_home/bpr目录，也就是存放流程的配置文件.bpr的目录。

执行命令行如下：windows:

    c:/> cd /activebpel    c:/activebpel> install.bat

2、更改引擎的配置参数

在aeengineconfig.xml文件里可以配置一些服务的参数，这个文件在$catalina_home/bpr。配置的改变是通过bpeladmin配置页改变的，可以访问http://localhost:8080/bpeladmin/config.jsp页，并保存配置。

3、启动activebpel引擎

启动tomcat,.

windows:

c:> %catalina_home%/bin/startup.bat

4、停止引擎关闭tomcatwindows:

    c:/> %catalina_home%/bin/shutdown.bat

5、引擎的状态信息当tomcat启动后，有两个web页可以显示服务器的信息axis web服务列表http://localhost:8080/active-bpel/services     activebpel引擎管理http://localhost:8080/bpeladmin/  在此页面可以修改引擎的配置参数，可查看帮助页。 

二、activebpel(tm) 引擎的持续安装 （一）、要使得activebpel引擎作为一个可持续运行的引擎来，需要做以下步骤：

    1、安装数据库sqlserver 2000和相关的正确的jdbc驱动，并且保证有权限创建数据库的表。jdbc的驱动程序一定要到sourceforge网站去下载。下载后解压缩文件包，把其中的jtds-1.0.3.jar文件拷贝到catalina_home/common/lib下。

2、启动安装好的数据库，执行/activebpel/dist/sql/activebpel/ddl目录下的activebpel-sqlserver.sql语句，在数据库中创建名为activebpel的数据库，同时创建基本表。3、设置tomcat的数据源。打开%catilina_home%/conf目录下的omcat-users.xml文件，增加一个“admin”的角色，<role rolename="admin"/>，然后增加一个角色为admin的新用户。  增加数据源的操作如下：

        （1）、重启tomcat,并访问它的管理页http://localhost:8080/admin/  （2）、输入用户名和密码

        （3）、按照以下顺序点击左侧的frame         server/service/host/context (/active-bpel)/resources/data sources

        （4）、从 the list of data source actions中选择 "create new data source"                   （5）、按如下数值配置 data source信息。（注：在此之前要确保相关的jdbc驱动已经拷贝到tomcat/common/lib下。                      jndi = jdbc/activebpeldb        data source url = jdbc:jtds:sqlserver://localhost:1433/activebpel        jdbc driver class = net.sourceforge.jtds.jdbc.driver        user name = [db user name]        password = [db password]       

       （6）、按保存按钮，并提交（上方有一个commit按钮）。

   4、修改aeengineconfig.xml 文件   将activebpel/dist/conf下的aeengineconfig-persistent.xml文件拷贝到%catilina_home%/bpr目录下，并且重命名为 aeengineconfig.xml，原来的aeengineconfig.xml文件则被覆盖掉。然后打开这个文件，  更改其中的一行关于数据库的信息 <entry name="databasetype" value="mysql" />，把value值改为sqlserver。

  5、 activebpel 数据库的配置文件为了使activebpel引擎 转换到应用内存管理的模式，把/activebpel/dist/conf下的  aeengineconfig-inmemory.xml文件拷贝到 %catilina_home%/bpr目录下。

< 注：>任何已经设置的activebpel 引擎的配置参数现在被重新设置成缺省值。   重启tomcat，启动数据库，打开http://localhost:8080/bpeladmin/页，在home页可以看到一个“start engine”的按钮，启动引擎，当表中的status为running,则表示启动成功。此时，即为以一个可持续的方式启动了activebpel引擎。                      

三、配置bpel流程示例(以custom_invoke流程为例)

为了配置一个bpel流程，必须创建和安装一个包含bpel流程文件的配置文档。

1、这里要用到jar，所以需要一个java sdk,  任何版本都应该可以，其中经过测试的版本是1.4.1 sdk。安装java sdk,并且配置环境变量java_home。

2、需要ant来运行build.xml文件。ant测试过的版本为ant version 1.5.1。安装 ant后，设置环境变量ant_home，并且要在环境变量path里增加％ant_home％/bin;％java_home％/bin。以下的步骤假设已经安装了ant（catalina_home一定要定义），并做好相应的配置。

3、如果你的activebpel引擎安装程序不能在"localhost:8080"在运行，需要改变下列文件中的相关字符串：build.xml       bpel_process/wsdl/loanapprover.wsdl       bpel_process/wsdl/loanassessor.wsdl

4、配置示例中的流程在命令行中执行以下命令：<installdir>/activebpel-version/samples/custom_invoke/ant deploy

该命令调用了两个目标程序：deploy-bpel and deploy-cih.deploy-bpel 创建和安装了一个包含bpel流程信息的.bpr 文件。 deploy-cih创建和安装了一个包含custom invoke handlers的.jar文件。

每次一个新的jar 拷贝到$catalina_home/shared/lib下，重启tomcat后可以看到它。不需要每次执行“ant deploy”命令时都重启tomcat,仅仅当每次deploy-cih拷贝jar文件到$catalina_home/shared/lib/下需要重启tomcat.这不同于重新配置一个bpr, he activebpel引擎会发现并重新装载它。

5、在客户端运行bpel流程运行ant client命令调用bpel流程，可以看到运行结果。或者访问：http://localhost:8080/bpel_example_client_page/index.jsp也可以看到运行结果。

四、配置自己的流程

bpel的流程需要创建一个配置文档(.jar和.bpr文件),并且把他们拷贝到servelet容器中.为了创建这些文件,需要组织一个特殊结构的目录,并创建一两个相应的配置文件,然后才能通过这些目录来创建文档.

创建一个目录,我们假设这个例子叫mybpel,然后按照下边的列表创建它的子目录:

    * bpel    * meta-inf    * wsdl    * partners (optional)    其中wsdl目录中包含了所有定义过的wsdl文件,在meta-infm目录中包含了wsdlcatalog.xml文件, partner definition目录定义了 .pdef文件.以.pdd为后缀的文件是流程的配置描述..

作为一个例子,在各个的目录中放入对应的文件,假设有两个wsdl的服务,bpel的流程名字为  my_process.bpl,各目录结构如下所示:

    mybpel        meta-inf            wsdlcatalog.xml        bpel            my_process.bpl        my_process.pdd        wsdl            service1.wsdl            service2.wsdl

  除非有.pdef文件,否则不需要partners目录.  应用这个目录结构,创建文档并拷贝的到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引擎知道它们在哪就可以.