Installation Guide

Database server

PostgreSQL Installation

Ubuntu 22.04

Installation of the default version of PostgreSQL, which is version 14 on Ubuntu Server 22.04.

$ sudo apt install postgresql
$ sudo su postgres && cd
$ createuser --no-superuser --username postgres --pwprompt axelor
$ psql template1 -q -c 'CREATE EXTENSION unaccent;'
$ createdb --owner=axelor axelor
$ exit

A database named ‘Axelor’ and a user named ‘Axelor’ will be created. Verify that the cluster is UP with the command “pg_lsclusters”

Java Installation

Ubuntu 22.04

Installation of the default version of Java, which is version 11, on Ubuntu Server 22.04.

$ sudo apt install default-jdk

Verify that Java is installed correctly with the command “java -version”

$ openjdk version "11.0.16" 2022-07-19
$ OpenJDK Runtime Environment (build 11.0.16+8-post-Ubuntu-0ubuntu122.04)
$ OpenJDK 64-Bit Server VM (build 11.0.16+8-post-Ubuntu-0ubuntu122.04, mixed mode, sharing)

Installation of the client environment

Ubuntu 22.04

$ mkdir src && mkdir opt

Installation of Apache Tomcat (version 9)

Ubuntu 22.04

⚠ The second instruction line allows you to retrieve version 9.0.72. If you want a more recent version, visit the Tomcat version 9 site to get the correct URL.

$ cd ~/opt
$ wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.72/bin/apache-tomcat-9.0.72.tar.gz --no-check-certificate
$ tar -xzf apache-tomcat-9.0.72.tar.gz 
$ ln -s /home/axelor/opt/apache-tomcat-9.0.72 /home/axelor/opt/default-tomcat 
$ rm apache-tomcat-9.0.72.tar.gz 
$ rm -rf default-tomcat/webapps/*
$ sed -z -r -i 's/(<Valve className="org.apache.catalina.valves.AccessLogValve".*\/>)/<!--\1-->/' /home/axelor/opt/default-tomcat/conf/server.xml
$ sed -i 's/<Connector port="8080" protocol="HTTP\/1.1"/<Connector port="8080" protocol="HTTP\/1.1" \n\t\taddress="127.0.0.1" \n\t\tproxyPort="443" secure="true" scheme="https"/' /home/axelor/opt/default-tomcat/conf/server.xml
$ sudo nano /etc/systemd/system/axelor-tomcat.service
$ sudo nano /etc/logrotate.d/axelor-tomcat 
$ sudo systemctl daemon-reload
$ sudo systemctl enable axelor-tomcat
$ cd

Installation of Nginx (optional)

Ubuntu 22.04

$ sudo apt install nginx
$ sudo vi /etc/nginx/sites-available/exemple.axelor.com 
$ sudo ln -s /etc/nginx/sites-available/exemple.axelor.com /etc/nginx/sites-enabled/ exemple.axelor.com
$ sudo service nginx restart 

Install Axelor Open Suite

You can find the mentioned WAR files on our GitHub at this link.

Ubuntu 22.04

$ cd ~/src/
$ unzip %path_to_war_file% -d axelor-version_app 
$ # Update axelor-version_app/WEB-INF/classes/axelor-config.properties
$ cp -r /home/axelor/src/axelor-version_app /home/axelor/opt/default-tomcat/webapps/ROOT
$ sudo systemctl start axelor-tomcat