Page History

AxxonData is a local version of the AxxonNet cloud service AxxonNet. 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.

Installation of AxxonData

To install AxxonData, do the followingPerform the installation as follows:

1. Download the distribution kit using the link.
2. Run the AxxonData installer as
an
3. Administrator.
4. Select the installation language and click OK
.
5. :
   Image Modified
6. Click Next
.
7. :
   Image Modified
8. Select the installation
directory and click
9. directory:
   Image Added
10. Click Next.
Image Removed

11. Select the access protocol for local cloud

and click Next.
Image Removed

12. :

    1. HTTPS—a standard AxxonData installation will be performed using a certificate on port 443.
       

       Note
       title Attention!
       If you install AxxonData using the HTTPS access protocol, then it

will not

13. 1. won't be possible to

upgrade

14. 1. update it to HTTP later.

HTTP protocol is available starting from Axxon One 1.9.If you select HTTPS, the local version of AxxonNet will be installed in a standard way using a certificate. If you select HTTP, the local version of AxxonNet will be installed without encryption using port 80. If port 80 is occupied
15. 2. HTTP—a standard AxxonData installation will be performed without encryption using port 8082. 
       

       Note
       title Attention!
       If the version of AxxonData is lower than 3.15, the default installation is performed on port 80 when you use the HTTP access protocol. In this case, to web access AxxonData and add Servers to it, you must open port 80 from Client devices or from the connected Axxon One Server. If port 80 is busy (for example, if

the

16. 1. the Axxon One

Server

17. 1. Server is running at the time of installation), you will be prompted to use port 8082.

       Image Added

18. Click Next. A window with a selection of components to install opens:
    Image Modified
    
If you release port 80 (for example, by changing the port of the Axxon One Web-Server), then AxxonData will be installed on port 80.
19. Set the checkboxes next to the components that you want to install. We recommend installing all components.
20. Click Next.
21. Select the folder from the Start menu. By default, it is AxxonData:
    Image Added
    
22. Click Next.
23. Click Install:
    Image Added
    AxxonData installation starts on your computer:
    Image Added
    
24. To send email notifications,
set
25. specify the SMTP server
settings
26. parameters. If you
do not
27. don't want to send notifications,
you can skip this step.
28. click Next.
    To set up an SMTP server, do the following:
    1. In the Server address field, enter the SMTP
Server
29. 1. server for outgoing mail.
       
Image Removed
30. 1. Image Added
    2. In the Server port [1..65535] field, enter the port number used by the SMTP server for outgoing mail
Server
31. 1. .
    2. In the User name field, enter the
name
32. 1. full email of the account used to send messages on the SMTP server for outgoing mail
Server
33. 1. .
    2. In the Password field, enter the
password for the account on the outgoing mail Server.
34. Click Next.
35. Click Next.
    Image Removed
36. Click Install.
    Image Removed
    AxxonData installation will start on your computer:
    Image Removed
37. Click Finish.
    Image Removed
38. Restart the computer.
39. 1. 16-character code without spaces generated when configuring the SMTP server for outgoing mail.
    2. In the Email to field, enter the email of the account to which a message will be sent about the correctness of the entered SMTP server parameters.
    3. Click the Test button.
       

       Note
       title Attention!
       A message will be displayed if you specified the parameters of the SMTP server: Correctly: Test message is successfully sent. Please check your email. Incorrectly: An error occurred while sending the test message. Please check the parameters to connect to the SMTP Server.

40. Click Next.
41. Enter the depth of event storage in days. By default, it is 60 days:
    Image Added
42. Click Next.
43. Click Finish and restart the computer:
    Image Added

Installation of AxxonData is complete. After installation, the AxxonData shortcut will be created on the desktop. Installation logs will be available in the C:\Users\User\AppData\Local\Temp folder, the product logs will be available in the C:\ProgramData\AxxonSoft\AxxonData or and C:\ProgramData\AxxonSoft\AxxonNet folder.

AxxonData will be available at:

...

By default, two test users are available:

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

Limitations of local AxxonData Client 

There are 2 predefined users in the local AxxonData Client:

1. Admin1, the password is admin1password;
Admin2, the password is admin2password.

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

Configuring the local

...

Client installation type

Perform the configuration as follows:

On all Axxon-domain Servers where AxxonData is not installed, in the hosts file (C:\Windows\System32\drivers\etc) specify the IP address of the installed local AxxonData Server: vmscloud.local. 

Image Removed

...

...

To configure the local Client installation type, do the following:

1. On the computer
where
2. on which the Axxon One Server is installed
:
3. Stop the Server.

In the infra.dictionary file located in the C:\Program Files\AxxonSoft\AxxonOne\Dictionary.local folder, in the CLOUD_URL parameter, replace the address of the CLOUD_URL parameter with vmscloud.local. If AxxonData uses the HTTP protocol, then in the infra.dictionary file, replace the address of the CLOUD_URL parameter with http://vmscloud.local:80 (if installed on port 80) or http://vmscloud.local:8082 (if installed on port 8082).

Image Removed


WarningDo not edit infra.dictionary using notepad.exe—it will break down the software. It is recommended to use Notepad++.
4. , specify the cloud address with the protocol.
   Image Added
5. Start the Server.
6. Follow these steps for all Servers of Axxon-domain.
7. On computers without AxxonData installed, from which you need to connect to it:

   1. In the hosts file (located at C:\Windows\System32\drivers\etc), set the IP address of the computer on which AxxonData is installed.

      Info
      title Note
      The hosts file

should

8. 1. must be readable and writable

, not read-only

