Install Development Prerequisites
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
These prerequisites apply both for release 7.1 and for development.
The examples on this guide are using the following versions:
- Ubuntu 18.04.3 64 bits
- PostgreSQL 9.6.16 (used for this guide, you can use any postgres >=9.6)
- PostgreSQL contrib (for UUID support)
- git Client 2.17.1
- Maven 3.6.0
- OpenJDK 11.0.5
- Eclipse IDE for Enterprise Java Developers 4.14.0 2019-12
- 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.
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 git Client
sudo apt-get install git
Install OpenJDK 11
sudo apt-get install openjdk-11-jdk
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-12
Download the corresponding version for your operating system from "Eclipse IDE for Enterprise Java Developers"
For Ubuntu 18.04.3 64 bits I downloaded 2019-12 version 4.14.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 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.