Page History

AxxonData — is a local version of AxxonNet cloud service AxxonNet. AxxonData  AxxonData is compatible with Axxon One version 1.0.4 and with the Axxon Next archive product.

Minimum requirements for installing and running AxxonData

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.

Disk subsystem requirements: 4 GB to install AxxonData and at a rate of 1 MB = 1000 events to store the events from the detection tools in the database.

Docker installation

...

1. Update the current package list.

   Code Block
   sudo apt update

   
   

2. Install the packages that allow APT to use HTTPS.

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

   
   

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

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

   
   

   Info
   title Note
   When installing on Debian 11, this command will look like this: Code Block curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

   
   

4. Add the Docker repository to the APT package sources list.
   

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

   
   

   Info
   title Note
   When installing on Debian 11, this command will look like this: Code Block sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian stretch stable"

   
   

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

   Code Block
   sudo apt update

   
   

6. Make sure the installation is being performed from the Docker repository.
   

   Code Block
   apt-cache policy docker-ce

   Response example:
   

   Code Block
   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

   
   

7. Install the Docker.
   

   Code Block
   sudo apt install docker-ce

   
   

8. Make sure the Docker is running.
   

   Code Block
   sudo systemctl status docker

   The response should contain the active (running) status:
   

   Code Block

   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 and unpack it into any folder.

2. The default access protocol is HTTPS, which requires manual installation of certificates on client computers in local cloud. If it is necessary to switch to HTTP, run the following command:
   

   Code Block
   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
   sudo ./http_https_switcher.sh HTTPS

   
   

   Note
   title Attention!
   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.

   
   

3. In the terminal, execute the command to grant execution rights to the scripts (load.sh, once.sh, run.sh, stop.sh).

   Code Block
   sudo chmod +x *.sh

   
   

4. Run the once.sh script.

   Code Block
   sudo ./once.sh

   
   

5. Run the load.sh script.

   Code Block
   sudo ./load.sh

   
   

6. Create the Docker services.

   Code Block
   sudo ./run.sh

   
   

7. Check the services status.

   Code Block
   sudo docker service ls

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

8. Add the vmscloud.local domain to the /etc/hosts file.

9. Install the root certificate. The certificate should be in PEM format with a .crt extension.
   

   Code Block
   $ mkdir /usr/share/ca-certificates/extra $ cp rootCA.pem /usr/share/ca-certificates/extra/rootCA.crt $ dpkg-reconfigure ca-certificates

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

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

    1. Stop the Server.
    2. In the infra.dictionar file, replace the address of the CLOUD_URL parameter with vmscloud.local.  If If the Axxon One Server is installed on Linux, the file will be located in the /opt/AxxonSoft/AxxonOne/Dictionary.local directory. If Axxon One Server is installed on Windows, the file will be located in the C:\Program Files\AxxonSoft\AxxonOne\Dictionary.local directory. 
       
    3. Start the Server.
11. 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 vmscloud12 vmscloud.local. If AxxonData is installed on the same PC computer with the Axxon One Server, you can skip this step.

AxxonData will be available at vmscloud.local. By default, 2 test users are available:

1. Admin1/admin1password.
2. Admin2/admin2password.

Updating the data communication protocol on the previously installed AxxonData

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

1. Stop the local cloud:
   

   Code Block
   sudo ./stop.sh

   
   

2. Change the protocol:
   

   Code Block
   sudo ./http_https_switcher.sh HTTP # change https to http sudo ./http_https_switcher.sh HTTPS # change http to https

   
   

3. Load the changes:
   

   Code Block
   sudo ./load.sh

   
   

4. Run the local cloud:
   

   Code Block
   sudo ./run.sh

   
   

5. Check the availability of the cloud:
   

   Code Block
   sudo docker service ls

   
   

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