This guide describes how to install Axional Studio

1 Installation Prerequisites and Requirements

To setup a server a minimum software should be installed in the guest Linux computer

  1. A Linux operating system, with at least 2 GB of RAM.
  2. The last release of Java 11.
  3. The internet connection must be enabled, due the install files are downloaded from an external repository.

1.1 Java

A Java 11 virtual machine is required to run the application.

Run the following command in a terminal to check the current Java version:

$ java -version

If Java is already installed, then you can see a result message like:

$ java -version
openjdk version "11.0.1" 2018-10-16
OpenJDK Runtime Environment 18.9 (build 11.0.1+13)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.1+13, mixed mode)

If not satisfied then it can be downloaded here.

Axional Studio check differents JAVA locations, one of them is /opt/jdk1-11* so you can do a symbolic link from this path where the JDK was installed.

ln -s TARGET /opt/jdk1-11.0.1

Check this article for help on Java 9 setup.

After the Java Installation you should define the JAVA_HOME environment variable pointing to your Java Install Directory. Alternatively you can define a full server access to installed Java by setting up the linux alternates:

# update-alternatives --install "/usr/bin/java" "java" "/opt/jdk-11.0.1/bin/java" 1
# update-alternatives --install "/usr/bin/javac" "javac" "/opt/jdk-11.0.1/bin/javac" 1
# update-alternatives --install "/usr/bin/javaws" "javaws" "/opt/jdk-11.0.1/bin/javaws" 1

# update-alternatives --set java   /opt/jdk-11.0.1/bin/java
# update-alternatives --set javac  /opt/jdk-11.0.1/bin/javac
# update-alternatives --set javaws /opt/jdk-11.0.1/bin/javaws

If you want to change alternates manually, you can use config parameter to select your prefered JVM version

# update-alternatives --config java
# update-alternatives --config javac
# update-alternatives --config javaws

1.2 Create the user axs

We recommend to install it, in the /home/axional/studio directory.

As root user create the user axional:

$ su - root
$ useradd axional
$ passwd axional

After the user axs is created, login with this user and create the studio subdirectory:

$ su - axional
$ mkdir studio
$ cd studio

1.3 Axional installer

Working as axional user, on directory /home/axional/studio download the installation tool using the common curl and tar commands:

$ su - axional
$ curl -k -s "" | tar -x -z --strip-components=1 --exclude ".git*"

2 Install the application

Use axional installer to setup the remote software repository and the credentials.

You need to ask to your Deister representative for a nexus username and password to access deister nexus software repository

Type this command to install the product while in the newly created /home/axional/studio folder:

$ ./ install
* Looking for curl...
* Looking for unzip...
* Check Java ...
  = Found java executable in PATH
  = Java version 9.0.4
* Looking for gradle
* Trying to download Gradle distribution (

First time you execute the installer, it will ask for some parameters to configure the installation framework. You'll be asked for a user and password for accesing deister nexus repository. Ask for it to deister support team.

2.1 Connection details

Installer will prompt for connection parameters to the Nexus repository such as the URL, user and password


Nexus Base URL []:
Nexus User []: UserProvided
Nexus User Password []: PassProvided

2.2 Choose product

Next the the installer will prompt for product. We will enter studio.

The script will prompt for weather we want to download DB exports (dictionaries) along with the studio product, or not.

Do you want to download DB exports for standard dictionaries? [y/n]

2.3 Choose the version

We will choose to install a development version. Development versions are released more frequently and include the latest changes in code.

Production Environment

For Production Environment install a release version. Check guide here

2.3.1 Installing a development version

To install a development version, answer y to the question:

Do you want to download from the SNAPSHOT repository? y

Before continuing the installer will review the parameters:

NEXUSUSER.....: deister-software-dist
NEXUSPASS.....: **********

Are You Sure? [y/n]

This questions are asked only first time and stored in file .install.rc. Following use of shell, will use parameters answered for accesing deister nexus repositories.

3 Network configuration

It is required that the localhost name resolves to an address in order for the server to know it's IP address. For example, in Linux systems, it can be necessary to create an entry in the "hosts" file (/etc/hosts):

...    my_host

4 Firewall configuration

If firewalld is used you're required to open ports used for Axional services. For axional microservices you need to create a service:

firewall-cmd --permanent --new-service=ax-microservices

firewall-cmd --permanent --service=ax-microservices --set-description="Deister Axional Microservices"
firewall-cmd --permanent --service=ax-microservices --set-short="ax-microservices"
firewall-cmd --permanent --service=ax-microservices --add-port=7001/tcp
firewall-cmd --permanent --service=ax-microservices --add-protocol=tcp
#firewall-cmd --permanent --service=ax-microservices --add-source-port=portid[-portid]/protocol
#firewall-cmd --permanent --service=ax-microservices --add-module=module
#firewall-cmd --permanent --service=ax-microservices --set-destination=ipv:address[/mask]

Next, open firewall ports by adding services:

firewall-cmd --permanent --zone=public --add-service=http
firewall-cmd --permanent --zone=public --add-service=https
firewall-cmd --permanent --zone=public --add-service=ax-microservices
firewall-cmd --reload

Finally, verify open ports and services:

firewall-cmd --zone=public --list-services
firewall-cmd --zone=public --list-ports