轉(zhuǎn)帖網(wǎng)上的一篇文章關(guān)于ActiveBPEL2.X版本的安裝與配置。
?? 本文檔描述如何安裝ActiveBPEL引擎2.0版，主要是翻譯ActiveBPEL網(wǎng)站上的UserGuide并加入自己的說明。

1 、安裝和配置 ActiveBPEL 引擎體驗(yàn)版

要使用ActiveBPEL引擎首先要求安裝配置servlet容器。ActiveBPEL引擎可以運(yùn)行在任何標(biāo)準(zhǔn)的servlet容器下。但它主要在Tomcat和Mysql下進(jìn)行開發(fā)，我們也用Tomcat和Mysql作為藍(lán)本進(jìn)行說明。體驗(yàn)版沒有考慮Mysql。

1.1 下載 Tomcat5.x

安裝Tomcat (http://jakarta.apache.org/tomcat),并設(shè)置環(huán)境變量CATALINA_HOME(這個(gè)變量在代碼和配置中有很多次的應(yīng)用)。（經(jīng)過測試的版本為Tomcat 5.0.25）。

1.2 下載 ActiveBPEl

網(wǎng)址為http://www.activebpel.org/download。文件的名字為activebpel-version-type.tar.gz 或activebpel-version-type.zip。版本號(hào)是：2.0.0。類型為"src" (source), "bin" (binaries), or "all" (source and binaries)。解壓縮下載的文件包，會(huì)創(chuàng)建一個(gè)名字為activebpel-2.0的目錄。可以重新命名，或者移動(dòng)到任何地方。以下的文檔中，簡稱這個(gè)目錄為"activebpel"。

1.3 運(yùn)行腳本 install.bat

執(zhí)行命令行如下：（Windows）

??? C:\> cd \activebpel

??? C:\activebpel> install.bat

腳本將把lib下的內(nèi)容拷貝到$CATALINA_HOME/shared/lib目錄下，并且創(chuàng)建$CATALINA_HOME/bpr目錄，這就是存放流程的配置文件.bpr的目錄。

1.4 更改引擎的配置參數(shù)

在aeEngineConfig.xml文件里可以配置一些服務(wù)的參數(shù)，這個(gè)文件在$CATALINA_HOME/bpr。配置的改變是通過BpelAdmin配置頁改變的，可以訪問http://localhost:8080/BpelAdmin/config.jsp頁，并保存配置。

1.5 啟動(dòng) ActiveBPEL 引擎

要啟動(dòng)ActiveBPEL引擎,只需要啟動(dòng)Tomcat就可以了。

1.6 查看引擎的狀態(tài)信息

當(dāng)tomcat啟動(dòng)后，有兩個(gè)WEB頁可以顯示服務(wù)器的信息

Axis WEB 服務(wù)列表http://localhost:8080/active-bpel/services????

ActiveBPEL 引擎管理http://localhost:8080/BpelAdmin/?

在此頁面可以修改引擎的配置參數(shù)，可查看幫助頁來進(jìn)行學(xué)習(xí)。

?

2 、 ActiveBPEL2.0 引擎的 Mysql 版安裝

?

要使得ActiveBPEL引擎作為一個(gè)可持久化的引擎，需要做以下事情：

2.1 裝數(shù)據(jù)庫和驅(qū)動(dòng)

安裝數(shù)據(jù)庫Mysql和相關(guān)的JDBC驅(qū)動(dòng)，并且保證有權(quán)限做數(shù)據(jù)庫操作。并且要把文件拷貝到${CATALINA_HOME}/common/lib下。

2.2 建庫建表

啟動(dòng)安裝好的數(shù)據(jù)庫，執(zhí)行\activebpel\dist\sql\activebpel\ddl目錄下的ActiveBPEL_MySQL.sql語句，在數(shù)據(jù)庫中創(chuàng)建名為ActiveBPEL的數(shù)據(jù)庫，同時(shí)創(chuàng)建基本表。

2.3 設(shè)置數(shù)據(jù)源

打開${CATALINA_HOME}\conf目錄下的omcat-users.xml文件，增加一個(gè)“admin”的角色，<role rolename="admin"/>，然后增加一個(gè)角色為admin的新用戶。 增加數(shù)據(jù)源的操作如下：

2.3.1 重啟Tomcat,并訪問它的管理頁http://localhost:8080/admin/?

2.3.2 輸入用戶名和密碼

2.3.3 按照以下順序點(diǎn)擊左側(cè)的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按如下數(shù)值配置 Data Source信息。（注：在此之前要確保相關(guān)的JDBC驅(qū)動(dòng)已經(jīng)拷貝到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 按保存按鈕，并一定注意要提交（上方有一個(gè)Commit按鈕）。

2.4 修改 aeEngineconfig.xml 文件

?? 將activebpel/dist/conf下的aeEngineConfig-Persistent.xml文件拷貝到%CATILINA_HOME%\bpr目錄下，并且重命名為 aeEngineconfig.xml，原來的aeEngineconfig.xml文件則被覆蓋掉。

2.5 ActiveBPEL 的內(nèi)存管理模式

如果要使ActiveBPEL引擎 轉(zhuǎn)換到應(yīng)用內(nèi)存管理的模式，可以把/activebpel/dist/conf下的? aeEngineConfig-InMemory.xml文件拷貝到 %CATILINA_HOME%\bpr目錄下。

?2.6 啟動(dòng)

重啟tomcat，啟動(dòng)數(shù)據(jù)庫，打開http://localhost:8080/BpelAdmin/頁，在Home頁可以看到一個(gè)“Start Engine”的按鈕，啟動(dòng)引擎，當(dāng)表中的status為running,則表示啟動(dòng)成功。此時(shí)，即為以一個(gè)可持續(xù)的方式啟動(dòng)了ActiveBPEL引擎。

3 、配置發(fā)布自己的流程

ActiveBPEL 的流程需要?jiǎng)?chuàng)建一個(gè)配置文檔(.jar和.bpr文件),并且把他們拷貝到servelet容器中。為了創(chuàng)建這些文件,需要組織一個(gè)特殊結(jié)構(gòu)的目錄,并創(chuàng)建一兩個(gè)相應(yīng)的配置文件,然后才能通過這些目錄來創(chuàng)建文檔。

