Installing ADempiere Manually
⇐ Table of Contents{{#if: Getting Started| | Getting Started }}{{#if: | | [[{{{3}}}]] }}{{#if: | | [[{{{4}}}]] }}{{#if: | | [[{{{5}}}]] }} | Installing ADempiere Manually{{#if: Launching the ADempiere Application| | Launching the ADempiere Application }} ⇒
Contents
General Installation Instructions
The installation process is similar across operating systems with a few minor exceptions.
This installation instruction is intended for initial installations where the database, application server and client all run on the same machine and a desktop or GUI interface is being used.
- For more complex installations or command-line installations, see Installation Steps.
- If you already have an ADempiere installation running and you want to update to a newer version, see Upgrading and Migration.
An installation can take as little as 15 or 20 minutes.
Downloads
Before you begin, download each of the following packages:
- Java SE Development Kit - Get the latest from http://www.oracle.com/. You only need the JDK without JavaFX, EE or NetBeans bundles.
- A database. Either
- Postgre SQL - Get the latest Windows install from http://www.postgresql.org/download/ OR
- Oracle - A free "express" version is available from Oracle at http://www.oracle.com/technetwork/database/database-technologies/express-edition/downloads/index.html
- ADempiere Latest Release - Download the latest ADempiere from Release.
- ADempiere Patches - From http://sourceforge.net/projects/adempiere/files/ADempiere Patches/ download the patches for the version of ADempiere downloaded above. The patches come in two files, a *_patches_*.jar and a *_migra_*.[zip|tar]. You will need both.
Install the Pre-Requisites
JAVA
Install the JAVA JDK with the default installation settings. Say OK to install the follow-on JRE as well. Carefully note the full path for the JDK directory (e.g: C:\Program Files\java\jdk1.5.0_19) and the JRE directory that you have just installed.
Note: There may well be a number of JDK and JRE directories, so choose the right one! The JDK should include the JRE.
The ADempiere scripts rely on the existence of a system environment variable JAVA_HOME. When the scripts call java, they use the full path as $JAVA_HOME/bin/java so it is important that this variable exist.
Following the instructions for your system, add a new System Variable JAVA_HOME for your new JDK directory:
- JAVA_HOME use C:\Program Files\Java\jdk1.7.0_25 (or whatever your JDK directory is called)
- Append the following JDK path to the system path: %JAVA_HOME%\bin or $JAVA_HOME/bin
Database
Install database software according to the installation instructions for your system using the defaults to keep things simple. Keep track of passwords and ports since you will need this information in the ADempiere setup.
The ADempiere scripts will need to find the database command line utilities, so set your path to point to the "bin" directory of the database install. You can do this in the same way JAVA_HOME was used above. Create an environment variable such as DATABASE_HOME set to the database install directory, and add DATABASE_HOME/bin to your path according to the methods for your system.
Install the ADempiere Software
There is no install script. Just extract the ADempiere archive to a suitable location: (e.g. c:\ or /u01/). For reference, call this directory $ADEMPIERE_ROOT. You should end up with the files in a folder like $ADEMPIERE_ROOT\Adempiere. For reference, call this folder $ADEMPIERE_HOME.
Note: Avoid spaces in the directory path. The batch scripts do not like directory names with spaces. If using a $ADEMPIERE_ROOT with multiple directories, avoid directory names with spaces.
Apply the Patches
Patches are a combination of *.jar files, which replace *.jar files in the $ADEMPIERE_HOME\lib directory, and migration scripts which update the database. In the Patches directory on Source Forge, there may be more than one type of *.jar that needs patching. If you downloaded one or more patch files, replace the existing file with the downloaded one, changing its name to match. For example, copy the *_patches_*.jar file to $ADEMPIERE_HOME\lib\patches.jar, overwriting the existing file. See the detailed instructions in Patches Installation.
Note: It is a good idea to rename the existing *.jar file to something like patches.jar.old before you replace it with the the new file
Apply Customizations, Packages and other Files
If you have a customization.jar with customized code or a packages.jar file with supporting *.jar files, add them to the $ADEMPIERE_HOME\lib directory, overwriting the existing files.
Initial ADempiere Setup
A setup utility in ADempiere will prepare the software for use and create environment variables needed in the following steps.
Note: The setup utility will need to make changes to environment variables. Execute the utility with sufficient permissions to do so.
Navigate to $ADEMPIERE_HOME and execute RUN_setup.[sh|bat].
Note: In linux systems you may need to change the executable rights of the *.sh files in the $ADEMPIERE_HOME directory.
If this is the first time you are installing ADempiere, a licence and security keys dialogs will appear. Accept the defaults.
The setup dialog will appear.
You will need to change:
- Database Server from <your-computer-name> to localhost
- Database Type according to your installed database: oracle, oracleXE or postgresql
- Database Name from xe to adempiere (You can use another name here if you like)
- DB Admin Password to postgres (or whatever you entered above for the database administrator)
- Database Password to adempiere
- Don't change anything in the Mail Server settings. These can be set up later.
You may also need to change the following:
- Adempiere Home to $ADEMPIERE_HOME (e.g. C:\Adempiere) if somehow it has been set to the wrong location
- Application Server Web Port to 8080 and SSL to 8443 (instead of 443). Access to port 80 and 443 is often restricted to system administrators. If ports are already in use, you can choose other open ports. Check for your system how to find open/available ports.
Press the Test button
When the Test completes without errors and the Save button (bottom, right) is activated, click the Save button. Wait a few minutes until the Adempiere Server Setup screen disappears and the deployment is finished.
Note: The database does not have a user adempiere or a database adempiere at this point, so these tests will not be checked. The user and database will be created in the next step.
If you are having problems, see the detailed instructions on this dialog in the pages InstallServer and ServerSetupHelp
Import ADempiere Data
Caution! The following script will DROP any existing adempiere database. Do not run this command if you already have data loaded.
In a shell, navigate to $ADEMPIERE_HOME\utils and execute 'RUN_ImportAdempiere.[sh|bat]'.
See CreateDatabase for more information.
Apply Migration Scripts
The database installed above will be at the state of the release version and will have all migration scripts applied. You may need to apply migration scripts which were downloaded with the patches.
If you are not installing patches, skip this step.
SQL - Prior to Release 3.8.0
The migration scripts can be found in the *_migra_*.[zip|tar] file downloaded above. Unzip the contents to a convenient directory. The scripts can be applied in a number of ways, using database tools or the command line. Refer to the documentation for your database.
XML - Since Release 3.8.0
The XML migration scripts to apply should be saved in the $ADEMPIERE_HOME\migrations directory. These scripts will be included in *_migra_*.zip file. Unzip the contents to $ADEMPIERE_HOME\migrations. To apply the scripts, execute the command $ADEMPIERE_HOME\utils\RUN_MigrateXML.[sh|bat] from a shell.
Run ADempiere
Start the Application Server
In a shell, navigate to $ADEMPIERE_HOME\utils. Execute 'RUN_Server2.[sh|bat]' and wait for the server to fully start - it will end this phase with "INFO [Server] JBoss .... Started in xx:xx:xx ms", which will take around 30 seconds to 3 minutes depending on your computer.
Starting the Application Server Automatically
In Windows, if you would like to run the server as a service, in a shell, navigate to $ADEMPIERE_HOME\utils\windows and run Adempiere_Service_Install.bat. You will need to open the Services Window (Control Panel{{#if: Administrative Tools | →Administrative Tools }}{{#if: Services | →Services }}{{#if: | → }}) to set the properties so the service starts automatically or manually. Note that this won't work Windows Server 2013 until the ADempiere software is upgraded.
In linux, you can use nohup or an equivalent tool.
Launching the ADempiere Application
'Congratulations!'
At this point, your installation is complete and you can move on to Launching the ADempiere Application.
Uninstall or Revert to Previous Version
To uninstall the software, simple delete the $ADEMPIERE_HOME directory. To delete the database, use the database administrator to drop the adempiere database and user.
To revert to the previous version, delete the $ADEMPIERE_HOME directory and copy the previous version to $ADEMPIERE_HOME. Restore the backed-up copy of the database using $ADEMPIER_HOME\utils\RUN_DBRestore.[sh|bat].
System Specific Installations
The following links provide detailed instructions for manual installations on various operating systems.
Windows
- Adempiere Install for Windows & PostgreSQL Updated for version 3.8.0. (Original page contributed by Bepivin)
- How To Install on Oracle 10gXE / WinXP or Win2003 Server (From Information Technology Accountants WebSite) (Arabic)
- How To Install on Oracle 10gXE / WinXP (From Tyarli's Home Page)
Linux-General
- ADempiere via .deb/RPM/apt-get/yum
- Using IzPack Installer ( Outdated ) PostgreSQL & Linux
- Install ADempiere 3.5.3a on Linux (Chinese):ADempiere安装指南-3.5.3a (Linux)
Linux-Debian/Ubuntu
- Installing ADempiere 3.7.0 on Ubuntu 11.04
- Debian and PostgreSQL Install
- Install on Ubuntu 10.04 LTS
- Install on Ubuntu 8.04 by Gabriel
- Install on Ubuntu 8.10 by Tamás Magyar
- ADempiere with Postgresql on Ubuntu 9.04 Jaunty
- ADempiere Dedicated Server or utilizing Ubuntu Linux Server Edition just for ADempiere
- Install on Debian (Chinese): 在Debian及Postgres上安装Adempiere
- Install on Ubuntu 7.10 (Chinese): 在Ubuntu 7.10上安装Adempiere
Linux-RedHat/Fedora
- Install ADempiere 3.6.0 on Fedora 13 with PostgreSQL (Snantachai)
- Install on Fedora 10 with PostgreSQL (Wariola)
- Install Adempiere 3.5.4 on Centos 5.4 / PostgreSQL 8.4.2 by Michael Judd
- Adempiere 3.3.0 and PostgreSQL 8.1.9 Installation on CentOS 4.5 (Thai) by Sureeraya L.
- How to install Adempiere on CentOS 5.1 (Xen) with Postgres by Michael Judd
Linux-Other
- Install on Mandriva 2009 (Spanish) by Ana María Orozco and Javier Andrés Cárdenas
- SLES10 (64 bit) and PostgreSQL (by Terence Ng)
- How to Install ADempiere on P-Series with IBM JAVA & SLES 64bit by Leroy P.
Open Source OS
- How to Install and Run ADempiere on OpenSolaris and Glassfish by Bahman M. and Praneet Tiwari
- How To Run ADempiere on FreeBSD by Bahman M.
IBM
- Installation Guide for ADempiere using WebSphere Application Server by Grant Q
- Installation Guide for ADempiere on IBM i by Grant Q
Other
Installation From Trunk (SVN)
- Manual Installation From Trunk
- AdempiereERP and its pre-requisites complete installation from Trunk (SVN) (in ppt format) VOSS Com AdempiereERP installation guide is a complete, comprehensive and sequential installation guide of AdempiereERP and its pre-requisites for Windows platform. The unique and prominent feature of this installation guide is that it has information to install all components or prerequisites of AdempiereERP in a single file. Contributed by VOSSCom (Virtual University (of Pakistan) Open Source Software Community)
OS and DB Setup
Step By Step Series
contributed by Alejandro Falcone
- InstallServer for setup at server after Database is done
- Launching the ADempiere Application for client side where remote PC users can login
- InitialClientSetup starting the Business Client Setup
Application Server Setup
- Alternate setup using Glassfish by Praneet Tiwari.
- ADempiere on OpenSolaris and Glassfish by Praneet Tiwari.