Running iDempiere from Installers

From iDempiere en
Jump to: navigation, search

Table of Contents | Installing from Installers | Running iDempiere from Installers | Post Installation

Manual running

Once installed and configured the iDempiere server you can start it with:

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

or

sh idempiere-server.sh

or

nohup sh idempiere-server.sh >> idempiere-server.log 2>&1 &

Installing as service

iDempiere can be registered as a service in linux, in order to do that you can copy the provided scripts to /etc/init.d folder like this:

sudo su -    # this must be executed as root
cp /opt/idempiere-server/utils/unix/idempiere_Debian.sh /etc/init.d/idempiere
systemctl daemon-reload
update-rc.d idempiere defaults

After iDempiere is registered as a service, it will be started automatically on server reboots, also it can be started / stopped / restarted / checked as usual with:

service idempiere status    # to check the status of the app
service idempiere restart   # to restart the iDempiere app
service idempiere stop      # to stop the iDempiere app
service idempiere start     # to start the iDempiere app when stopped

Note the above instructions are specific for Ubuntu or Debian, in folder /opt/idempiere-server/utils/unix there are also scripts for RedHat and Suse, but installation on those system can be a bit different.

Troubleshooting

Error when running idempiere-server.sh on mac os

If you try to run the script and encounter the following error: readlink: illegal option -- f

usage: readlink [-n] [file ...]

usage: dirname path

Unable to access jarfile /plugins/org.eclipse.equinox.launcher_1.*.jar

You have to get coreutils package which contains the GNU command line tools. If you have package manager such as brew, you can get the coreutils via it.

After that, add the bin to the path of your terminal (bash or zsh or etc).

Ex. export PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"

Source from: [1]

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