Install Development Prerequisites

From iDempiere en
Jump to navigation Jump to search

Table of Contents | Install Development Prerequisites | Download the Code

Development Prerequisites for branch release-6.2

The examples on this guide are using the following versions:

  • Ubuntu 18.04.2 64 bits
  • PostgreSQL 9.6.12
  • PostgreSQL contrib (for UUID support)
  • Mercurial Client 4.5.3
  • Maven 3.6.0
  • OpenJDK 11.0.1
  • Eclipse IDE for Java EE Developers 4.9.0 SimRel.2018-09
  • Java 11 Support for Eclipse 2018-09 (4.9)
  • Mercurial Eclipse Plugin 2.7.0
  • Tycho Build Tools
  • Tycho Configurator

But this guide can be used in other systems (even Windows) taking care of installing the corresponding packages and using corresponding commands.

Install Ubuntu

Please refer to http://www.ubuntu.com/download

Install PostgreSQL 9.6

iDempiere can also run with Oracle 11G or 12C, and also with any PostgreSQL >= 9.6, but for this tutorial we use postgresql 9.6 - see http://www.postgresql.org/download/linux/ubuntu/ for details

echo "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
# NOTE: alternatively you can install postgresql 11 (it includes contrib)
# sudo apt-get install postgresql-11
sudo apt-get install postgresql-9.6 postgresql-contrib-9.6

Install Mercurial Client 4.5.3

sudo apt-get install mercurial

Install OpenJDK 11.0.1

sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt-get update
sudo apt-get install openjdk-11-jdk

Install Maven 3.6.0

sudo apt-get install maven

Or alternative you can get maven installed manually. I use apache-maven-3.6.0 installed in a local folder, you can follow instructions to install maven from maven manual

Install Eclipse Simrel

Download the corresponding version for your operating system from "Eclipse IDE for Java EE Developers"

For Ubuntu 18.04.2 64 bits I downloaded SimRel.2018-09 version 4.9.0 here

On Ubuntu, you just uncompress it and it is ready for use. You could move the folder somewhere sensible, but this is optional. For the purposes of this tutorial, let's suppose you uncompressed Eclipse in a folder called $ECLIPSE_HOME.

The first time you run Eclipse it will ask you for the workspace folder. You can use the default workspace because you will change it later,

Install Java 11 Support for Eclipse

  • Navigate to Help > Install New Software
  • Fill the Work with box with the URL http://download.eclipse.org/eclipse/updates/4.9-P-builds/ and push Enter key
  • Select the option "Eclipse Java 11 support for 2018-09 development stream"
  • Click Next button and then Finish button
    • Accept the terms, certificate, etc until installed, no need to restart yet

Install Mercurial Eclipse Plugin 2.7.0

  • Navigate to Help > Eclipse Marketplace
  • Fill the Find box with: MercurialEclipse
  • Push the "Go" button
  • Push the "Install" button in front of the "MercurialEclipse 2.2" found (note this install 2.7.0 despite is named 2.2)
    • Accept the terms, certificate, etc until installed, no need to restart yet

Install Tycho Build Tools

Install Tycho Configurator

  • Navigate to Window > Preferences
  • Navigate to Maven > Discovery
  • Click Open Catalog
  • On Find field, enter Tycho
  • Select Tycho Configurator, click Finish to install it
    • Accept the terms, certificate, etc until installed

Now you have your prerequisites ready to receive the iDempiere sources, eclipse can be restarted now.

Development Prerequisites for branch default (a.k.a. 6.2z)

The examples on this guide are using the following versions:

  • Ubuntu 18.04.2 64 bits
  • PostgreSQL 9.6.12
  • PostgreSQL contrib (for UUID support)
  • Mercurial Client 4.5.3
  • Maven 3.6.0
  • OpenJDK 11.0.1
  • Eclipse IDE for Enterprise Java Developers 4.11.0 2019-03
  • Mercurial Eclipse Plugin 2.7.0
  • Tycho Build Tools
  • Tycho Configurator

But this guide can be used in other systems (even Windows) taking care of installing the corresponding packages and using corresponding commands.

Install Ubuntu

Please refer to http://www.ubuntu.com/download

Install PostgreSQL 9.6

iDempiere can also run with Oracle 11G or 12C, and also with any PostgreSQL >= 9.6, but for this tutorial we use postgresql 9.6 - see http://www.postgresql.org/download/linux/ubuntu/ for details

echo "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install postgresql-9.6
sudo apt-get install postgresql-contrib-9.6  # this is not required after postgresql-10

Install Mercurial Client 4.5.3

sudo apt-get install mercurial

Install OpenJDK 11.0.1

sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt-get update
sudo apt-get install openjdk-11-jdk

Install Maven 3.6.0

sudo apt-get install maven

Or alternative you can get maven installed manually. I use apache-maven-3.6.0 installed in a local folder, you can follow instructions to install maven from maven manual

Install Eclipse 2019-03

Download the corresponding version for your operating system from "Eclipse IDE for Enterprise Java Developers"

For Ubuntu 18.04.2 64 bits I downloaded 2019-03 version 4.11.0 here

On Ubuntu, you just uncompress it and it is ready for use. You could move the folder somewhere sensible, but this is optional. For the purposes of this tutorial, let's suppose you uncompressed Eclipse in a folder called $ECLIPSE_HOME.

The first time you run Eclipse it will ask you for the workspace folder. You can use the default workspace because you will change it later,

Install Mercurial Eclipse Plugin 2.7.0

  • Navigate to Help > Install New Software
  • Fill the Work with box with the URL https://bitbucket.org/mercurialeclipse/update-site/raw/default/ and push Enter key
  • Select the option "MercurialEclipse Stable Releases"
  • Click Next button and then Finish button
    • Accept the terms, certificate, etc until installed, no need to restart yet

Install Tycho Build Tools

Install Tycho Configurator

  • Navigate to Window > Preferences
  • Navigate to Maven > Discovery
  • Click Open Catalog
  • On Find field, enter Tycho
  • Select Tycho Configurator, click Finish to install it
    • Accept the terms, certificate, etc until installed

Now you have your prerequisites ready to receive the iDempiere sources, eclipse can be restarted now.


This tutorial is brought to you by Carlos Ruiz from GlobalQSS. Feel free to improve directly or suggest using the Discussion tab.