|
cameran 發表于 2006-7-1 18:47:15
|
一、安裝和配置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、停止引擎
關閉TOMCAT
Windows:
??? 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引擎知道它們在哪就可以.
|