Install on Windows

In this guide we will see how to install Axelor Business Suite on your system by installing all the prerequisites and building Axelor Business Suite from the source code.

Prerequisites

Install Git

We will use Git to obtain latest source code of Axelor Business Suite from the public source repository.

Download the Git for Windows installer and install it as usual. You can refer the git documentation for more details.

Install OpenJDK 8

There are many ways you can install OpenJDK 8 on your system. We will see the most preferred ways:

Download the latest OpenJDK 8 and install it as per the installation instructions.

Install Tomcat 8.5

Download the latest Tomcat 8.5 binary installer and install it as usual.

Install PostgreSQL

We will install PostgreSQL as the database system for the Axelor Business Suite.

Download the latest binary installer package and install as usual.

Build from source

Get the latest source code of the Axelor Business Suite using Git as follows:

$ mkdir -p ~/axelor-source
$ cd ~/axelor-source

$ git clone https://github.com/axelor/abs-webapp.git axelor-erp
$ sed -e 's|git@github.com:|https://github.com/|' -i axelor-erp/.gitmodules

$ cd axelor-erp
$ git checkout master
$ git submodule sync
$ git submodule init
$ git submodule update
$ git submodule foreach git checkout master
$ git submodule foreach git pull origin master
Use Git Bash console installed with Git for Windows instead of cmd.

Now build the war package from the source:

$ ./gradlew -x test build

After build completion, you will find the war package under build/libs directory.

Deploy the App

Now as the war package is built, it’s time to run the app by deploying it on Tomcat.

From the graphical tool pgAdmin4 installed with PostgreSQL, create a new database named axelor.

Now prepare an application config file (using Git Bash).

$ cp ~/axelor-source/axelor-erp/src/main/resources/application.properties ~/axelor-source/application.properties (1)
$ sed 's|{java.io.tmpdir}/axelor|{user.home}/.axelor/axelor-erp/5.0|g' -i ~/axelor-source/application.properties (2)
1 copy the source configuration
2 fix file storage path

Now change the ~/axelor-source/application.properties according to your needs. However, you have to provide database settings like this:

db.default.driver = org.postgresql.Driver
db.default.ddl = update
db.default.url = jdbc:postgresql://localhost:5432/axelor (1)
db.default.user = postgres (2)
db.default.password = axelor (3)
1 the database connection url
2 the database user name
3 the database user password

Now configure the tomcat as follows:

First stop the tomcat server.

Now, from the start menu, locate menu:[Apache Tomcat 8.5 Tomcat 8 > Configure Tomcat] and click on it. It will open tomcat configuration window as shown bellow:

tomcat config

Add following line in Java Options text area:

-Daxelor.config=C:\Users\<user>\axelor-source\application.properties

Where <user> should be the user name. In short, full path to application.properties file which we prepared previously.

Now copy the war package from build/libs to C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps as ROOT.war and start the tomcat server again.

After a while, once database is initialized, you can access the application at: http://localhost:8080