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 14.
3. The internet connection must be enabled, due the install files are downloaded from an external repository.

You can download the OpenJDK version 14 from the offical site: OpenJDK and install it in /opt directory as user root.

For Graal support please ask the provider for the file graalvm-java14-20.3.0.tar. Once you have the file, the following steps must be executed, as root user.

su -

in /opt directory and rename it to graalvm-java14-20.3.0:

cd /opt
tar xvf graalvm-java14-20.3.0.tar
mv graalvm-java14-20.3.0-dev  graalvm-java14-20.3.0

It can be necessary to install fontconfig in order to avoid a NullPointerException error in:

sun.awt.FontConfiguration / sun.font.FontManagerFactory#getInstance.

...
Caused by: java.lang.NullPointerException
	at java.desktop/sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1262)
	at java.desktop/sun.awt.FontConfiguration.readFontConfigFile(FontConfiguration.java:225)
	at java.desktop/sun.awt.FontConfiguration.init(FontConfiguration.java:107)
	at java.desktop/sun.awt.X11FontManager.createFontConfiguration(X11FontManager.java:719)
	at java.desktop/sun.font.SunFontManager$2.run(SunFontManager.java:372)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:312)
	at java.desktop/sun.font.SunFontManager.<init>(SunFontManager.java:317)
	at java.desktop/sun.awt.FcFontManager.<init>(FcFontManager.java:35)
	at java.desktop/sun.awt.X11FontManager.<init>(X11FontManager.java:56)
	...

In Ubuntu based OS you can execute

sudo apt install fontconfig

or

sudo yum install fontconfig

in RedHat based OS (in Centos, for example).

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 axional is created, login with this user and create the studio subdirectory:

$ su - axional
$ mkdir studio
$ cd studio

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 "https://bitbucket.org/deister/axional-install/get/master.tar.gz" | tar -x -z --strip-components=1 --exclude ".git*"

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

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

$ ./install.sh 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 (https://services.gradle.org/distributions/gradle-4.10.2-bin.zip)

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.

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

================================================================
CONFIGURATION
================================================================

Nexus Base URL [http://nexus3.deistercloud.com/]:
Nexus User []: UserProvided
Nexus User Password []: PassProvided
                

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]

Respond no [n] and ask to provider.

The installer will prompt to ask if you want install a development version. There are many versions available to download:

• 2017.1: version 2017 release 1.
• 2018.3: version 2018 release 3
• 2020.2: version 2020 release 2
• Development: Development versions are released more frequently and include the latest changes in code.

The following steps is for installing a development version. If you want an specific version please go to this link.

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:

CONFIGURATION PARAMETERS
--------------------------------------
NEXUS_BASE_URL: 
NEXUSUSER.....: deister-software-dist
NEXUSPASS.....: **********
NEXUSPRODUCT..: studio
PRODUCTNAME...: axional.studio.core
PRODUCTVERS...: 0.0.+

Are You Sure? [y/n]

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

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):

...
127.0.0.1    my_host
...

If firewalld is used you're required to open ports used for Axional services. Review the zone where the inteface is stablished.

For example to change the interface to "internal" zone you can execute the command:

firewall-cmd --change-interface=enp0s4 --zone=internal

For Axional Studio the default port is 8080:

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

firewall-cmd --permanent --service=ax-studio --set-description="Deister Axional Studio"
firewall-cmd --permanent --service=ax-studio --set-short="ax-studio"
firewall-cmd --permanent --service=ax-studio --add-port=8080/tcp

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-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=internal --add-service=ax-studio
firewall-cmd --permanent --zone=internal --add-service=ax-microservices

Finally, verify open ports and services:

firewall-cmd --reload
firewall-cmd --complete-reload

firewall-cmd --list-all-zones

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