轉帖網上的一篇文章關于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邀請講座嘉賓，在《程序員》《微型機與應用》等雜志發表技術文章多篇。