Chimera Documentation

Introduction

Chimera is a platform for executing Production Case Management (PCM) scenarios. It allows to integrate external events relevant to the running processes. It was developed by the bachelor project team in the winter and summer semester 2014/2015 at the BPT chair. Event integration and additional features were contributed by the following bachelor project in 2015/16.

Chimera-Setup

Pre-requisites

The following software is necessary to build and run Chimera:
  • Oracle JDK 8 or OpenJDK, available here. Make sure the environment variable $JAVA_HOME points to your JDK folder (e.g. like this)
  • Apache Tomcat 7 or 8, available here.
  • MySQL 5.7 Server, available here.
We recommend an IDE for development, which often brings its own support tools. In case they are neither included nor already installed, you need to set up the following:
  • git, available here, to access the code repositories.
  • Apache Maven 3, available here. (setup)

Initial setup

  1. Prepare your MySQL server
    • Start up the MySQL server
    • Create the schema JEngineV2 (e.g. mysql -e "create schema JEngineV2;")
    • Populate the schema with JEngineV2_schema.sql (e.g. mysql < ./src/main/resources/JEngineV2_schema.sql)
  2. You may need to create or adapt the project configuration (./src/main/resources/config.properties, template: config_template.properties)

Deployment

Once your environment is set up, you should be able to deploy Chimera:
When using Tomcat 7 the easiest option is to run mvn tomcat7:redeploy -DskipTests.
Alternatively, you can deploy manually:
  1. Build the project with mvn install -DskipTests
  2. Stop Tomcat if it is running
  3. Copy ./target/Chimera.war to the webapps directory of Tomcat
  4. Start tomcat again
  5. You should now be able to see the JEngine frontend at http://localhost:8080/Chimera

Troubleshooting

Please check the log file 'chimera.log' in your tomcat log folder.

Editor setup

Pre-requisites

The following software is necessary to build and run the editor:
  • Node.js, available here.
    • npm is already included.
    • node-gyp to build other components (npm install -g node-gyp)
      • this may require the build-essentials tools (sudo apt-get install build-essential)
    • browserify to compile scripts (npm install -g browserify)
  • mongodb, available here.
When using Windows you have to install the following additional dependencies:
  • Python 2.7, available here.
  • Microsoft Visual Studio, available here. (any version should work, as long as you use the proper
    --msvs_version=20XY switch for npm, e.g. XY=15 for VS2015)

Initial setup

  1. Initialize required modules (npm install)
  2. Create a database in mongodb (e.g. mongo> use griffin)
  3. Add your database to config.js (edit the MONGODB_HOST: property)

Deployment

Once your environment is set up, you should be able to deploy the editor:
  1. Compile the script sources: browserify -t [ babelify --presets [ react ] ] ./public_src/js/index.js -o ./public/js/bundle.js
  2. Run the express server: node bin/www
  3. You should now be able to see the editor frontend at http://localhost:3000/

-- BachelorProject - 14 Mar 2016