Page History

General information about the Docker image and container

Installing the Docker server

To install and launch Axxon One using Docker, do the following:

1. Install Docker using the official manuals:
   • Debian: https://docs.docker.com/engine/install/debian/.
   • Ubuntu: https://docs.docker.com/engine/install/ubuntu/.
     

     Info
     title Note
     Minimum requirements to launch Axxon One using Docker on Ubuntu: dual-core CPU; 4 GB RAM; 200 GB HDD.

   • Other distribution packages: https://docs.docker.com/engine/install/.
2. Download the latest version of the Axxon One Docker image using the following command:
   

   Code Block
   language bash
   sudo docker pull axxonsoft/axxon-one:latest

   Note
   title Attention!
   The Axxon One failover build of the Docker image is available. If necessary, AxxonSoft technical support specialists can provide it.

3. Launch Docker using the following command:
   

   Code Block
   language bash
   sudo docker run axxonsoft/axxon-one:latest

   Info
   title Note
   If you need to install an earlier version of the Axxon One Docker image: Open the link to select the required Axxon One Docker image. Next to the required Docker image, click the button to copy the command. Example of the command: Code Block language bash sudo docker pull axxonsoft/axxon-one:2.0.10.42 Paste the copied command into the terminal and run it. Launch Docker using the following command: Code Block language bash sudo docker run <image version> For example: Code Block language bash sudo docker run axxonsoft/axxon-one:2.0.10.42

Starting Axxon One

After installation, you can connect to the Docker server with the separately installed Axxon One client. To do this, when starting the client, enter the IP address of the Docker server, login, and password in the authorization window (when you start Axxon One for the first time, enter the following login and password: root/root). You can connect to the Docker server using the Flatpak package as well (see Running the client as Flatpak).

List of useful commands:

• Determine the IP address to connect to:
  

  Code Block
  docker inspect <container id> | grep "IPAddress"

• View the list of containers and their status:
  • Only active containers:
    

    Code Block
    language shell
    docker ps

  • All containers (active and stopped):
    

    Code Block
    language shell
    docker ps -a

• Check the availability of the server:
  

  Code Block
  ping <ip address>

• View the running processes:
  

  Code Block
  docker top <container name>

• Start the container:
  

  Code Block
  language shell
  docker start <container_id>

• Check the status of the container:
  

  Code Block
  language shell
  docker ps

• Stop the container:
  

  Code Block
  language shell
  docker stop <container_id>

Installing and starting Axxon One using Docker is complete.

Additional information

Directory inside the container

Directory is mounted inside the container:

/var/lib/docker/volumes/<volume_id>

You can change the path upon request via AxxonSoft technical support specialists.
To receive the volume_id value, use the command:

docker inspect <container_id>

Collecting the support package in the Docker container

To collect the support package, do the following:

1. First, find out the ID of the Docker container using the command:
   

   Code Block
   language shell
   docker ps -a

2. Get access to the container terminal (container must be running):
   

   Code Block
   language shell
   docker exec -it <container_id> sh

   where <container_id> is the Docker container ID.
3. Go to the Axxon One bin directory:
   

   Code Block
   language shell
   cd /opt/AxxonSoft/AxxonOne/bin

4. Run the command:
   

   Code Block
   language shell
   ./start_app support /data

   This initiates the process of creating the support package, which will be saved in the data directory.
5. Exit the terminal using the command:
   

   Code Block
   language shell
   exit

6. Go to the /var/lib/docker/volumes/<volume_id>/data directory, which is configured for file exchange between the container and the host. The completed support package will be located in this directory.

Collecting the support package in the Docker container is complete.

To launch the Axxon One Server using Docker, do the following:

...

...

Install the packages to use the repository via HTTPS.

sudo apt-get install apt-transport-https ca-certificates curl gnupg2 software-properties-common

Add official Docker GPG key.

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

sudo apt-key fingerprint 0EBFCD88

...

for the x86_64 / amd64 architecture:

Debian:

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"

Ubuntu:

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

for the armhf architecture:

Debian:

sudo add-apt-repository "deb [arch=armhf] https://download.docker.com/linux/debian $(lsb_release -cs) stable"

Ubuntu:

sudo add-apt-repository "deb [arch=armhf] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Update the lists of packages:

sudo apt-get update

Install and configure the Docker:

Install docker-ce.

sudo apt-get install docker-ce docker-compose

Add a user to the Docker.

sudo adduser docker

Install git and the envsubst utility using the command:

sudo apt-get install git gettext binutils

...

...

Install the packages and set up the repository:

sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo

Refresh metadata cache:

dnf makecache

...

Install Docker with additional packages:

dnf -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose

Install git and the envsubst utility using the command:

dnf install git gettext binutils

...

Go to the directory where the container will be located.

cd /home/%username

where %username is a username under which the container will be located.

Clone the axxonnext.docker repository.

git clone https://src.axxonsoft.dev/bitbucket/scm/one/axxonnext.docker.git

...

If the "server certificate verification failed" error occurs, execute the following command in the terminal:

export GIT_SSL_NO_VERIFY=1

...

Go to the axxonnext.docker folder:

cd /home/%username/axxonnext.docker/

where %username is a username under which the container will be created.

Download the contents of the git repository:

git pull

...

Copy the deb packages of Axxon One, Detector Pack and Driver pack to the /home/%username/axxonnext.docker/server/build/ folder.

mv /home/user/Downloads/axxon-* /home/axxonnext.docker/server/build/ 

Go to the axxonnext.docker/server folder.

cd /home/%username/axxonnext.docker/server

...

Execute the command:

./axxon-one.sh build

The assembly of the Axxon One container will begin.

To view the list of the assembled containers after the operation is complete, execute the command:

./axxon-one.sh list

The Axxon One Server launch using Docker is complete.

...