Setting up development environment with Intellij IDEA Community Edition - bluesoft-rnd/aperte-workflow-core GitHub Wiki

This tutorial shows the basic way of creating fully functional Aperte Workflow development environment with IntelliJ IDEA Community Edition. Most important steps were described and covered here. However, it's assumed that one already is familiar with this work environment, because we do not provide screenshots and explanations for every operation.

Software versions

This tutorial was prepared and tested on:

  • IntelliJ IDEA Community Edition 11.0.1
  • Fedora 16 x86_64
  • Oracle JDK 1.6u30 x86_64
  • Liferay 6.0.6 bundled with Tomcat 6.0.29
  • Apache Maven 3.0.3

Install IntelliJ IDEA

  1. Download IntelliJ IDEA Community Edition
  2. Install IDEA (from now on, we refer to this directory as $IDEA_HOME)
  3. Start IDEA by executing $IDEA_HOME/bin/idea.sh.

Configure runtime environment with Liferay Portal

  1. Download Liferay Portal. We suggest using Liferat Portal Community Edition 6.0.6 bundled with Tomcat for development environment. This is also the version we provide with our Aperte Workflow bundle.
  2. Unpack Liferay Portal (from now on we refer to this directory as $LIFERAY_HOME).
  3. Update Vaadin to the version used by Aperte Workflow.

Start Liferay Portal

Because IntelliJ IDEA Community Edition doesn't provide extended J2EE support (which is of course available in paid, ultimate version) one should start Liferay Portal with console scripts.

  1. Go to $LIFERAY_HOME/tomcat-6.0.29/bin
  2. Create new executable script startup-aperte.sh. This step is optional, however it describes a clean way to influence runtime properties e.g. $JAVA_OPTS. Sample configuration, with standard debug port set to 5005, is show below:
#!/bin/bash

JAVA_DEBUG_OPTS="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005"

export JAVA_OPTS="$JAVA_DEBUG_OPTS $JAVA_OPTS"
echo "Using JAVA_OPTS:       $JAVA_OPTS"

`dirname $0`/startup.sh $@