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. Right-click your Java project and select Properties.
4. Click the BPM Support entry and enable the Enable BPM Support option.
5. Click OK.
6. Create a work folder with the two sub-folders lib and etc. Copy the ojdbc6.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 ).
7. Run sysconsole createschema. Please refer to the chapter The Sysconsole Command for information on the sysconsole command.
8. Now deploy your model:
   • In the Outline view right-click your model.
   • Select Deploy Model.
   • The Deploy Model dialog opens.
   • Click OK.
   • The message Model was deployed should appear. Please refer to the section Deploying Stardust Models of the Importing and Exporting Models chapter for detailed information on how to deploy a process model.
9. Download the preconfigured deployment configuration ipp-archetype-jb62-eap-ipp-ear to prepare the EAR deployment for JBoss EAP 6.2. For details refer to section Downloading Maven Archetype Templates of chapter Creating a Runtime Environment with Apache Maven.
10. Extract the carnot.ear file. For details on how to receive a carnot.ear file, refer to chapter Creating a Stardust Runtime Environment with Apache Maven in the Installation Guide.
11. Extract the ipp-portal.war file.
12. Add ojdbc6.jar to ipp-portal/WEB-INF/lib.
13. Add carnot.properties under ipp-portal/WEB-INF/classes.
14. Now repack ipp-portal.war.
15. See the following file as a sample carnot.properties file for the Stardust Portal: carnot-example.properties.
16. Edit it according to the local environment.
17. 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.
18. 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.
19. Pack the carnot.ear again and copy it to the <JBoss_Installation_Directory>/server/default/deploy.
20. Follow the deployment tutorial for JBoss JBoss in the Deployment Guide and start the server.