Linux: Server Cluster System Installation

Follow this step-by-step guide to install the system components on a server cluster running Linux/Ubuntu 20.04.

Introduction

  • Before starting the installation, ensure that the operating system is Ubuntu 20.04 Server (64-bit). Other Ubuntu versions are not supported.
  • Use only Intel CPUs with AVX2 and SSE4.2 for the proper functioning of the VEZHA Analytics System. AMD CPUs are not supported.
  • Install and configure MySQL before proceeding with the analytics system installation to establish a connection to the server. For instructions on installing MySQL DB Management System, refer to the MySQL Installation Guide.
  • Maintain a stable internet connection during the software installation process. After the installation is complete, disconnect the internet if desired.
  • During the installation process, all necessary drivers will be downloaded and installed automatically. Do not pre-install any drivers.
  • After installing Middleware Core on the server, it is crucial to disable automatic package updates following the Disable Automatic Updates guidelines. Additionally, manual package updates must be strictly avoided. Failure to adhere to this instruction may result in the improper functioning of the system.
  • The Storage folder needs to be accessible to all servers within the cluster, including both Middleware and analytical servers.

To initiate the system installation, navigate to the Installation Files section in the Partners Portal and select either the Linux CPU Server Analytics block or the Linux GPU Server Analytics block, depending on the desired version.

Download and install the GPU files if the server has GPU hardware, as the Analytics System requires it for proper functionality. Otherwise, refrain from installing the GPU files.

To enhance access rights before working with archives in Linux, run the command in the command line:

sudo -i

To obtain the necessary archives, input the command in the command line for each archive as shown in the example:

wget <full_link_from_distr_website>/incoresoft-middleware-core.tgz

Press Enter and wait patiently until the file download is completed.

Middleware Core Installation

Download the Middleware Core archive:

incoresoft-middleware-core.tgz

Unpack the archive:

tar -xzf incoresoft-middleware-core.tgz

Execute the following command to run the Middleware Core installation:

./install-incoresoft-middleware-core.sh

Access the following URL:

  • If the Middleware Core was installed on the current PC, use http://localhost:2001/
  • If the Middleware Core was installed on a remote server, use http://ip:2001/ where IP is the IP address of the server where the Middleware Core was remotely installed

Within the Database block, perform the following steps:

  • Select the MySQL DB type from the drop-down list
  • Fill in the necessary fields for the DB connection:
    • In the Host field, specify the IP address of the server with the preinstalled and configured DB
    • In the Login field, enter the admin login for accessing the DB
    • In the Password field, provide the password associated with the DB admin login
  • Click the Connection Test button to:
    1. Verify the DB server connection: A successful connection is indicated by a green Connection toggle
    2. Create the database: A successful DB creation is indicated by a green Database toggle
  • Click the Save and Reload button to save the current settings and restart the service
  • Avoid selecting the Internal DB type for a server cluster installation.
  • The admin login and password are used only once during the initial setup to create a limited internal user for creating the database.

Wait while the system checks for installed middleware plugins:

Once the webpage reloads, use the default user login and password to access the system:

  • Login: admin
  • Password: admin

Process Runner Installation

Installation of Process Runner is required on every PC where analytical components need to be installed.

Download the Process Runner archive file:

incoresoft-process-runner-cpu.tgz
or
incoresoft-process-runner-gpu.tgz

Unpack the archive file:

tar -xzf incoresoft-process-runner-cpu.tgz
or
tar -xzf incoresoft-process-runner-gpu.tgz

To install Process Runner, execute the appropriate command based on the system's configuration:

./install-incoresoft-process-runner-cpu.sh
or
./install-incoresoft-process-runner-gpu.sh

Specify the server's serial number in the cluster (1, 2, 3, etc.) in the Server ID in Cluster field and click the Ok button:

In the subsequent installation dialog, enter either "localhost" or the IP address of the server where Middleware Core is installed, and click the Ok button:

Once the installation of Process Runner is finished, it is necessary to restart the computer to ensure proper operation of the NVIDIA graphics card drivers. Next, it is essential to install the required analytics components.

Analytics Components Installation

To ensure proper functionality of the analytics components, it is necessary to have Process Runner preinstalled on each server where the installation of analytics components is required.

Download the analytics components archive file:

