Page History

AxxonData — is a local version of the AxxonNet cloud service AxxonNet. AxxonData and it is used to work in local networks only. AxxonData is compatible with Axxon NextOneversion 4.4.2 or higher.

Installation

...

Prior to the installation, make sure that ports 80 and 443 are free in the system.

1.0.4 and with the Axxon Next archive product.

Installation of AxxonData

...

Note
title Attention!
You can install local cloud on port 80 or port 8082 using the HTTP protocol. If port 80 is free, then local cloud will be installed on it. In this case, in order to access the cloud via web and add servers to it, it is necessary to provide access to port 80 from devices with installed AxxonData. If port 80 is occupied, then local cloud will be installed on port 8082. In this case, it is necessary to provide public access to two ports: 8082 and 8888.

Note
title Attention!
AxxonData is incompatible with the Failover Server and Client installation type of Axxon Next.

If Axxon One of the Failover server and client installation type is installed on your computer, you must allocate a separate computer to install AxxonData. You cannot install AxxonData together with Axxon One of the Failover server and client installation type. Before installing AxxonData, read the information in the Comment column in Ports used for AxxonData operation.

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

1. Download the distribution kit using the linkhttps://www.axxonsoft.com/support/downloads.
2. Run the AxxonData installer as Administrator.
3. Select the installation language
.
4. and click OK:
   Image Modified
5. Click Next
.
6. :
   Image Modified
7. Select the installation
directory and click
8. directory:
   Image Added
9. Click Next.

Image Removed

11. Select the access protocol for local cloud

and click Next.
Image Removed Info

title	Note

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 (for example, if the Axxon Next server

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 won't be possible to update it to HTTP later.

    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 Axxon One Server is running at the time of installation), you will be prompted to use port 8082.

       Image Added

13. 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 Next Web server), then AxxonData will be installed on port 80.

14. Set the checkboxes next to the components that you want to install. We recommend installing all components.
15. Click Next.
16. Select the folder from the Start menu. By default, it is AxxonData:
    Image Added
    
17. Click Next.
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 Next 4.6.0.717.
18. Click Install:
    Image Added
    AxxonData installation starts on your computer:
    Image Added
19. 
    
20. To send email notifications,
set
21. specify the SMTP server
settings
22. parameters. If you
do not
23. don't want to send notifications,
you can skip this step.
24. click Next.
    To set up an SMTP server, do the following:
    1. In the Server address field, enter the SMTP server for outgoing mail.
       
Image Removed
25. 1. Image Added
    2. In the Server port [1..65535] field, enter the port number used by the SMTP server for outgoing mail
server
26. 1. .
    2. In the User name field, enter the
name
27. 1. full email of the account used to send messages on the SMTP server for outgoing mail
server
28. 1. .
    2. In the Password field, enter
the password for the account on the outgoing mail server
29. 1. the 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
Next button
30. 1. 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.

31. Click Next.
Image Removed
32. Enter the depth of event storage in days. By default, it is 60 days:
    Image Added
33. Click Install Next.Image Removed
    AxxonData installation will start on your computer:
    Image Removed
34. Click Finish.
    Image Removed
35. Restart the computer.
36. 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 logs will be available in the Cthe C:\ProgramData\AxxonSoft\AxxonData or Cand C:\ProgramData\AxxonSoft\AxxonNet folder.

After installation, the AxxonData shortcut will be created on the desktop.

Limitations of local AxxonData Client 

...

AxxonData will be available at:

By default, 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 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
Next
3. One Server is installed
:
4. Stop the Server.

In the infra.dictionary file located in the C:\Program Files\AxxonSoft\AxxonNext\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


Warning
Do not edit infra.dictionary using notepad.exe − it will break down the software. It is recommended to use Notepad++.

5. , specify the cloud address with the protocol.
   Image Added
6. Start the Server.
7. Follow these steps for all Servers of Axxon-domain.
8. 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

9. 1. must be readable and writable

, not read-only

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

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.

...

To ensure the correct operation of the reports, the data transfer rate with the Axxon Next Server should be at least 300 kbps.

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

List of supported OS

...

.