Deploy on JBoss Application Server with Oracle Database

This chapter gives a step by step description on how to deploy a model manually on a JBoss application server with an Oracle database server.

How to Deploy a Model Manually on JBoss Application Server with Oracle Database Server

1. Start the Oracle database and create a new user.
2. Create a Java Project and import or create a model and the associated source files. For example, create a Java project called DelegateUserTest and import the ACMEWorkflowModel as described in the Getting Started chapter of the Support Case Example tutorial.
3. Select <Java_Project> > Properties and click on the BPM Support entry. Enable the Enable BPM Support entry and click OK.
4. Create a work folder with the two sub-folders lib and etc. Copy the ojdbc14.jar ( for Oracle XE ) or ojdbc15.jar under lib. Copy your carnot.properties file under etc and modify it according to the settings of the local environment. Change license file path, log directory path, audit trail type (Oracle), audit trail driver class ( oracle.jdbc.driver.OracleDriver (oracle.jdbc.OracleDriver in case of using an Oracle version 11g)), audit trail URL ( e.g.: jdbc:oracle:thin:@localhost:1521:xe ), audit trail username and password ( created in step 1 ).
5. Run sysconsole createschema. Please refer to the chapter The Sysconsole Command for information on the sysconsole command.
6. Now deploy your model:
   • In the Outline view right-click your model.
   • Select Export > Process Manager Wizards > Deploy Process Model.
   • Click Next.
   • In the Deploy Process Model Wizard select Advanced and check Custom CARNOT HOME and Custom CARNOT Workspace. Enter <carnot_install_directory> as Stardust home location and <work_folder> as Stardust workspace location.
   • Select Finish.
   • Type in the credentials motu/motu. The message Model was deployed should appear. Please refer to the section Deploying Stardust Models of the Importing, Exporting and Deploying Models chapter for detailed information on how to deploy a process model.
7. Download the preconfigured deployment configuration ipp-archetype-jb51-ipp-ear to prepare the EAR deployment for JBoss 5.1. For details refer to section Downloading Maven Archetype Templates of chapter Creating a Runtime Environment with Apache Maven.
8. Extract the carnot.ear file.
9. Extract the ipp-portal.war file.
10. Add ojdbc14.jar, or ojdbc15.jar respectively, under ipp-portal/WEB-INF/lib.
11. Add carnot.properties under ipp-portal/WEB-INF/classes.
12. Now repack ipp-portal.war.
13. See the following file as a sample carnot.properties file for the Stardust Portal: carnot-example.properties.
14. Edit it according to the local environment.
15. Add carnot.properties for engine under carnot-engine/ and repack carnot-engine.jar.
    See the following file as a sample carnot.properties file for the engine: carnot-engine.properties. Edit it according to the local environment.
16. If there are custom applications to be included, add <custom_application>.jar to carnot/ and modify carnot/META-INF/application.xml to include this jar.
17. Pack the carnot.ear again and copy it to the <JBoss_Installation_Directory>/server/default/deploy.
18. Follow the deployment tutorial for JBoss JBoss in the Deployment Guide and start the server.