View source for Running iDempiere from Installers

<!-- breadcrumb -->
<font size=-2>
&lArr;
[[Installing_iDempiere|Table of Contents]] |
[[Installing from Installers]] |
Running iDempiere from Installers |
[[Post Installation]]
&rArr;
</font>

== 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

 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
 systemctl enable idempiere     # to enable iDempiere from start on reboot

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:
 systemctl status idempiere     # to check the status of the app
 systemctl restart idempiere    # to restart the iDempiere app
 systemctl stop idempiere       # to stop the iDempiere app
 systemctl start idempiere      # 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: [https://groups.google.com/forum/#!topic/idempiere/4XptGMDRZts]

''This tutorial is brought to you by [[User:CarlosRuiz|Carlos Ruiz]] from [https://www.bx-service.com/ BX Service GmbH].  Feel free to improve directly or suggest using the Discussion tab.

[[Category:User Manual|I]]
[[Category:Installation|S]] 
[[Category:Installation Server]] 
[[Category:Server]]

<!-- breadcrumb -->
<font size=-2>
&lArr;
[[Installing_iDempiere|Table of Contents]] |
[[Installing from Installers]] |
Running iDempiere from Installers |
[[Post Installation]]
&rArr;
</font>