Installing Eocortex Neural Networks Special package🔗

Warning

If the Face Recognition (Complete) module is used, the face databases will be automatically updated at the first start after updating Eocortex and the Eocortex Neural Networks package from version 3.3 or lower to version 3.4 or higher. It will take some time.

Warning

Since version 4.0, Eocortex uses PostgreSQL for all internal databases. When upgrading from earlier versions, it is recommended also to read the information about PostgreSQL installation.

Requirements and recommendations

Warning

Stable operation of the package is guaranteed only under the following operating systems:

  • Windows 10

  • Windows Server 2016

  • Ubuntu 20.04, 22.04

  • Debian 10, 11

  • CentOS 7

Workability of the package is not guaranteed when using other operating systems.

Minimum hardware requirements:

  • A processor that supports AVX instructions;

  • An NVIDIA graphics card (GPU) with an index of compute capability of at least 7.0 or higher and video memory capacity of at least 6 GB; herewith, other characteristics and performance of the graphics card must be no lower than that of NVIDIA RTX 3050 or NVIDIA RTX 2060 model.

  • Version of the video card driver at least 460;

  • Swap file at least half of the total RAM size.

If the package will be installed on a virtual machine, it may additionally be required to:

  • Enable support for AVX instructions in the guest machine settings;

  • Use GRID drivers for GPU virtualization.

Note

Simultaneous use of several video cards for analyzing camera streams is acceptable. However, correct work of the analytics is possible only when using video cards that are identical to each other by their technical properties.

Warning

Eocortex must use video cards selected for running neural networks in monopoly mode. It is not allowed to use such card for other applications or tasks that consume GPU resources, including for displaying video. Simultaneous use of a video card for several tasks may lead to incorrect system operation: from analytics performance degradation to server instability.

Note

The package must be installed only on the computer with the Eocortex Server application. Moreover, this server should be the main one for cameras using neural network modules.

Pre-install preparations

The Eocortex Neural Networks Special package for Windows is not directly dependent on having the Eocortex Server application deployed on the computer at the installation moment. Applications can be installed in any order.

The Eocortex Neural Networks Special package does not have an analysis mode without using the GPU, so before installing the package, it is necessary to install the latest drivers for the graphics card from the official NVIDIA website.

Warning

The graphics card drivers installed automatically with the OS have limited functionality and do not support GPU analysis.

Note

The most up-to-date version of Eocortex can be downloaded from the eocortex.com website at the Support / Software Installation Packages Supported page.

Installation of the package

Warning

The installation of the Eocortex Neural Networks Special package shall be performed under the account of the same user who will operate the application. If the application is to be launched by multiple users with different accounts, the installation must be performed for each of these users under his/her account.

Warning

Before installing the Eocortex Neural Networks Special package, close all Eocortex applications, including stopping the Eocortex Server application.

To install the Eocortex Neural Networks Special package, run the EocortexNeuralNetworksOptimized Installer.exe file, located in the root folder of the package.

In the Select language window, choose the language that will be used during the installation and in the course of operating the software on the computer.

../_images/install-cctv-language.png

Note

If the Eocortex Neural Networks Special package has already been installed on this computer, the user will be recommended to remove the previous copy of the software. In case No is clicked, the installation will be aborted, and the previous copy will remain. If Yes is clicked, the previous copy will be deleted, and the Eocortex Neural Networks Special installation wizard window will open.

If the Eocortex Neural Networks Special package is being installed on the computer for the first time, the Eocortex Neural Networks Special installation wizard will open without interruptions. Follow the wizard steps to proceed.

../_images/install-cctv-neunet-w-lic.png ../_images/install-cctv-neunet-w-folder.png ../_images/install-cctv-neunet-w-features.png

Warning

If the Eocortex Neural Networks Standard package was previously installed on the computer, the optimization of neural networks data will be performed during the installation process. This operation takes a significant amount of time and can take up to one hour.

../_images/install-optimized.png

Warning

