Best practices for installing the Axxon One Server on Ubuntu

This is a manual for installing the Axxon One 2.0 Server on Ubuntu OS 18 version and later. The manual describes the silent installation from the repository.

Before the installation

All actions are performed in the terminal as the root user. If you use third-party programs, for example, Discover, you may need to reinstall Axxon One.

Installing the Axxon One Server

To install the Axxon One Server, do the following:

1. Add the AxxonSoft repositories by sequentially running the commands:
   

   echo 'deb http://download.axxonsoft.com/debian-repository stretch backports/main' | sudo tee -a /etc/apt/sources.list.d/axxonsoft.list
   echo 'deb http://download.axxonsoft.com/debian-repository weekly main backports/main' | sudo tee -a /etc/apt/sources.list.d/axxonsoft.list
   wget --quiet -O - "http://download.axxonsoft.com/debian-repository/info@axxonsoft.com.gpg.key" | sudo apt-key --keyring /etc/apt/trusted.gpg.d/axxonsoft.gpg add - && sudo apt-get update

2. Install the required version of Axxon One.
   

   Attention!

   The installation command depends on your variant of the software package: either the Server or the Failover Server. These are two different types of the software package. You should install only one of them. Both variants are described below (for more information about the installation types, see 설치, 페일오버 시스템에 대한 일반 정보).

   1. If you need to install only the Server part of Axxon One, sequentially run the commands:
      

      sudo apt install axxon-one
      sudo apt-get install -f -y

      During the installation, the installer will request the name of the Axxon-domain for the Axxon One Server. If you leave this field blank, you can specify the name on the Client at the first connection.
      

      

   2. If you need to install the Failover Server, sequentially run the commands:
      

      sudo apt install axxon-one-raft
      sudo apt-get install -f -y

After the installation

Basic commands for checking the installation

Check the versions of the installed Axxon One modules:

sudo dpkg -l | grep axxon

Check the server status:

sudo systemctl status axxon-one
sudo systemctl status axxon-one-raft # for Failover Server

Start and stop of the Axxon One Server (if it was installed):

sudo systemctl stop axxon-one
sudo systemctl start axxon-one

Start and stop of the Axxon One Failover Server (if it was installed):

sudo systemctl start axxon-one-raft
sudo systemctl stop axxon-one-raft

Next steps

For Axxon One Server: 도메인 설정

For Axxon One Failover Server: 클러스터 생성 and 페일오버 시스템 클러스터 구성

Possible errors during installation

Packages from the unsigned repositories aren’t loaded

Add [trusted=yes] to the repository path. Example:

deb [trusted=yes] http://download.axxonsoft.com/debian-repository stretch main backports/main

The repository key isn’t added

Load the key. Run the command:

sudo apt-key add key_file_name

Additional commands for the Server

Use the required command depending on the version of the installed software package: only the Server (axxon-one) or the Failover Server (axxon-one-raft).

# display of the package dependencies
apt-cache depends
# display of the repositories with the package
apt-cache policy
# build reconfiguration 
sudo dpkg-reconfigure axxon-one 
sudo dpkg-reconfigure axxon-one-raft

Default folders

The following folders are used by default:

1. Logs and Client configuration: /home/USER/.local/share/AxxonSoft/
2. Server configuration: /opt/AxxonSoft/AxxonOne/

The path to the Support log collection utility: /opt/AxxonSoft/AxxonOne/bin/support