Installing BPEL designer and Apache ODE on Eclipse v3.4.x

This tutorial presents you how to install the BPEL designer and Apache Orchestration Director Engine (ODE) on Eclipse 3.4.x (Ganymede) for simulating BPEL processes. The installation is processed on Windows OS.

Note: For the students of the course CSC5522, you start from here:

Installing Eclipse BPEL designer

  1. Suppose that you have already downloaded and installed your Eclipse 3.4.x(Ganymede), version for Java EE Developers and JDK (version > 1.5).
  2. Open the Eclipse, go to the menu Help->Software Update and select the tab Available Software.
  3. Click on the button Add Site and define a new Eclipe update site with the location:
  4. http://download.eclipse.org/technology/bpel/update-site/

  5. Now you have the update-site of BPEL available on the eclipse. NSelect the check box to BPEL Visual Designer 0.4.0 and click on the button Install.
  6. install BPEL Virsual Designer
  7. Follow the installation windows, you will now have your BPEL installed on Eclipse. Note that: the BPEL dependencies(WTP, EMF, GEF, JEM) should be installed before the BPEL designer.
  8. After finishing the installation, you will be asked to restart the Eclipse. Restart it.
  9. To verify the installation was successful, after the restart, click on File->New->Other, you will see the BPEL 2.0 is on the list.
  10. Verifying BPEL installation

The BPEL designer is now ready to use. However, to run the BPEL process, you should have the server's environment. Now, we are going to install the Apache ODE for the BPEL deployment.

Installing Apache ODE

  1. Download the ODE from the Apache web site. The current stable version is the ODE 1.3.3. Download and extract the WAR distribution.
  2. Verifying BPEL installation
  3. Inside the "apache-ode-war-1.3.3" folder, you will see an "ode.war" file. Copy this file to your TOMCAT_DIR\webapps directory.
  4. Verifying BPEL installation
  5. Now, start your tomcat server to automatically deploy the "ode.war" file. In your TOMCAT_DIR\bin folder, double click on the file "startup.bat".
  6. Verifying BPEL installation
  7. If the ODE is successfully deployed, there will be a folder named "ode" in the TOMCAT_DIR/webapps directory.
  8. Verifying BPEL installation
  9. Terminate your running tomcat by close the console or press Ctrl_C.
  10. Note that: You can also download and extract the "ode.war" file directly to the TOMCAT_DIR/webapps directory instead of following the step 3, 4, 5 above.

Now, you have finished the installation steps. Now, you are going to set up the ODE server on Eclipse to run the BPEL application.


With the course CSC5522, you do not need to perform the previous steps, just start from here:

  1. Eclipse Galileo with BPEL designer were installed. You can run it by select Applications->Programmation->Eclipse.
  2. For the server runtime environment, you download the tomcat to your home's folder.
  3. Extract the tomcat using the command: tar xvfz apache-tomcat-5.5.29.tar.gz or right click on the downloaded file and select Extraire ici .
  4. Download the ode.war to yourTomcat/webapps/ folder. Right click to this ode.war file. Select Extraire ici.
  5. That's all.

Setting up the ODE server on Eclipse

  1. Show the "Servers" view by selecting the menu Windows->Show View->Servers.
  2. Verifying BPEL installation
  3. Right click on the empty space of the "Servers" view, select New->Server.
  4. Verifying BPEL installation
  5. Leave the server host name as localhost and select the server type as the Apache->Ode v1.x Server. Rename the server's name if you want. In my installation, I keep the default name. Then click on the button Next.
    Verifying BPEL installation
  6. Select the JRE as the Default JRE which was integrated in the Eclipse. Set the path to the ODE's home directory and the Tomcat directory. Then, set the Tomcat's port as the port in its configuration file. The default port is 8080.
    Verifying BPEL installation
    Note that: the ODE Runtime configuration above can also be added or editted using the menu Windows->Preferences->Server->Runtime Environments.
    Verifying BPEL installation
  7. Click Finish. You now have the ODE server which is ready to run on the Eclipse. You can see this server on the Server View.
  8. Verifying BPEL installation
  9. Now, you should test the server's configuration by right click on the ODE server entry and select Start. Or you can click on the Start button on the Server View. If the server is sucessfully started, you will see the status like this.
  10. Verifying BPEL installation
  11. Terminate the server by clicking on the Stop button or right click on the server and select Stop. Every thing is ready now for the first BPEL program.

Some questions:

  1. Change the ODE Server's port to another number (such as 9090) using the "Note" in the step 4, part "Setting up the ODE server on Eclipse". Then, can you start/stop the ODE server?
  2. Now, you change the server's connector port in the file TOMCAT_DIR\conf\server.xml to the ODE Server's port number (9090 as above). Save the file. Can you start/stop the server?
  3. Right click on the ODE server, select Properties. Continue clicking on the button Switch Location and OK. Now, can you start/stop it?
  4. What do you infer or conclude from the previous problems?

List of TPs

Created by Nguyen Ngoc Chan (04/2010)