Procedure for Developing BPEL and Web Services in TAU computer lab

Jackie Assa – Apr 2007

GeneralThis procedure describes how to develop/deploy BPEL to the TAU servers, from both home and TAU lab. It also includes a description on web-services development/deployment. Note that this procedure describes only the necessary steps and details you have in TAU. For a complete description on how to work in BPEL, or if you want to use BPEL server installed on your home computer, see the complete procedure in the Oracle documentation.This guide contains the following sections:

General ................................................................................................................................. 1 Details .................................................................................................................................. 1

Working from TAU lab and using TAU BPEL server .................................................... 1 JDeveloper ................................................................................................................... 2 Connections settings .................................................................................................... 2 Deployment of web services ........................................................................................ 8 Deployment of BPEL process ...................................................................................... 8 Browser ...................................................................................................................... 10 Examining and manual invoking deployed processes ............................................... 10

Working from HOME and using TAU BPEL server ..................................................... 11

Details

Working from TAU lab and using TAU BPEL serverYour main tools for working with the server are:

1. Jdeveloper.2. Firefox.

From the Jdeveloper, you should be able to deploy web services and BPEL processes, and by using the browser you can monitor the deployed BPEL processes and track/test them. Once you deploy a BPEL process and/or a web service on the TAU server, you should be able use it from your home computer, if you follow the guidelines described in the next section ('Working from home…')

JDeveloper

Connections settingsinvoke jdeveloper by writing jdev in a console window. Once JDeveloper starts up, add application server connection:right click 'application server' in the 'connections navigator' view

select new application server connection… the following wizard appears:

select next

write plab-156 in the connection name and set the type to be Oracle Application Server 10g 10.1.3, click next

Write down your group user and password (sent to you directly via Email) and select the 'deploy password'. Click next

select host name as plab-156.cs.tau.ac.il and OPMN port to 6004. Leave the OC4J instance name as home. click next

Select the 'Test Connection' button, your details should be checked and you should get 'Test Succeeded'click finish, the wizard closes.right click in the integration server item in the connections navigator view, and select 'new integration server connection…'

click next

write 'plab-156 bpel' as the connection name and click next.

select plab-156 as the application server connection and plab-156 should be automatically placed as the host name, type 8893 as the port number. click next

Select the 'Test Connection' button, your details should be checked and you should get 'Test Succeeded'click finish, the wizard closes.

Deployment of web servicesinvoke jdeveloper by writing jdev in a console window. load your application/projectIf you have created a web service correctly (as shown in class, or follow one of Oracle tutorials on how to create a web service), you should have a XXX.deploy file in the 'applications navigator' view. Right click it and select deploy to, and plab-156

that’s it, the web service should be uploaded and deployed.

Deployment of BPEL processinvoke jdeveloper by writing jdev in a console window. load your application/projectIf you have created a BPEL process correctly (as shown in class, or follow one of Oracle tutorials on how to create a BPEL process), you should have a XXX.bpel file in the 'applications navigator' view. Right click ON ITS PROJECT FILE and select deploy->BPEL process deployer

The following dialog appears:

select plab-156 as the connection name, host and port should be automatically filled.Select your domain (your color), update the process version number (if you'd like) and press OK. That's it – the process is now deployed.

Browser

Examining and manual invoking deployed processesOpen up a browser, by typing 'firefox' in a command console.set the following URL: http://plab-156:8893/BPELConsole and hit enteryou get the following page:

type in your user/password and click on the login.You get a similar page to this one…

In this screen you can view the deployed processes and their trace (their debug information). To view a specific process details click on its name in the left side links. The following page is shown:

This page allows you to invoke the process manually, by selecting the operation, filling in the process details, and clicking the 'post XML message'

For more details on how to work with the BPELConsole look in the Oracle documentation…

Don't forget to undeploy old process and remove old instances

Working from HOME and using TAU BPEL serverCurrently from home, you can only do operations in the BPELConsole web pages. JDeveloper deployment from home to TAU may be possible but is quite difficult

(impossible) to configure so at this stage deployment should be done only from the lab PCs.

In order to view any web pages from the BPEL/SOA server, you should configure your PC to use HTTP tunneling, because TAU machines are using SSH for all incoming communications. How to do that?download Putty console from the www.cs.tau.ac.il/system web page

once you invoke putty.exe, you get the following screen:

Write nova.cs.tau.ac.il in the host name field, and select ssh in the protocolSelect ssh->tunnels on the left-side tree

select X11 forwarding switch (if you want to run any X app – if you don't know what it is – forget it…)write 8893 in the source port, and plab-156.cs.tau.ac.il:8893 in the destination, and select local. Select Add.This means that any communication requests sent to your localhost at port 8893, will be relayed (transferred to) nova.cs.tau.ac.il, and from there to plab-156.cs.tau.ac.il to port 8893select session in the left-side tree.write nova in the save sessions field and select save.

Next time when you invoke putty, you only need to select 'nova' from the saved sessions, and this configuration will be loaded so you will not need to reconfigure it again.Select open.A console window appears asking you for your user/password IN TAU. press enter.Once the console shows you the prompt, the tunnel is setup.In your PC, open a browser (either IE of firefox) to the following URL:http://localhost:8893/BPELConsoletype in your group username/password, and continue from there…Other links may also assist you like:http://localhost:8893/emhttp://localhost:8893/http://localhost:8893/ccore

By the way, BPEL deployment can also be done manually without the jdeveloper by using the web-interface. In the BPELConsole (see above) initial screen, on the bottom left, you have a link 'deploy new process'. you need to upload the To view the application server pages as well as

you can also reach web services located on the TAU BPEL server by modifying their wsdl. For this trick you may need to use a copy of the web service wsdl, open it in JDeveloper, and select the 'source' tab.Then, replace all occurrences of plab-156.cs.tau.ac.il:8893 with localhost:8893

Use this WSDL to create a web service proxy. This will configure your web service proxy to use the tunnel by directing its requests to localhost:8893 (to the tunnel entry).