Install on macOS

In this guide we will see how to install the official pre-built war package on macOS.

Prerequisites

Install OpenJDK 8

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

Install Tomcat 8.5

Here we will see how to install the latest Tomcat 8.5 from the binary distribution package.

Download the latest version of Tomcat 8.5 from the Tomcat Downloads page. Under the Binary Distributions/Core section, use the .tar.gz package.

It’s better to install it under /usr/local or /Library directory.

Follow these commands:

$ cd /Library
$ sudo mkdir /Library/Tomcat
$ sudo tar -xzf ~/Downloads/apache-tomcat-*.tar.gz -C /Library/Tomcat --strip-components=1
$ sudo chown -R <user_name> /Library/Tomcat (1)
$ sudo chmod +x /Library/Tomcat/bin/*.sh (2)
1 change the ownership to the non-privileged user
2 make the shell scripts executable

Install PostgreSQL

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

Download the latest installer package and install as usual.

Deploy the WAR

Now as you have all the prerequisites installed, download the pre-built war package of Axelor Open Suite.

Now extract the downloaded package and locate the WEB-INF/classes/application.properties file to change some of the application settings.

Most importantly, you will require to set 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 = axelor (2)
db.default.password = axelor (3)
1 the database connection url
2 the database user name, as we created previously
3 the database user password, as we set previously

You may also like to change some other properties like file.upload.dir to change the location where you want to save uploaded files.

Now copy the extracted package directory to /Library/Tomcat/webapps from terminal app like this:

$ cp -r axelor-erp-5.0.1 /Library/Tomcat/webapps

Or use "Finder" to copy the package in /Library/Tomcat/webapps directory.

Now start the tomcat server from the terminal app:

$ /Library/Tomcat/bin/catalina.sh run

If everything is fine, you can see application log on terminal and after a while, you may see something like this:

Ready to serve...

The application is now ready and can be accessible at: http://localhost:8080/axelor-erp-5.0.1