Previous page AxxonData in Linux OS  Generating and applying the HTTPs certificate in Windows OS Next page

On this page:

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

Minimum requirements for installing and running AxxonData

Selecting an operating system for AxxonData installation

Ports used for AxxonData operation

Installation of AxxonData

Attention!

  • 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 following:

  1. Download the distribution kit using the link.
  2. Run the AxxonData installer as Administrator.
  3. Select the installation language and click OK:
  4. Click Next:
  5. Select the installation directory:
  6. Click Next.

  7. Select the access protocol for local cloud:

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

      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. 

      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.

  8. Click Next. A window with a selection of components to install opens:

  9. Set the checkboxes next to the components that you want to install. We recommend installing all components.
  10. Click Next.
  11. Select the folder from the Start menu. By default, it is AxxonData:

  12. Click Next.
  13. Click Install:

    AxxonData installation starts on your computer:

  14. To send email notifications, specify the SMTP server parameters. If you don't want to send notifications, click Next.
    To set up an SMTP server, do the following:
    1. In the Server address field, enter the SMTP server for outgoing mail.
    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.

      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.
  15. Click Next.
  16. Enter the depth of event storage in days. By default, it is 60 days:
  17. Click Next.
  18. Click Finish and restart the computer:

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 and C:\ProgramData\AxxonSoft\AxxonNet folder.

AxxonData will be available at:

Connection protocolAddress
HTTPShttps://vmscloud.local
HTTPhttp://vmscloud.local

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

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

  1. On the computer on which the Axxon One Server is installed, specify the cloud address with the protocol.
  2. Start the Server.
  3. Follow these steps for all Servers of Axxon-domain.
  4. 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.

      Note

      The hosts file must be readable and writable.

    2. Add the rootCA.pem certificate from the AxxonData installation directory to the trusted root certification authorities.
      certutil –addstore -enterprise –f “Root” c:\rootCA.pem
    3. Configure security policies:
      1. Run the Local Group Policy Editor:
        WIN+R → gpedit.msc
      2. Select Windows Settings → Security Settings → Public Key Policies → Certificate Path Validation Settings. 
      3. Set the settings checkboxes in the Per user certificate stores section, and the Define these policy settings checkbox.
         
      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:

    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:

        A window opens to confirm the installation of the selected components of AxxonData:
    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:

    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:
  4. Click Next.
  5. In the window that opens, click Yes:
  6. Click Install.
  7. Specify the SMTP server parameters:
    1. In the Server address field, enter the SMTP server for outgoing mail.
    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.

      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:
        sc delete axxondata
        sc delete reports
        sc delete nats-streaming-server
        sc delete postgresql-10-ac
        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.

  • No labels