Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column
width50%


Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleOn this page:
Table of Contents



Column


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.

List of supported Windows OS

AxxonData is available in Windows Server 2019, Windows Server 2022, and Windows 10.

Tip

Minimum requirements for installing and running AxxonData

...

Selecting an operating system for AxxonData installation

Ports used for AxxonData operation

To run AxxonData, we recommend using a computer with a 1.0 GHz processor with two or more cores and 2 GB RAM.

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

You can use the following formulas to calculate the required space for storing events in the database:

T = E × 60 × 24 × 0.5 ÷ 1024²

where

  • T is a total number of events in GB per day per camera;
  • is an average number of events per camera per minute;
  • 60minutes;
  • 24hours in a day;
  • 0.5coefficient;
  • 1024²—GB.

Required space for D days in GB = C × T × D

where

  • С is a total number of cameras;
  • is a total number of events in GB per day per camera;
  • is days of data storage.

Installation of AxxonData

  • You cannot install AxxonData together with Axxon PSIM, because the CassiniService service is started during Axxon PSIM installation. This service runs on port 8081, the same port as the nginx service of AxxonData.
  • Before installation, make sure that ports 80 and 443 are free in the system. Port 80 is used by the Web-Server by default (see Configuring the Web-Server).
  • 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 Client devices or from the connected Axxon One Server. If port 80 is busy, 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.
  • Before installation, make sure that port 8080 is free in the system. By default, port 8080 uses the Virtual input (see Configure virtual inputs). If port 8080 is busy, the domain synchronization with AxxonData isn’t possible.
    Note
    titleAttention!
    • 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
    3. an
    4. Administrator.
    5. Select the installation language and click OK
    6. .
    7. :
      Image Modified
    8. Click Next
    9. .
    10. :
      Image Modified
    11. Select the installation
    12. directory and click
    13. directory:
      Image Added
    14. Click Next.

    15. Image Removed
    16. Select the access protocol for local cloud

    17. and click Next.
      Image Removed
    18. :

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

        Note
        titleAttention!

        If you install AxxonData using the HTTPS access protocol, then it won't be possible to update it to HTTP later

    19. . HTTP protocol is available starting from Axxon One 1.9
      1. .

    20. If you select the HTTPS protocol, AxxonData will be installed in a standard way using a certificate. If you select HTTP, AxxonData will be installed
      1. HTTP—a standard AxxonData installation will be performed without encryption using port

    21. 80. If you free port 80 (for example, by changing the port of the Axxon One Wed-Server), AxxonData will be installed on port 80
      1. 8082. 

        Note
        titleAttention!

        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

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

        Image Added

    23. Click Next. A window with a selection of components to install opens:
      Image Modified
    24. Set the checkboxes next to the components that you want to install. We recommend installing all components.
    25. Click Next.
    26. Select the folder from the Start menu. By default, it is AxxonData:
      Image Added
    27. Click Next.
    28. Click Install:
      Image Added
      AxxonData installation starts on your computer:
      Image Added
    29. To send email notifications,
    30. set
    31. specify the SMTP server
    32. settings
    33. parameters. If you don't want to send notifications,
    34. you can skip this step.
    35. click Next.
      To set up an SMTP server, do the following:
      1. In the Server address field, enter the SMTP
    36. Server
      1. server for outgoing mail.
    37. Image Removed
      1. Image Added
      2. In the Server port [1..65535] field, enter the port number used by the SMTP server for outgoing mail
    38. Server
      1. .
      2. In the User name field, enter the
    39. name
      1. full email of the account used to send messages on the SMTP server for outgoing mail
    40. Server
      1. .
      2. In the Password field, enter the
    41. password for the account on the outgoing mail Server
      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
    42. on the outgoing mail Server
      1. to which a message will be sent about the correctness of the entered SMTP server parameters.
      2. Click
    43. Next.
    44. Click Next.
      Image Removed
      1. the Test button.
        Note
        titleAttention!

        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.
    45. Click Next.
    46. Enter the depth of event storage in days. By default, it is 60 days:
      Image Added
    47. Click Next.Click Install.
      Image Removed
      AxxonData installation will start on your computer:
      Image Removed
    48. Click Finish and restart the computer
    49. .
    50. :
    51. Image Removed
    52. 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 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. 
    3. Admin1, the password is admin1password.
    4. Admin2, the password is 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

    ...

    Perform the configuration as follows, do the following:

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

        The hosts file must be readable and writable

    7. , not read-only
      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 SettingsSecurity Settings Public Key PoliciesCertificate Path Validation Settings
    8. Image Removed
        1. Image Added
        2. Set the settings checkboxes in the Per user certificate stores section, and the Define these policy settings checkbox.
    9. Image Removed
        1. Image Added 
        2. Click Apply.
      1. 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
        titleAttention!

        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 StartControl PanelPrograms 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\
    12. AxxonData folder
    13. AxxonData folder.
    14. If you cannot delete the C:\Program Files\AxxonSoft\AxxonData\pg and C:\Program Files\AxxonSoft\AxxonData folders, then:
      1. Go to StartTask ManagerProcesses.
      2. Make sure that AxxonData, nginx, and nats-streaming-server processes aren't present, otherwise delete them.
      3. Go to StartTask ManagerServices.
      4. Make sure that AxxonData, Reports, nats-streaming-server, postgresql-10-ac
    15. and 
      1. and exporter
    16.  processes
      1.  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
    17. After deleting all dependencies in processes and services, you must delete the C:\Program Files\AxxonSoft\AxxonData folder manually.
    18. Restart the computer.

    AxxonData is deleted.

    Reports

    ...

    .