Installing from Installers

⇐ Table of Contents | Downloading Installers | Installing from Installers | Running iDempiere from Installers ⇒

Install Server

• Unzip the server installer you downloaded or created, for example:

cd $IDEMPIERE_HOME
unzip idempiereServer.gtk.linux.x86_64.zip

• Navigate to the idempiere-server folder, for example

cd $IDEMPIERE_HOME/idempiere.gtk.linux.x86_64/idempiere-server

Graphical

You can run:

sh setup.sh

or

sh setup-alt.sh

• You can fill the parameters as shown in the screenshot, or with your own preferred values, specially you must take care of the following:
  • iDempiere Home: This is the repository folder
  • Web Port / SSL: be careful to not use a port that is already used by another application, in linux ports below 1000 cannot be used by non-root users. For example port 8080 is used by Oracle-XE
  • DB Already Exists: in common installation you must leave this flag unchecked as the database will be created later
  • Database Name: here we fill with the name of the database you want to create
  • DB Admin Password: must be filled with the postgres password you set up in the prerequisites
  • Database User: this is a user to be created, it is recommended you keep it as the default adempiere
  • Database Password: fill here with the password you want to assign to the database

And finally push the Save button, if something fails the Save button will be disabled and the failing option is marked in red, in order to re-enable the Save button you must push the Test button until all errors are gone. The only valid error in red is in front of Database Password field when the database is still not created.

Differences for Oracle

On oracle some fields must be filled slightly different:

• • Database Name: here you must fill the name of the oracle instance (usually xe or orcl)
  • DB Admin Password: must be filled with the SYSTEM password you set when installing oracle
  • Database User: in oracle you can define your preferred user here
  • Database Password: fill here with the password you want to assign to the database

Console

sh console-setup.sh

or

sh console-setup-alt.sh

This is to be used when you don't have a graphical environment, in this case the parameters are shown in screen and you must fill them directly with the keyboard.

Import the Database

Default

This is the default way to import the database for oracle (10g or 11) and postgresql 9.1 or higher:

After setting up the server (is a prerequisite) you can run:

cd utils
sh RUN_ImportIdempiere.sh

PostgreSQL 8.4 or 9.0

If you're going to install the official installers in postgresql 8.4 or 9.0 you must run the following commands:

After setting up the server (is a prerequisite) you can run:

cd utils
sh RUN_ImportIdempiere.sh 8.4

Please note daily installers do not support these postgresql old versions

Install Swing Client

• Unzip the client installer you downloaded or created, for example:

cd $IDEMPIERE_HOME
unzip idempiereClient.gtk.linux.x86_64.zip

• Navigate to the adempiere-client folder, for example

cd $IDEMPIERE_HOME/adempiere.gtk.linux.x86_64/adempiere-client

• Run adempiere-client

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