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!

How to build Flowable from a sources under Windows 7

How to build Flowable from a sources under Windows 7

This manual describes (in step by step manner) how to build Flowable from the sources under Windows 7 OS (x64 bit arch).

Install last version of Java JDK

First of all there is needed to install last version of Java JDK (Java SE Development Kit). The Java JDK available at the link.

1.    Download the archive server-jre-8u***-windows-x64.tar.gz
2.    Uncompress the archive to C:\java-8u***

Set the JAVA_HOME variable in Windows

1.    Right click My Computer and select Properties -> Advanced
2.    Click the Environment Variables button.
3.    Under System Variables, click New.
4.    In the Variable Name field, enter either:
       JAVA_HOME
5.    In the Variable Value field, enter your JDK or JRE installation path
        C:\java-8u***
6.    Click OK and Apply Changes as prompted.

Install Apache Ant (original instruction)

1.    Download last version of Ant. Link on Binary Edition.
2.    Uncompress the downloaded file into a directory - C:\ant
3.    Set environmental variables ANT_HOME to your Ant directory: C:\ant
4.    Also add %ANT_HOME%/bin (Windows) to your PATH environment variable.
5.    Optionally, from the ANT_HOME directory run ant -f fetch.xml -Ddest=system to get the library dependencies of most of the Ant tasks that require them. If you don't do this, many of the dependent Ant tasks will not be available. See Optional Tasks for details and other options for the -Ddest parameter.
6.    Optionally, add any desired Antlibs. See Ant Libraries for a list.

Install Maven (original instruction)

1.    Download Maven zip file from the official web site, for example: apache-maven-3.2.2-bin.zip, unzip it to the folder: C:\Program Files\Apache\maven
2.    Add both M2_HOME and MAVEN_HOME variables in the Windows environment, and point it to your Maven folder.

3.    Update PATH variable, append Maven bin folder – %M2_HOME%\bin, so that you can run the Maven’s command everywhere.

4.    To verify it, run mvn –version in the command prompt.

Clone "Flowable" sources on local computer and build it

1.    Install git on local computer (link).
2.    Open console window by cmd command.
3.    Create folder for Flowable sources then navigate to the folder you just created.

4.    Clone the Flowable repository by command: 
       git clone https://github.com/flowable/flowable-engine.git

5.    Once the cloning is completed navigate to the folder - D:\Flowable\flowable-engine\distro
6.    Run the following command in the console: ant
7.    When building process will be completed all installation (war) files will be available in the folder: D:\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!