3.1 建立目錄

創(chuàng)建一個(gè)目錄,我們假設(shè)這個(gè)例子叫mybpel,然后按照下邊的列表創(chuàng)建它的子目錄:

??? * bpel

??? * META-INF

??? * wsdl

??? * partners (optional)

??? 其中wsdl目錄中包含了所有定義過的WSDL文件,在META-INFM目錄中包含了wsdlCatalog.xml文件, partner definition目錄定義了 .pdef文件.以.pdd為后綴的文件是流程的配置描述。

3.2 編寫文件

作為一個(gè)例子,在各個(gè)的目錄中放入對(duì)應(yīng)的文件,假設(shè)有兩個(gè)WSDL的服務(wù),BPEL的流程名字為? my_process.bpl,各目錄結(jié)構(gòu)如下所示:

??? mybpel

??????? META-INF

??????????? wsdlCatalog.xml

??????? bpel

??????????? my_process.bpl

??????? my_process.pdd

??????? wsdl

??????????? service1.wsdl

??????????? service2.wsdl

除非有.pdef文件,否則不需要partners目錄。

3.3 發(fā)布應(yīng)用

? ?? 打包并拷貝到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

在配置文檔中有多個(gè).bpel或.pdd文件是允許的。另外,WSDL文件可以放在任意位置,即使是另一臺(tái)機(jī)器,只要把他們打包,在.pdd文件中說明,讓BPEL引擎知道它們在哪就可以。

?

HongSoft, 工學(xué)碩士，AgileFlow開源工作流引擎負(fù)責(zé)人，多年工作流產(chǎn)品和技術(shù)相關(guān)經(jīng)驗(yàn)，曾任CSDN工作流專題主編，BEA廣州UserGroup邀請(qǐng)講座嘉賓，在《程序員》《微型機(jī)與應(yīng)用》等雜志發(fā)表技術(shù)文章多篇。