How to build Flowable from a sources under Ubuntu Server 16.04 LTS

How to build Flowable from a sources under Ubuntu Server 16.04 LTS

This manual describes (in step by step manner) how to build Flowable from the sources under Ubuntu Server 16.04 LTS (x64 bit arch).



First of all we need to update our system. To do this please runs the following command:

• apt-get update && apt-get upgrade 

 Install Oracle Java 8

• add-apt-repository ppa:webupd8team/java
• apt-get install oracle-java8-installer
• apt-get install oracle-java8-set-default
• update-alternatives --config java
• update-alternatives --config javac
• java -version

Set the JAVA_HOME and other system variables

 

Create file - jdk.sh in the dir - /etc/profile.d/

• touch jdk.sh

It is necessary to make this file (/etc/profile.d/jdk.sh) executable. To do this use the command:

• chmod 755 /etc/profile.d/jdk.sh

Then add the following command in it:

• export J2SDKDIR=/usr/lib/jvm/java-8-oracle
• export J2REDIR=/usr/lib/jvm/java-8-oracle/jre
• export PATH=$PATH:/usr/lib/jvm/java-8-oracle/bin:/usr/lib/jvm/java-8-oracle/db/bin:/usr/lib/jvm/java-8-oracle/jre/bin
• export JAVA_HOME=/usr/lib/jvm/java-8-oracle
• export DERBY_HOME=/usr/lib/jvm/java-8-oracle/db

Install Apache Ant

• apt-get install build-essential libssl-dev libcurl4-gnutls-dev libexpat1-dev gettext unzip
• apt-get install ant

Create file - ant.sh in the dir - /etc/profile.d/:

• touch ant.sh

It is necessary to make this file (/etc/profile.d/ant.sh) executable. To do this use the command:

• chmod 755 /etc/profile.d/ant.sh

Then add the following command in it:

• export ANT_HOME=/usr/local/ant
• export PATH=${ANT_HOME}/bin:${PATH}

Install Maven

• apt-get install maven

Create file - maven.sh in the dir - /etc/profile.d/:

• touch maven.sh

It is necessary to make this file (/etc/profile.d/maven.sh) executable. To do this use the command:

• chmod 755 /etc/profile.d/maven.sh

Then add the following command in it:

• export M2_HOME=/usr/share/maven
• export PATH=${M2_HOME}/bin:${PATH}

Install Git

• apt-get install git 

 

Clone "Flowable" sources on the current server and build it

1. Create a folder for example: mkdir /home/user/flowable
2. Move to the folder: cd /home/user/flowable
3. Clone Flowable repository into the folder:
   git clone https://github.com/flowable/flowable-engine.git
4. Move to the folder: cd /home/user/flowable/flowable-engine/distro/
5. Run the command: ant
6. When building process will be completed all installation (war) files will be available in the folder: /home/user/flowable/flowable-engine/distro/target/zip/flowable-6.0.1-SNAPSHOT/wars/

I hope this instruction will be useful for anybody who want to build Flowable from the sources.

If at the end you received a build error do not worry this error is related to the build of user's manual!

Thanks for reading!