Installing from Installers

From iDempiere en
Jump to: navigation, search

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

Create user

It is recommended to run the iDempiere server as a user created for such purpose, usually idempiere, instead of running as root.

So, let's create first a user:

adduser idempiere

Install Server

  • Unzip the server installer you downloaded or created, for example:
unzip idempiereServer.gtk.linux.x86_64.zip
  • Move the folder to /opt
mv idempiere.gtk.linux.x86_64/idempiere-server /opt
rmdir idempiere.gtk.linux.x86_64
chown -R idempiere:idempiere /opt/idempiere-server

Graphical

From now on is preferable that you run everything as idempiere user:

su - idempiere  # not necessary if you're already as user idempiere
cd /opt/idempiere-server

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

Screenshot-Adempiere Server Setup.png

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

su - idempiere  # not necessary if you're already as user idempiere
cd /opt/idempiere-server
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

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

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

su - idempiere  # not necessary if you're already as user idempiere
cd /opt/idempiere-server
cd utils
sh RUN_ImportIdempiere.sh

Note: In order for the above import script to work, you need to make sure that you have the jar and psql or Oracle executables on your path.

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