Page History

General information

AxxonData is  is a local version of the AxxonNet cloud service . and it is used to work in local networks only. AxxonData is compatible with Axxon One version 1.0.4 and with the Axxon Next archive product.

To run AxxonData, it is recommended to use a computer with a 1.0 GHz processor with two or more cores and 2 GB RAM.

...

Docker installation

To install the latest version of Docker from the official repository, do the following:

1. Update the current package list

.

2. :

   Code Block
   language bash
   sudo apt update

3. Install the packages that allow APT to use HTTPS

.

4. :

   Code Block
   language bash
   sudo apt install apt-transport-https ca-certificates curl software-properties-common

5. Add the CFG key of the official Docker repository to the system

.

6. :

   Code Block
   language bash
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

   Info
   title Note
   When installing on Debian

11

7. 12, this command will look like this: Code Block language bash curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg

apt

8. --

key

9. dearmor

add -

10. -o /usr/share/keyrings/docker-archive-keyring.gpg

11. Add the Docker repository to the list of the APT package sources

list.

12. :
    

    Code Block
    language bash
    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"

    Info
    title Note
    When installing on Debian

11

13. 12, this command will look like this: Code Block

sudo add-apt-repository

14. language bash echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian

stretch stable"

15. $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

16. Update the current package list including the Docker packages from the added repository

.

17. :

    Code Block
    language bash
    sudo apt update

18. Make sure the installation is performed from the Docker repository

.

19. :
    

    Code Block
    language bash
    apt-cache policy docker-ce

    Response example:

    Code Block
    language bash
    docker-ce: Installed: (none) Candidate: 18.03.1~ce~3-0~ubuntu Version table: 18.03.1~ce~3-0~ubuntu 500 500 https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages

20. Install the Docker

.
code

21. :
    

    Code Block
    language bash
    sudo apt install docker-ce

    
    

    Info
    title Note
    When installing on Debian 12, this command will look like this: Code Block language bash sudo apt install docker-ce docker-ce-cli containerd.io

22. Make sure the Docker is running

.

23. :
    

    Code Block
    language bash
    sudo systemctl status docker

    The response
should
24. must contain the active (running) status:

    Code Block
    language bash
    docker.service - Docker Application Container Engine Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2018-07-05 15:08:39 UTC; 2min 55s ago Docs: https://docs.docker.com Main PID: 10096 (dockerd) Tasks: 16 CGroup: /system.slice/docker.service ├─10096 /usr/bin/dockerd -H fd:// └─10113 docker-containerd --config /var/run/docker/containerd/containerd.toml

AxxonData installation

To install AxxonData, do the following:

1. Download the distribution archive from the AxxonSoft website and unpack it into any folder.

2. The default access protocol is HTTPS

, which

3. that requires manual installation of certificates on client AxxonData computers

in local cloud

4. . If it is necessary to switch to HTTP, run the following command:
   

   Code Block
   language bash
   sudo ./http_https_switcher.sh HTTP

   HTTP is an insecure protocol that does not require a certificate to be installed. To switch back to HTTPS, run the following command:
   

   Code Block
   language bash
   sudo ./http_https_switcher.sh HTTPS

NotetitleAttention!

If you install AxxonData using the HTTPS access protocol, then it will not be possible to upgrade it to HTTP later.

HTTP protocol is available starting from Axxon One 1.9.

6. In the terminal,

execute

7. run the

command to

8. command to grant the execution

rights

9. permissions to the scripts (load.sh, once.sh, run.sh, stop.sh).

   Code Block
   language bash
   sudo chmod +x *.sh

10. Run the once.sh script.

    Code Block
    language bash
    sudo ./once.sh

11. Run the load.sh script.

    Code Block
    language bash
    sudo ./load.sh

12. Create the Docker services.

    Code Block
    language bash
    sudo ./run.sh

13. Check the services status.

    Code Block
    language bash
    sudo docker service ls

    In the REPLICAS column, all values

should

14. must be displayed as 1/1.
    

Image RemovedAdd the vmscloud
15. Change the name of the vmscloud.local domain
to
16. in the
 
17. /etc/hosts file.

18. Install the root certificate. The certificate

should

19. must be in PEM format with a .crt extension.

    Code Block
    language

$

20. bash

    sudo mkdir /usr/share/ca-certificates/extra

$

21. sudo cp rootCA.pem /usr/share/ca-certificates/extra/rootCA.crt

$

22. sudo dpkg-reconfigure ca-certificates

    If you use Firefox, then you
should
23. must add
the
24. the rootCA certificate to the Firefox Certificates yourself.

25. Change the AxxonData address in the Axxon One configuration:

    1. Stop the Server.
    2. In the infra.
dictionar
26. 1. dictionary file, replace the address of the CLOUD_URL parameter with vmscloud.local. If the Axxon One Server is installed
on
27. 1. in Linux OS, the file will be located in the /opt/AxxonSoft/AxxonOne/Dictionary.local directory.
If
28. 1. If Axxon One Server is installed
on
29. 1. in Windows OS, the file will be located in the C:\Program Files\AxxonSoft\AxxonOne\Dictionary.local directory. 
       
    2. Start the Server.
30. On the Axxon One Server, enter the address of the computer on which AxxonData is installed in the hosts file (C:\Windows\System32\drivers\etc or /etc/hosts). For example, 192.168.11.12 vmscloud.local. If AxxonData is installed on the same computer with the Axxon One Server, you can skip this step.

