ActiveBPEL™ Designer User’s Guide

Previous | Next | Index

Tutorial Part 10: Running the Process on the Server

To start at the beginning of the tutorial, see Introduction to ActiveBPEL Tutorial.

If you have followed all tutorial parts so far, you have deployed a BPEL process to ActiveBPEL Server.

After deploying the process to the ActiveBPEL Server, you can run the process by sending in a loan amount request and getting back a response from the assessor or approver.

You should have the following files in the following location:

• ActiveBPEL Designer Installation folder\Server\ActiveBPEL_Tomcat\bpr\tutorial.bpr

This file is your deployment archive, which you copied to this location.

• ActiveBPEL Designer Installation folder\Server\ActiveBPEL_Tomcat\bin\startup.bat

This start-up file is part of the ActiveBPEL installation.

• ActiveBPEL Designer Installation folder\Samples\ActiveBPEL_Tutorial_Complete_Files\ActiveBPEL_Tutorial_test_page.war

This file serves as a test page to send and receive messages to the process.

• ActiveBPEL Designer Installation folder\Samples\ActiveBPEL_Tutorial_Complete_Files\loan_approval_config.xml

This is a data file used by the test page.

• ActiveBPEL Designer Installation folder\Samples\ActiveBPEL_Tutorial_Complete_Files\ActiveBPEL_Tutorial_web_services.wsr

This is a file used by the test page.

By completing Part 10 of the tutorial, you will be able to:

• Add test files to the appropriate server folders
• Start the ActiveBPEL engine
• View the ActiveBPEL Administration Console
• Send a request to the process and receive a reply

Step 1: Copy the test page and related files to required folders

You must copy the test page to the server webapps folder and copy the sample data file to the server temp folder.

1. Copy ActiveBPEL Designer Installation folder\Samples\ActiveBPEL_Tutorial_Complete_Files\ActiveBPEL_Tutorial_test_page.war to \\ActiveBPEL Designer Installation folder\Server\ActiveBPEL_Tomcat\webapps.
2. Copy ActiveBPEL Designer Installation folder\Samples\ActiveBPEL_Tutorial_Complete_Files\loan_approval_config.xml to ActiveBPEL Designer Installation folder\Server\ActiveBPEL_Tomcat\temp.
3. Copy ActiveBPEL Designer Installation folder\Samples\ActiveBPEL_Tutorial_Complete_Files\ActiveBPEL_tutorial_web_services.wsr to ActiveBPEL Designer Installation folder\Server\ActiveBPEL_Tomcat\bpr.

Step 2: Start the server

The ActiveBPEL Server consists of the ActiveBPEL engine running under Apache Tomcat 5.5. Tomcat is the servlet container that is used in the official Reference Implementation for the Java Servlet and JavaServer Pages technologies.

Note: If you already have Tomcat set up on your server, you may need to unset the CATALINA_HOME environment variable in order to run the ActiveBPEL engine. This environment variable is set in the start-up file for the ActiveBPEL server.

1. Do one of the following:
• From the Windows Start menu, select Programs>Active Endpoints>ActiveBPEL Designer>Start ActiveBPEL Tomcat Server

or

• Double-click startup.bat, located in:

ActiveBPEL Designer Installation folder\Server\ActiveBPEL_Tomcat\bin

2. Tomcat starts up in a command window, and the ActiveBPEL engine also starts.
3. When startup completes with the message, “Server startup,” minimize the command window.

Step 3: View the ActiveBPEL Administration Console

When the ActiveBPEL engine starts, it scans the bpr folder for deployed processes. You can view a list of deployed processed.

1. Open your Web browser, and type the following URL into the Address field:

http://localhost:8080/BpelAdmin

If your computer is already using port 8080, change the port number.

2. Your browser should look similar to the following example:



3. If there are no deployed processes, ensure that you have copied tutorial.bpr to the correct location, described at the beginning of this part of the tutorial.

Step 4: Send a request to the process

You can create an instance of the process by using the test client to initiate the Receive activity in tutorial.bpel. The test client returns a Reply.

1. Open a new instance of your Web browser.
2. Type the following URL into the Address field:

http://localhost:8080/ActiveBPEL_Tutorial_test_page

Change the port number, if necessary.

3. Your browser displays the test client from which you can enter values and receive a response, as shown in the following example:



4. Enter a value for the loan amount, such as 500.
5. If you deployed the loanapproval_tutorial_complete.bpr, in the URL field, change LoanService to LoanServiceComplete.
6. Select low for the Assessor reply. This means that the variable risk used in the Assessor invoke activity contains this value.
7. Select yes for the Approver reply. This means the variable approval used in both the Approver invoke and the assign activities contain this value.
8. Click Apply for a Loan to see the results.

You can also debug your running or completed process from within ActiveBPEL Designer. To do so, go to Tutorial Part 11: Debugging Your Process Remotely.

Tip: You can download the ActiveBPEL Enterprise versions of the tutorial support files from the Active Endpoints Web site. Sample assessor/approver Web services are available for execution on your Java-based or .NET-based ActiveBPEL Enterprise product. For details, see the Samples page of the www.active-endpoints.com.

Copyright (c) 2004-2007 Active Endpoints, Inc.