If the Eocortex Neural Networks Special package is updating or installing for the first time, the installation process will take up to 15 minutes.

../_images/install-cctv-neunet-w-finish.png
Pre-install preparations

The Eocortex Neural Networks Special package for Linux is directly dependent on the Eocortex Server application being deployed on the computer at the installation moment. It is necessary to install Eocortex Server before installing the Eocortex Neural Networks Special package.

The Eocortex Neural Networks Special package does not have an analysis mode without using the GPU, so before installing the package, it is necessary to install the latest drivers for the graphics card from the official NVIDIA website.

Warning

The Nouveau kernel module, which provides graphics support for Linux, is not suitable for GPU analysis.

Installation of graphics card driver

The driver installation process may vary depending on your operating system. The instructions below are provided as an example, alternative installation methods can be found in the documentation for the selected operating system.

Warning

All actions must be performed as a user with administrator privileges.

  1. Find the appropriate driver package in the repository by running the command in the Terminal:

    sudo ubuntu-drivers devices
    
  2. Install the selected driver package:

    sudo apt install nvidia-driver-[version]
    

    Where nvidia-driver-[version] is the actual name of the package.

  3. Reboot the OS:

    sudo reboot
    
  4. Check that the drivers have been installed successfully:

    sudo lshw -c video
    
  5. Check that the graphic card is successfully initialized by the OS:

    sudo nvidia-smi
    
  1. Download the appropriate driver package from the NVIDIA official website.

  2. Install kernel header files:

    sudo apt-get install linux-headers-$(uname -r)
    
  3. Install the build-essentials metapackage:

    sudo apt-get install build-essential
    
  4. Deactivate the Nouveau module. Open the /etc/default/grub file with a text editor and add the following to the GRUB_CMDLINE_LINUX line:

    rd.driver.blacklist=nouveau nouveau.modeset=0
    
  5. Put the Nouveau module into the blacklist. Edit (or create) the /etc/modprobe.d/blacklist.conf file with a text editor, and add the line below to the end of it:

    blacklist nouveau
    
  6. Update the bootloader configuration by running the following command in the Terminal:

    sudo update-grub
    
  7. Update the file system image by running the following command in the Terminal:

    sudo update-initramfs -u
    
  8. If X server is enabled, disable GUI startup after reboot:

    sudo systemctl isolate multi-user.target
    
  9. Reboot the OS:

    sudo reboot
    
  10. Browse to the directory with the previously downloaded driver package.

  11. Grant the execution privileges to the previously downloaded package:

    chmod a+x NVIDIA-Linux-x86_64-[version].run
    

    Where NVIDIA-Linux-x86_64-[version] is the actual name of the package.

  12. Install the driver package:

    sudo ./NVIDIA-Linux-x86_64-[version].run
    

    Where NVIDIA-Linux-x86_64-[version] is the actual name of the package.

  13. Reboot the OS again:

    sudo reboot
    
  1. Download the appropriate driver package from the NVIDIA official website.

  2. Install kernel header files:

    sudo yum -y install kernel-devel
    
  3. Install the Development Tools metapackage:

    sudo yum -y groupinstall "Development Tools"
    
  4. Deactivate the Nouveau module. Open the /etc/default/grub file with a text editor and add the following to the GRUB_CMDLINE_LINUX line:

    rd.driver.blacklist=nouveau nouveau.modeset=0
    
  5. Put the Nouveau module into the blacklist. Edit (or create) the /etc/modprobe.d/blacklist.conf file with a text editor, and add the line below to the end of it:

    blacklist nouveau
    
  6. Update the bootloader configuration by running the following command in the Terminal:

    sudo grub2-mkconfig -o /boot/grub2/grub.cfg
    
  7. Update the file system image by running the following command in the Terminal:

    sudo mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r)-nouveau.img
    
    sudo dracut /boot/initramfs-$(uname -r).img $(uname -r)
    
  8. Reboot the OS:

    sudo reboot
    
  9. If X server (GUI) is enabled, then disable it via terminal:

    sudo init 3
    
  10. Browse to the directory with the previously downloaded driver package.

  11. Grant the execution privileges to the previously downloaded package:

    chmod a+x NVIDIA-Linux-x86_64-[version].run
    

    Where NVIDIA-Linux-x86_64-[version] is the actual name of the package.

  12. Install the driver package:

    sudo ./NVIDIA-Linux-x86_64-[version].run
    

    Where NVIDIA-Linux-x86_64-[version] is the actual name of the package.

  13. Reboot the OS again:

    sudo reboot
    