Installation of AxxonData is complete.

AxxonData will be available at:

By default, 2 two test users are available:

...

1. USER NAME—Admin1, PASSWORD—admin1password.
2. USER NAME—Admin2, PASSWORD—admin2password. 

These users can create other users, including the administrators. Names of users are case insensitive.

Configuring the SMTP server

To send email notifications, you must specify the parameters of the SMTP server. If you don't want to send notifications, you can skip this step. To set up an SMTP server, do the following:

1. Stop AxxonData:
   

   Code Block
   language bash
   sudo ./stop.sh

2. In the cloud.env file, specify the values of the variables:
   
   1. AXXONCLOUD_EMAIL_TYPE—type of the Server.
   2. AXXONCLOUD_SMTP_SERVER—address of the SMTP server for outgoing mail.
   3. AXXONCLOUD_SMTP_PORT—port number used by the SMTP server for outgoing mail.
   4. AXXONCLOUD_SMTP_USERNAME—full email of the account used to send messages on the SMTP server for outgoing mail.
   5. AXXONCLOUD_SMTP_PASSWORD—16-character code without spaces generated when configuring the SMTP server for outgoing mail.
3. Load changes:
   

   Code Block
   language bash
   sudo ./load.sh

4. Run AxxonData:
   

   Code Block
   language bash
   sudo ./run.sh

Configuration of the SMTP server is complete

...

.

Updating the data communication protocol on the previously installed AxxonData

To change the data communication protocol on a previously installed local cloud AxxonData, do the following:

1. Stop

the local cloud

2. AxxonData:
   

   Code Block
   language bash
   sudo ./stop.sh

3. Change the protocol:
   

   Code Block
   language bash
   sudo ./http_https_switcher.sh HTTP

#

4. - change https to http sudo ./http_https_switcher.sh HTTPS

#

5. - change http to https

6. Load the changes:
   

   Code Block
   language bash
   sudo ./load.sh

7. Run

the local cloud

8. AxxonData:
   

   Code Block
   language bash
   sudo ./run.sh

9. Check the availability of

the cloud

10. AxxonData:
    

    Code Block
    language bash
    sudo docker service ls

In the REPLICAS column, all values should must be displayed as 1/1.

The data communication protocol on the previously installed AxxonData is updated.

Updating AxxonData

To update AxxonData, do the following:

1. Stop AxxonData:
   

   Code Block
   language bash
   sudo ./stop.sh

2. Move the uploads folder to the folder with the new version of AxxonData:
   

   Note
   title Attention!
   The uploads folder is located in the /opt/AxxonData/uploads/ folder. In AxxonData 3.9 and earlier, the folder is located in the root directory.

3. In the terminal, run the command to grant the execution permissions to the scripts (load.sh, once.sh, run.sh, stop.sh) in the folder with the new AxxonData version:
   

   Code Block
   language bash
   sudo chmod +x *.sh

4. Load changes:
   

   Code Block
   language bash
   sudo ./load.sh

5. If you configured an SMTP server, you must update the variable data in the cloud.env file (seeConfiguring the SMTP server).
6. Update the data communication protocol (see Updating the data communication protocol on the previously installed AxxonData). 
7. Start AxxonData:
   

   Code Block
   language bash
   sudo ./run.sh

AxxonData update is complete.

Removing AxxonData 

To remove AxxonData, do the following:

1. Remove all containers:
   1. Stop AxxonData:
      

      Code Block
      language bash
      sudo ./stop.sh

   2. Stop all Docker containers:
      

      Code Block
      language bash
      sudo docker stop $(docker ps -qa)

   3. Remove all Docker containers:
      

      Code Block
      language bash
      sudo docker rm $(docker ps -qa)

   4. Remove all images:
      

      Code Block
      language bash
      sudo docker rmi -f $(docker images -qa)

   5. Remove all volumes:
      

      Code Block
      language bash
      sudo docker volume rm $(docker volume ls -q)

   6. Remove all networks:
      

      Code Block
      language bash
      sudo docker network rm $(docker network ls -q)

   7. Press Y to confirm.
      The following commands must not output any items:
      

      Code Block
      language bash
      sudo docker ps -a

      Code Block
      language bash
      sudo docker images -a

      Code Block
      language bash
      sudo docker volume ls

   8. Remove all unused images:
      

      Code Block
      language bash
      sudo docker system prune

   9. Press Y to confirm.
2. Remove Docker. Enter the commands one by one:
   

   Code Block
   language bash
   sudo dpkg -l | grep -i docker

   Code Block
   language bash
   sudo apt-get purge -y docker-buildx-plugin docker-ce docker-ce-cli docker-ce-rootless-extras docker-compose-plugin

   Code Block
   language bash
   sudo apt-get autoremove -y --purge docker-buildx-plugin docker-ce docker-ce-cli docker-ce-rootless-extras docker-compose-plugin

   Code Block
   language bash
   sudo rm -rf /var/lib/docker /etc/docker

   Code Block
   language bash
   sudo /etc/apparmor.d/docker

   Code Block
   language bash
   sudo groupdel docker

   Code Block
   language bash
   sudo -rf /var/run/docker.sock

3. Remove the uploads folder and the AxxonData folder:
   

   Code Block
   language bash
   sudo rm -rf /opt/AxxonData/

   Note
   title Attention!
   The uploads folder is located in the /opt/AxxonData/uploads/ folder. In AxxonData 3.9 and earlier, the folder is located in the root directory.

Removing AxxonData is complete.