Orchestra User Guide This document contains an installation and user guide for Orchestra 4.8.0 Orchestra Team - June 2011 - Copyright © 2010 Bull SAS - OW2 Consortium Table of Contents Introduction ...................................................................................................................... iv 1. General information ........................................................................................................ 1 1.1. Orchestra Overview .............................................................................................. 1 1.2. Features list ......................................................................................................... 1 1.3. Restrictions ......................................................................................................... 1 1.4. Next steps ........................................................................................................... 2 2. Prerequisites ................................................................................................................... 3 2.1. Hardware ............................................................................................................ 3 2.2. Software ............................................................................................................. 3 3. Installation guide ............................................................................................................ 4 3.1. Web Service Frameworks ...................................................................................... 4 3.1.1. Apache Axis ............................................................................................. 4 3.1.2. Apache CXF ............................................................................................. 4 3.2. Orchestra Tomcat distribution ................................................................................. 4 3.2.1. Installation ................................................................................................ 4 3.2.2. Database Management ................................................................................ 5 3.2.3. Orchestra directory structure ........................................................................ 6 3.3. Orchestra OSGI Felix distribution ........................................................................... 7 3.3.1. Installation ................................................................................................ 7 3.3.2. Database Management ................................................................................ 7 3.3.3. Orchestra directory structure ........................................................................ 7 3.4. SOA console stand-alone installation ....................................................................... 9 4. Configuration and Services ............................................................................................. 10 4.1. Simple configuration ........................................................................................... 10 4.2. Configuring logger .............................................................................................. 10 4.3. Services Container .............................................................................................. 11 4.3.1. Environment.xml file ................................................................................ 11 4.4. Services ............................................................................................................ 13 4.4.1. Publisher ................................................................................................. 14 4.4.2. Invoker ................................................................................................... 14 4.4.3. Repository ............................................................................................... 14 4.4.4. Persistence .............................................................................................. 14 4.4.5. Journal and History .................................................................................. 15 4.4.6. Querier ................................................................................................... 15 4.4.7. Command service ..................................................................................... 15 4.4.8. Asynchronous Executions (Jobs) ................................................................. 16 4.4.9. Finished instance handler (FIH) .................................................................. 18 4.4.10. Undeployed process handler (UPH) ............................................................ 18 5. User guide ................................................................................................................... 20 5.1. Start and Stop Orchestra ...................................................................................... 20 5.2. Other commands ................................................................................................. 20 5.3. Running the examples ......................................................................................... 20 5.4. Running the tests ................................................................................................ 21 5.5. Process designers ................................................................................................ 21 5.6. Deploying / undeploying a process ......................................................................... 21 5.7. Process lifecycle ................................................................................................. 22 6. Console User Guide ....................................................................................................... 24 6.1. Quick start guide ................................................................................................ 24 6.2. Default Users ..................................................................................................... 24 6.3. Process View ..................................................................................................... 25 6.3.1. Deploy a process ...................................................................................... 25 ii Orchestra User Guide 6.3.2. Information about a process ....................................................................... 26 6.3.3. Actions on a deployed process .................................................................... 27 6.4. Instance View .................................................................................................... 28 6.4.1. Information about an instance ..................................................................... 28 6.4.2. Actions on an instance .............................................................................. 29 6.5. Activities View .................................................................................................. 30 6.6. Other Features .................................................................................................... 30 7. Advanced features ......................................................................................................... 31 7.1. Monitoring and administration with JMX ................................................................ 31 7.1.1. Orchestra MBean for thread pools ............................................................... 31 7.2. Clustering configuration ....................................................................................... 31 7.3. Using Apache Camel with Orchestra ...................................................................... 32 7.3.1. How to create a Camel context for a process ? ............................................... 32 7.3.2. How to use camel context instead of HTTP for Web Service interactions ? ........... 32 7.4. Process versioning with Orchestra .......................................................................... 33 7.4.1. Process versions ....................................................................................... 33 7.4.2. Restrictions on versioning .......................................................................... 33 8. Developer's guide .......................................................................................................... 35 8.1. Orchestra APIs ................................................................................................... 35 8.1.1. Getting started with Orchestra APIs ............................................................. 35 8.2. Orchestra Client jar ............................................................................................. 36 8.3. Adding new Orchestra services implementations ....................................................... 36 iii Introduction This documentation is targeted to Orchestra users. It presents the installation procedure and a quick user guide of Orchestra features. Chapter 1, General information describes the new version Orchestra v4 Chapter 2, Prerequisites describes the prerequisites to the installation of Orchestra Chapter 3, Installation guide describes how to install the Orchestra engine Chapter 4, Configuration and Services describes main configuration features and default services Chapter 5, User guide This chapter will guide you through the discovery of the functionalities of Orchestra. Chapter 6, Console User Guide describes how to use the SOA console with Orchestra. Chapter 7, Advanced features describes advanced features provided