Category

installation

Installing iDempiere within eclipse (Development setup)

This post will help you to install iDempiere development environment.

I have tested this installation for

  1. iDempiere 3.1 using this with java 7 update 80 and Eclipse version  Luna Service Release 2 (4.4.2)
  2. iDempiere 4.1 using java 8 update 112 and Eclipse Version: Neon.2 Release (4.6.2) on my MacBook.

Following are the instruction needs to be followed step by step. If java and Postgres is already installed then skip first two steps.

Install JDK


Database

Install PostgreSQL

Mercurial

For managing versions and source code control we need to install Mercurial . It is an open source application. Find the more info & simple useful tutorial. To download the mercurial use following link. It provides a graphical installer.

Clone iDempiere

Download iDempiere source tree

hg clone https://bitbucket.org/idempiere/idempiere idempiere

Eclipse

Download eclipse (I am using luna) . There are new versions of eclipse available to download. I have not tested with them.


  • https://eclipse.org/luna/
  • Eclipse workspace setup - Select the iDempiere cloned directory as the workspace.

  • Install the eclipse buckminster
    • You need the Buckminster Plugin to assemble the iDempiere project. For this go to  (Menu in Eclipse: Help > Install New Software > Add)
      • Add name as buckminster
      • location – http://download.eclipse.org/tools/buckminster/updates-4.4
    • Now it will load all the available packages for the installation select only
      • Buckminster – Core
      • Buckminster – Maven support
      • Buckminster – PDE support
  • Install mercurial plugin

 

This is one part of development setup where we finished .

Now to get the iDempiere project into the eclipse.

  • Create a targetPlatform – Go to Eclipse –> Preferences –>Plug in Development—>targetPlatform
    • Click on add
    • Nothing: Start with an empty target definition press next
    • give target name I prefer giving iDempiere
    • add —> Directory —> Location —> click on variable select workspace_loc
    • then type targetPlatfrom so the location will look like ${workspace_loc}/targetPlatform .
    • set this as default
  • Click on File  —-> Import —-> Buckminster —-> Materialize from Buckminster MSPEC, CQUERY or BOM
  • Click on next and select mpsec from clone idempiere directory “org.adempiere.sdk-feature” folder
  • make sure that you have active internet connection through out this process.
  • now the magic will happen based on the machine

Click on Run Configurations

  • Select eclipse application
  • install.console.app click on run and install the application on console instructions are given here. This will create configuration file for server.
  • then run server.product.

I hope this tutorial will help you to install iDempiere development environment.

How to install iDempiere on Mac

How to install iDempiere on MacOS

Install JDK

Install PostgreSQL

Installing iDempiere now

  • Download iDempiere setup from http://www.idempiere.org/downloads ( based on the version you require )
  • Download iDempiere setup from http://www.idempiere.org/downloads ( based on the version you require )
  • Extract the setup zip
  • open terminal
  • Go to the setup folder on the terminal (cd $IDEMPIERE_HOME)
  • Give read write execute permission ( chmod 755 *). There is very nice article to understand the permissions http://www.macinstruct.com/node/415
  • then run ./console-setup.sh , then enter the information as prompt.
  • iDempiere Home: This is the iDempiere installation folder
    • Download iDempiere setup from http://www.idempiere.org/downloads ( based on the version you require )
    • Download iDempiere setup from http://www.idempiere.org/downloads ( based on the version you require )
    • Extract the setup zip
    • open terminal
    • Go to the setup folder on the terminal (cd $IDEMPIERE_HOME)
    • Give read write execute permission ( chmod 755 *). There is very nice article to understand the permissions http://www.macinstruct.com/node/415
    • then run ./console-setup.sh , then enter the information as prompt.
    • iDempiere Home: This is the iDempiere installation folder
  • After build is successful.

Import the default iDempiere database

This is the default way to import the database postgresql 9.1 or higher: After setting up the server (is a prerequisite) you can run:

  • cd $IDEMPIERE_HOME
  • cd utils
  • sh RUN_ImportIdempiere.sh

Start iDempiere server

  • cd $IDEMPIERE_HOME
  • Run iDempiere server run following command
  • ./idempiere-server.sh
  • to access idempiere if you entered localhost as the application server and port as default 80 then
  • http:// (hostname you chose as a application server)/webui
  • Default username/password for super user is SuperUser/System

 

Known issues while installing/FAQ

 

  • Instead of console setup if you GUI setup which is by running sh setup.sh, it does not allow you to edit the data. Its read only. That is why i prefer console setup.
  • Java version issue , if you are using 64 bit machine and installed 32 bit java and try to run the setup it will give you issue of jni shared library . That surely means you have wrong java version installed.
  • To install on linux you can use following excellent script and info from Mr. Chuck.