一、安装和配置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,并且配置