ActiveBPEL的安裝和配置

active

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