9. 1. .

   2. Add the rootCA.pem certificate from the AxxonData installation directory to the trusted root certification authorities.
      

      Code Block
      certutil –addstore -enterprise –f “Root” c:\rootCA.pem

   3. Configure security policies:
      1. Run the Local Group Policy Editor:
         

         Code Block
         WIN+R → gpedit.msc

      2. Select Windows Settings → Security Settings → Public Key Policies → Certificate Path Validation Settings. 
         Image Added
      3. Set the settings checkboxes in the Per user certificate stores section, and the Define these policy settings checkbox.
         Image Added 
      4. Click Apply.
   4. Restart the computer.

Reports

When you download a scheduled AxxonData report using the link in the email, it will be downloaded only on the computer on which AxxonData is installed.

To download scheduled reports on other computer, it must be on the same local network as AxxonData or be connected to this network via VPN.

In the Reports.env file located in the C:\Program Files\AxxonSoft\AxxonData folder, it is necessary to change the value of the AXXONDATA_CLOUD_URL variable to the IP address of the computer on which AxxonData is installed.

Google Chrome and Opera browsers block downloading files via HTTP. You can download the report by right-clicking on the download link and selecting the Save link as option.

Microsoft Edge and Mozilla Firefox browsers require confirmation of the file download. You can also copy the report download link and open it in a new browser tab or window.

List of supported OS

...

Configuration of the local Client installation type is complete.

Updating AxxonData

To update AxxonData, do the following:

1. Download the distribution kit of a new version of AxxonData using the link.
2. Run the installer of a new version of AxxonData as Administrator. You don't need to uninstall the prevous version.
3. Perform the installation. The steps repeat the installation procedure (see Installation of AxxonData).
4. Set the checkboxes next to the components that you want to install:
   Image Added
   
   1. If you want to update only AxxonData and PostgreSQL 10:
      1. Set the Local cloud & Reports components checkbox.
      2. Click Next.
      3. In the window that opens, click Yes:
         Image Added
         A window opens to confirm the installation of the selected components of AxxonData:
         Image Added
   2. If necessary, update the parameters of the SMTP server and depth of event storage:
      1. Set the SMTP server and events depth parameters checkbox.
      2. Click Next.
5. Click Install:
   Image Added
   Installation of AxxonData and PostgreSQL 10 starts.
6. Update the SMTP server parameters (see Updating the parameters of the SMTP server).
7. Click Next.
8. Update the depth of event storage in days. By default, it is 60 days.
9. Click Next.
10. Click Finish and restart the computer.

Updating AxxonData is complete.

Updating the parameters of the SMTP server 

To update the parameters of the SMTP server, do the following:

1. Run the AxxonData installer as Administrator.
2. Perform the installation. The steps repeat the installation procedure (see Installation of AxxonData).
3. Set the SMTP server and events depth parameters checkbox:
   Image Added
4. Click Next.
5. In the window that opens, click Yes:
   Image Added
6. Click Install.
7. Specify the SMTP server parameters:
   1. In the Server address field, enter the SMTP server for outgoing mail.
      Image Added
   2. In the Server port [1..65535] field, enter the port number used by the SMTP server for outgoing mail.
   3. In the User name field, enter the full email of the account used to send messages on the SMTP server for outgoing mail.
   4. In the Password field, enter the 16-character code without spaces generated when configuring the SMTP server for outgoing mail.
   5. In the Email to field, enter the email of the account to which a message will be sent about the correctness of the entered SMTP server parameters.
   6. Click the Test button.
      

      Note
      title Attention!
      A message will be displayed if you specified the parameters of the SMTP server: Correctly: Test message is successfully sent. Please check your email. Incorrectly: An error occurred while sending the test message. Please check the parameters to connect to the SMTP Server.

8. Click Next.
9. Click Next
10. Click Finish and restart the computer.

Updating the parameters of the SMTP server is complete.

Deleting AxxonData

To delete AxxonData, do the following:

1. Go to Start → Control Panel →Programs and Features.
2. In the list of installed programs, find AxxonData and right-click it.
3. In the context menu, select Uninstall.
4. In the window that opens, click Yes. The process of uninstalling AxxonData starts.
5. In the window that opens, click OK.
6. In the list of installed programs, find PostgreSQL 10 and right-click it.
7. In the context menu, select Uninstall/Change.
8. In the window that opens, set the Entire application checkbox and click Next. The process of uninstalling PostgreSQL 10 starts.
9. In the window that opens, click OK.
10. Delete the C:\Program Files\AxxonSoft\AxxonData\pg folder.
11. Delete the C:\Program Files\AxxonSoft\AxxonData folder.
12. If you cannot delete the C:\Program Files\AxxonSoft\AxxonData\pg and C:\Program Files\AxxonSoft\AxxonData folders, then:
    1. Go to Start → Task Manager → Processes.
    2. Make sure that AxxonData, nginx, and nats-streaming-server processes aren't present, otherwise delete them.
    3. Go to Start → Task Manager → Services.
    4. Make sure that AxxonData, Reports, nats-streaming-server, postgresql-10-ac and exporter processes aren't present, otherwise delete them.
       1. Open a command line as administrator.
       2. Enter the commands to delete the services one by one:
          

          Code Block
          sc delete axxondata

          Code Block
          sc delete reports

          Code Block
          sc delete nats-streaming-server

          Code Block
          sc delete postgresql-10-ac

          Code Block
          sc delete exporter

13. After deleting all dependencies in processes and services, you must delete the C:\Program Files\AxxonSoft\AxxonData folder manually.
14. Restart the computer.

AxxonData is deleted.