Page History

General information about the Docker image and container

Installing the Docker server

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

1. Install Docker using the official manuals:
   • Debian:
 
2. • 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

3. • dual-core

processor

4. • CPU; 4 GB RAM; 200 GB HDD.

other
5. • Other distribution packages:
 
6. • https://docs.docker.com/engine/install/.
 
Connect
8. Download the latest version of the Axxon One
 repository. To do this, do the following:Install git and the envsubst utility using the command:

For Debian and Ubuntu:


Code Block
sudo apt-get install git gettext binutils

For Fedora, RedHat Linux, CentOS:


Code Block
dnf install git gettext binutils

Clone the axxonone.docker repository.


Code Block
git clone https://src.axxonsoft.dev/bitbucket/scm/one/axxonone.docker.git

Note

title	Attention!

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

Code Block
export GIT_SSL_NO_VERIFY=1

Update the cloned repository files:

9. Go to the axxonone.docker folder:
   

   Code Block
   cd /home/%username/axxonone.docker/

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

Download the contents of the git repository:


Code Block
git pull

Create the Axxon One container. To create the Axxon One container, do the following:
10. Copy the deb packages of Axxon One, Detector Pack and Driver pack to the /home/%username/axxonone.docker/server/build/ folder.

Go to the axxonone.docker/server folder.


Code Block
cd /home/%username/axxonone.docker/server

11. Execute the command:
    

    Code Block
    ./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:


Code Block
./axxon-one.sh list

The Axxon One Server launch using Docker is complete.

1. 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.

2. 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.

...