Face Recognition:
incoresoft-face-analytics-cpu.tgz
incoresoft-face-analytics-gpu.tgz

Gun Detection:
incoresoft-gun-detector-analytics-gpu.tgz

Hard Hat Detection:
incoresoft-hardhat-analytics-gpu.tgz

License Plate Recognition:
incoresoft-alpr-analytics-gpu.tgz

Motion Detection:
incoresoft-motion-detection-analytics-gpu.tgz

Object Detection / Traffic Analytics / Smart Tracking System / Crowd Detection:
incoresoft-object-in-zone-analytics-gpu.tgz

Smoke & Fire Detection:
incoresoft-smoke-fire-analytics-gpu.tgz

UIC & Container:
incoresoft-railways-analytics-gpu.tgz
Some analytics have common installation files for both CPU and GPU versions (...-analytics-gpu.tgz). When installing them, it is important to choose the Process Runner CPU or GPU version depending on your requirements.

Extract the contents of the archive:

Face Recognition:
tar -xzf incoresoft-face-analytics-cpu.tgz
tar -xzf incoresoft-face-analytics-gpu.tgz

Gun Detection:
tar -xzf incoresoft-gun-detector-analytics-gpu.tgz

Hard Hat Detection:
tar -xzf incoresoft-hardhat-analytics-gpu.tgz

License Plate Recognition:
tar -xzf incoresoft-alpr-analytics-gpu.tgz

Motion Detection:
tar -xzf incoresoft-motion-detection-analytics-gpu.tgz

Object Detection / Traffic Analytics / Smart Tracking System / Crowd Detection:
tar -xzf incoresoft-object-in-zone-analytics-gpu.tgz

Smoke & Fire Detection:
tar -xzf incoresoft-smoke-fire-analytics-gpu.tgz

UIC & Container:
tar -xzf incoresoft-railways-analytics-gpu.tgz

Execute the necessary command to install the analytics components:

Face Recognition:
./install-incoresoft-face-analytics-cpu.sh
./install-incoresoft-face-analytics-gpu.sh

Gun Detection:
./install-incoresoft-gun-detector-analytics-gpu.sh

Hard Hat Detection:
./install-incoresoft-hardhat-analytics-gpu.sh

License Plate Recognition:
./install-incoresoft-alpr-analytics-gpu.sh

Motion Detection:
./install-incoresoft-motion-detection-analytics-gpu.sh

Object Detection / Traffic Analytics / Smart Tracking System / Crowd Detection:
./install-incoresoft-object-in-zone-analytics-gpu.sh

Smoke & Fire Detection:
./install-incoresoft-smoke-fire-analytics-gpu.sh

UIC & Container:
./install-incoresoft-railways-analytics-gpu.sh

In the installation dialog for the Face Recognition analytics component, enter "localhost" or the IP address of the server where Middleware Core is installed to specify the server, then click the Ok button:

During the installation of the LPR analytics component, in the subsequent installation dialog, manually select the region corresponding to the current location of the server, and then click the Ok button:

Refer to the Supported Countries documentation to verify which analytical model corresponds to the desired country for accurate license plate recognition.

After the installation of all required analytics components, restart the webpage.

Once the webpage reloads, use the default user login and password to access the system:

  • Login: admin
  • Password: admin

To verify the analytical server is installed correctly, after the installation of Process Runner and all required analytics components, follow these steps:

  1. Open the Settings section in the left menu
  2. Select the Servers item
  3. Check if the new analytical server has been successfully added to the server table

The initial system setup is now complete.

Once the new types of analytics components are properly installed, it is essential to install the corresponding plugins. To learn more about plugin installation, refer to the Plugin Marketplace documentation.

Disable Automatic Updates

To disable automatic package updates on the server with Middleware Core installation, open the file using the command line:

nano /etc/apt/apt.conf.d/20auto-upgrades

Modify the contents of the file as follows:

Replace:

APT::Periodic::Update-Package-Lists "1";

APT::Periodic::Unattended-Upgrade "1";

With:

APT::Periodic::Update-Package-Lists "0";

APT::Periodic::Download-Upgradeable-Packages "0";

APT::Periodic::AutocleanInterval "0";

APT::Periodic::Unattended-Upgrade "0";

Make sure that all values are set to 0. Save the changes.