一、安裝和配置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引擎知道它們在哪就可以.