This guide describes how to install Axional Frontend

1 Requeriments

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

Copy
$ java -version

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

Copy
$ 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.

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

Copy
# 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

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

1.2 Create the user axional

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

As root user create the user axional:

Copy
$ su - root
$ useradd axional
$ passwd axional

After the user axional is created, do login with this user and create the frontend subdirectory:

Copy
$ su - axional
$ mkdir frontend
$ cd frontend

1.3 Axional installer

Working as axional user, on the directory /home/axional/frontend download the installation tool using the curl command:

For the product Axional Frontend we should use the installer corresponding to versions before 2019, so we will download the "until-2018" tag instead of the "default" tag of the repository
Copy
$ su - axional
Copy
$ curl -k -s -o "axional-install-until-2018.tar.gz" "https://bitbucket.org/deister/axional-install/get/until-2018.tar.gz"

or, using the command wget:

Copy
$ wget -q -O "axional-install.tar.gz" "https://bitbucket.org/deister/axional-install/get/until-2018.tar.gz"

Extract the files using the "tar" command:

Copy
$ tar -x -z --strip-components=1 --exclude ".hg*" --exclude ".project" -f "axional-install-until-2018.tar.gz"

1.4 Install the application

Firstly, use axional installer to setup the remote software repository and the credentials.

Yo need to ask for a nexus username and password to access deister nexus software repository

Use the shell to install the product

Copy
$ ./install_jdk18.sh install
* Looking for curl...
* Looking for unzip...
* Check Java ...
  = Found java executable in PATH
  = Java version 1.8.0_91
* Looking for gradle
* Trying to download gradle 3

First time you execute the installer, it will ask for some parameters to configure the installation framework. You also need to request a nexus user and password to the deister support team, to enter the software repositories.

1.4.1 Connection details

The installer will prompt for connection parameters to the Nexus repository such as the url, user and password

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

Nexus Base URL [http://nexus.deistercloud.com/]:
Nexus User [deister-software-dist]: UserProvided
Nexus User Password []: PassProvided
                

1.4.2 Choose product

Next the the installer will prompt for product. We will enter frontend-xxxx.

Where the xxxx is the name of your company

1.4.3 Choose the version

We can choose to install a development version or a release version. Development versions are released more frquently and include the latest changes in code. On the other hand, release version are published less often and are throughly tested.

Installing a release version

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

Do you want to download from the SNAPSHOT repository? n

Then the installer will show the available versions:

 Available versions
--------------------------------------------
      1.2
      1.1
      1.0
Which version do you want to use? 1.2

Before continuing the installer will review the parameters:

CONFIGURATION PARAMETERS
--------------------------------------
NEXUS_BASE_URL: http://nexus.deistercloud.com/
NEXUSUSER.....: deister-software-dist
NEXUSPASS.....: **********
NEXUSPRODUCT..: frontend-xxxx
PRODUCTNAME...: axional.studio.frontend.xxxx
PRODUCTVERS...: 1.2

Are You Sure? [y/n] y

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

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

Copy
...
10.0.0.1    my_host
...

3 Notes for Windows users

  1. Get and install Cygwin to be able to use the installer: link. Take in account that some utilities like "unzip", "curl", "diff" may be usefull
  2. Get and install Java JDK 1.8: link
  3. Inside the Cygwin environment, create a link to Java folder (outside the "studio" folder):
    Copy
    mkdir studio
    cd studio
    ln -s /cygdrive/c/Program\ Files/Java/jdk1.8.0_121  ../winjava
  4. Run installer and server following the instructions on prevoius sections