Installation of the package

Eocortex Neural Networks Special for Linux comes as a single installation package named eocortex-neural-networks-gpu-optimized.

Warning

The eocortex-neural-networks-cpu and eocortex-neural-networks-gpu packages available in the repository belong to the Eocortex Neural Networks Standard. This is a separate neural network package, installation of which is not required when deploying the Eocortex Neural Networks Special package.

Warning

If the Eocortex Neural Networks Standard package was previously installed on the computer, the optimization of neural networks data will be performed during the installation process. This operation takes a significant amount of time and can take up to one hour.

Warning

If the Eocortex Neural Networks Special package is updating or installing for the first time, the installation process will take up to 15 minutes.

Installation of the Eocortex Neural Networks Special package on Linux can be performed in two ways:

  • Online, when the installation package is fetched from the Eocortex repository along with all dependency packages. Requires Internet access on the computer.

  • Offline, when the installation package must be pre-downloaded from the Eocortex repository, and all dependency packages must be installed manually. Does not require Internet access on the computer.

Warning

Before installing the Eocortex Neural Networks Special package, ensure that the Eocortex Server application is installed on the computer.

  1. Stop the Eocortex Server application:

    sudo systemctl stop eocortex
    
  2. Run the installation of the neural network package with the corresponding command:

    Ubuntu/Debian:

    sudo apt-get install |File.LinuxNeuralNetSpecialName|
    

    CentOS 7:

    sudo yum install |File.LinuxNeuralNetSpecialName|
    
  3. Wait until the installation process including neural network data optimization is complete.

  4. Start the Eocortex Server application back:

    sudo systemctl start eocortex
    
  1. Make sure that all required dependency packages are installed on the computer:

    • cuda-license-11-0

    • cuda-cudart-11-0

    • cuda-cublas-11-0

    • cuda-cufft-11-0

    • cuda-curand-11-0

    • cuda-cusolver-11-0

    • cuda-cusparse-11-0

    • cuda-npp-11-0

    • cuda-nvgraph-11-0

    • cuda-nvjpeg-11-0

    • cuda-nvrtc-11-0

    • cuda-libraries-11-0

    If a dependency package is missing or its version does not match, download and install the missing package from the repository.

    Ubuntu/Debian:

    https://packages.eocortex.com/deb/public/pool/main/c/
    
    https://packages.eocortex.com/deb/public/pool/main/libc/
    
    https://packages.eocortex.com/deb/public/pool/main/libn/
    

    CentOS 7:

    https://packages.eocortex.com/rpm/
    
  2. Download the eocortex-neural-networks-gpu-optimized package from the repository.

    Ubuntu/Debian:

    https://packages.eocortex.com/deb/public/pool/main/e/eocortex-neural-networks-gpu-optimized
    

    CentOS 7:

    https://packages.eocortex.com/rpm/
    
  3. Stop the Eocortex Server application:

    sudo systemctl stop eocortex
    
  4. Browse to the directory with the previously downloaded neural network package and run the installation.

    Ubuntu/Debian:

    dpkg -i eocortex-neural-networks-gpu-optimized_[version]_amd64.deb
    

    CentOS 7:

    yum install eocortex-neural-networks-gpu-optimized_[version]_amd64.deb
    

    Where [version] is the actual version of the package.

  5. Wait until the installation process including neural network data optimization is complete.

  6. Start the Eocortex Server application back:

    sudo systemctl start eocortex