Manual for installing the Axxon One Server on Ubuntu

This is a manual for installing the Axxon One 1.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:

Attention!

You cannot install Axxon One 1.0.4 from the repository. To install from the repository, you must update Axxon One to version 2.0 (see Updating Axxon One on Linux OS, Documentation Axxon One 2.0).

Add the AxxonSoft repositories by sequentially running the commands:

echo 'deb http://download.axxonsoft.com/debian-repository stable main' | sudo tee -a /etc/apt/sources.list.d/axxonsoft.list
echo 'deb http://download.axxonsoft.com/debian-repository stretch 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

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 one of them. Both variants are described below (for more information about the installation types, see Installation, General information about a failover system).
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: Configuring domains

For Axxon One Failover Server: Creating a Cluster and Configure a Failover System Cluster

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:

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

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

Manual installation of the Axxon One Server is described here: Manual installation.

The section about Axxon One on Linux: Appendix 8. Configuring and operating Axxon One in Linux OS.

Page tree

Documentation for Axxon One 1.0.