Install Development Prerequisites

From iDempiere en

Table of Contents | Install Development Prerequisites | Download the Code

IMPORTANT NOTE BEFORE STARTING: There is an alternative for fast installing development environment being worked by Heng Sin - you can check and test it here: https://github.com/hengsin/idempiere-dev-setup

Prerequisites

These prerequisites apply both for release 8.2 and for development.

The examples on this guide are using the following versions:

  • Ubuntu 20.04 64 bits
  • PostgreSQL 9.6 (used for this guide, you can use any postgres >=9.6)
  • PostgreSQL contrib (for UUID support)
  • git Client
  • Maven 3.6.3
  • OpenJDK 11
  • Eclipse IDE for Enterprise Java Developers 2021-03
  • Tycho Configurator

This guide can be used in other systems (even Windows) taking care of installing the corresponding packages and using corresponding commands. However, for Windows is easier to follow these video tutorials

Install Ubuntu

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

Install PostgreSQL 9.6

iDempiere can also run with Oracle 11g, 12c or 18c, 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

# Create the file repository configuration:
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /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 in some operating systems and postgres versions

Configure pg_hba.conf

After installing postgres you must check the correct configuration of /etc/postgresql/9.6/main/pg_hba.conf

The following line requires change of the authentication method:

local   all             all                                     peer

Change to:

local   all             all                                     md5

Please NOTE that some guides suggest configuring trust instead of md5 - but that creates a security issue on your postgres.

And then reload the configuration:

sudo service postgresql reload

Install git Client

sudo apt-get install git

Install OpenJDK 11

sudo apt-get install openjdk-11-jdk

Install Maven

sudo apt-get install maven

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

Install Eclipse 2021-03

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

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 pointed with the variable $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 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 BX Service GmbH. Feel free to improve directly or suggest using the Discussion tab.

Table of Contents | Install Development Prerequisites | Download the Code

Cookies help us deliver our services. By using our services, you agree to our use of cookies.