Если используется модуль Распознавание лиц (Complete), то после обновления Macroscop и пакета Macroscop Нейросети с версии 3.3 или ниже до версии 3.4 или выше при первом запуске будет автоматически обновлена база лиц. Это займёт некоторое время.

Начиная с версии 4.0, Macroscop использует СУБД PostgreSQL для ведения всех внутренних баз данных. При обновлении с более ранних версий рекомендуется ознакомиться с информацией об установке PostgreSQL.

Стабильная работа пакета гарантируется только на следующих операционных системах:

  • Windows 10
  • Windows Server 2016
  • Ubuntu 20.04
  • Astra Linux Common Edition 2.12
  • Astra Linux Special Edition 1.7
  • Debian 10
  • CentOS 7

Работоспособность, в особенности анализ на GPU, при использовании других ОС не гарантируется.

Минимальные требования к оборудованию:

  • процессор с поддержкой инструкций AVX;
  • видеокарта (GPU) NVIDIA с индексом вычислительной мощности не ниже 6.5 и объёмом памяти не ниже 4GB; при этом характеристики и производительность видеокарты должны быть не ниже, чем у модели NVIDIA GTX 1650 Super;
  • версия драйвера видеокарты не ниже 460;
  • файл подкачки (swap) размером не менее половины от общего объёма оперативной памяти.

Если установка пакета выполняется на виртуальной машине, может дополнительно потребоваться:

  • Включить поддержку AVX инструкций в настройках гостевой машины;
  • Использовать драйвера GRID для виртуализации GPU.

Допускается одновременное использование нескольких видеокарт для анализа потоков камер. При этом корректная работа аналитики возможна только при использовании видеокарт, идентичных друг другу по техническим характеристикам.

Macroscop должен использовать выбранные для работы нейросетей видеокарты в монопольном режиме. Не допускается использование такой карты для других приложений или задач, потребляющих ресурсы GPU, в том числе для отображения видео. Одновременное использование видеокарты для нескольких задач может привести к некорректной работе системы: от снижения производительности аналитики до нестабильной работы сервера.

Пример: Одновременное выполнение задач отображения видео и его анализа модулями Распознавание лиц (Complete) или Подсчет уникальных посетителей, работающими на основе пакета Macroscop Нейросети Standard, может вызвать значительное увеличение задержки распознавания лиц при использовании видеокарт серий GTX 10XX и GTX 16XX с 4 ГБ видеопамяти и менее. Рекомендуется использовать для этих задач раздельные видеокарты.

Пакет необходимо устанавливать только на тот компьютер, на котором установлен Macroscop Сервер, являющийся основным сервером или сервером видеоаналитики для камер, использующих нейросетевые модули.

Установка на ОС Windows

Пакет Macroscop Нейросети Standard для Windows не имеет прямой зависимости от наличия в момент установки развёрнутого на компьютере приложения Macroscop Сервер. Приложения могут устанавливаться в любом порядке.

Macroscop Нейросети Standard для Windows поставляются в виде единого установочного пакета, содержащего в себе нейросети для анализа как исключительно на CPU, так и с использованием GPU. Выбор режима анализа осуществляется на этапе установки пакета.

Если планируется осуществлять анализ только на CPU, дополнительной подготовки компьютера перед установкой пакета Macroscop Нейросети Standard не требуется.

Если планируется осуществлять анализ с использованием GPU, перед установкой пакета Macroscop Нейросети Standard необходимо установить актуальный пакет драйверов для видеокарты с официального сайта NVIDIA.

Драйверы видеокарты, устанавливающиеся автоматически вместе с ОС, имеют ограниченную функциональность и не поддерживают анализ на GPU.

Актуальную версию Macroscop можно скачать на сайте www.macroscop.com со страницы Поддержка / Дистрибутивы.

Установку пакета Macroscop Нейросети Standard следует производить под учётной записью того пользователя, который будет использовать данное приложение. Если приложение будут запускать несколько пользователей с различными учетными записями, то для каждого такого пользователя нужно произвести установку под его учетной записью.

Перед установкой пакета Macroscop Нейросети Standard следует завершить работу всех приложений Macroscop, включая остановку приложения Macroscop Сервер.

Для установки пакета Macroscop Нейросети Standard нужно запустить файл MacroscopNeuralNetworksCommon Installer.exe, размещенный в корневой папке дистрибутива.

В открывшемся окне Выбор языка следует выбрать язык, который будет использоваться как при установке, так и в процессе дальнейшей работы пакета на данном компьютере.

Если на компьютере уже установлен пакет Macroscop Нейросети Standard, пользователю будет предложено удалить предыдущий экземпляр пакета. При нажатии Нет установка прервется и будет оставлен предыдущий экземпляр. При нажатии Да предыдущий экземпляр будет удален и откроется окно мастера установки Macroscop Нейросети Standard.

Если пакет Macroscop Нейросети Standard устанавливается впервые на данный компьютер, после выбора языка откроется окно мастера установки Macroscop Нейросети Standard.
Далее нужно следовать указаниям мастера.

Начиная с версии 3.5 доступна тихая установка пакета Macroscop Нейросети Standard.

Термином тихая установка называют установку программного обеспечения в автоматическом режиме, не требующем активного участия пользователя.

Тихую установку пакета Macroscop Нейросети Standard следует производить под учётной записью администратора.

Тихая установка пакета Macroscop Нейросети Standard доступна только под Windows.

При тихой установке будут установлены все компоненты пакета Macroscop Нейросети Standard.

Перед установкой пакета Macroscop Нейросети Standard следует завершить работу всех приложений Macroscop, включая остановку приложения Macroscop Сервер.

Для тихой установки пакета Macroscop Нейросети Standard нужно запустить файл MacroscopNeuralNetworksCommon Installer.exe с ключом /VERYSILENT.

Пример:

MacroscopNeuralNetworksCommon Installer.exe /VERYSILENT

При указании ключа /LOG информация о ходе установки будет записываться в файл %User%\AppData\Local\Temp\Setup Log %Дата_установки% #%Cлучайный_номер%.txt (например, в C:\Users\Пользователь\AppData\Local\Temp\Setup Log 2021-07-15 #012.txt).

С помощью ключа /PostgreDbPath можно задать путь к базе данных PostgreSQL.

Пример:

MacroscopNeuralNetworksCommon Installer.exe /VERYSILENT /PostgreDbPath="e:\int search"

По умолчанию PostgreSQL устанавливается в каталог C:\ProgramData\postgredb.

Пример логирования пути установки (при запуске с ключом /LOG):

2021-07-16 14:59:05.447 Путь к базе данных Поиска Объектов PostgreSQL: C:\ProgramData\postgre

Если PostgreSQL уже установлена, то она будет использоваться и для компонентов пакета Macroscop Нейросети Standard

Пример логирования пути установки (при запуске с ключом /LOG):

2021-07-15 15:33:42.532   Обнаружена СУБД PostgreSQL, которая будет использоваться для хранения данных модуля Поиска Объектов. Путь к базе данных: C:\Program Files\Macroscop Interactive Search\postgre

Установка на ОС Linux

Пакет Macroscop Нейросети Standard для Linux имеет прямую зависимость от наличия в момент установки развёрнутого на компьютере приложения Macroscop Сервер. Необходимо установить Macroscop Сервер перед установкой пакета Macroscop Нейросети Standard.

Macroscop Нейросети Standard для Linux поставляются в виде двух отдельных установочных пакетов, содержащих в себе нейросети для нужного режима анализа — только на CPU или с применением GPU. Выбор режима анализа происходит на этапе загрузки установочного пакета.

Если планируется осуществлять анализ только на CPU, дополнительной подготовки компьютера перед установкой пакета Macroscop Нейросети Standard не требуется.

Если планируется осуществлять анализ с использованием GPU, перед установкой пакета Macroscop Нейросети Standard необходимо установить актуальный пакет драйверов для видеокарты, загрузив их из поддерживаемого репозитория или скачав с официального сайта NVIDIA.

Модуль ядра Nouveau, обеспечивающий поддержку графики в Linux, не пригоден для осуществления анализа на GPU.

Действия, указанные ниже, необходимы при условии использования анализа на GPU. Если планируется осуществлять анализ только на CPU, данный этап можно пропустить.

Процесс установки драйверов может различаться в зависимости от ОС. Представленные ниже инструкции приведены как пример, альтернативные способы установки можно найти в документации к выбранной ОС.

Все действия должны выполняться от имени пользователя с привилегиями администратора.

Astra Linux

Установку драйверов NVIDIA на Astra Linux рекомендуется выполнять, следуя официальной инструкции разработчика ОС.

Ubuntu

  1. Найдите в репозитории подходящий пакет драйверов, выполнив в Терминале команду:

    sudo ubuntu-drivers devices

  2. Установите выбранный пакет драйверов:

    sudo apt install nvidia-driver-[версия_драйвера]

    Где nvidia-driver-[версия_драйвера] — действительное имя пакета.

  3. Перезапустите ОС:

    sudo reboot

  4. Убедитесь, что драйверы установлены успешно:

    sudo lshw -c video

  5. Убедитесь, что видеокарта успешно инициализируется в ОС:

    sudo nvidia-smi

Debian

  1. Скачайте подходящий пакет драйверов с официального сайта NVIDIA.

  2. Установите заголовочные файлы ядра:

    sudo apt-get install linux-headers-$(uname -r)

  3. Установите метапакет build-essentials:

    sudo apt-get install build-essential

  4. Отключите модуль Nouveau. В текстовом редакторе откройте файл /etc/default/grub, где добавьте к строке GRUB_CMDLINE_LINUX следующее:

    rd.driver.blacklist=nouveau nouveau.modeset=0

  5. Внесите модуль Nouveau в blacklist. В текстовом редакторе откройте (или создайте) файл /etc/modprobe.d/blacklist.conf, после чего добавьте в его конец строку:

    blacklist nouveau

  6. Обновите конфигурацию загрузчика, выполнив в Терминале команду:

    sudo update-grub

  7. Обновите образ файловой системы, выполнив в Терминале команду:

    sudo update-initramfs -u

  8. Если включен X server, отключите запуск графического интерфейса после перезагрузки:

    sudo systemctl isolate multi-user.target

  9. Перезапустите ОС:

    sudo reboot

  10. Перейдите в директорию с заранее скачанным пакетом драйверов.

  11. Предоставьте ранее скачанному пакету привилегии на выполнение:

    chmod a+x NVIDIA-Linux-x86_64-[версия_драйвера].run

    Где NVIDIA-Linux-x86_64-[версия_драйвера] — действительное имя пакета.

  12. Установите пакет драйверов:

    sudo ./NVIDIA-Linux-x86_64-[версия_драйвера].run

    Где NVIDIA-Linux-x86_64-[версия_драйвера] — действительное имя пакета.

  13. Повторно перезапустите ОС:

    sudo reboot

CentOS 7

  1. Скачайте подходящий пакет драйверов с официального сайта NVIDIA.

  2. Установите заголовочные файлы ядра:

    sudo yum -y install kernel-devel

  3. Установите метапакет Development Tools:

    sudo yum -y groupinstall "Development Tools"

  4. Отключите модуль Nouveau. В текстовом редакторе откройте файл /etc/default/grub, где добавьте к строке GRUB_CMDLINE_LINUX следующее:

    rd.driver.blacklist=nouveau nouveau.modeset=0

  5. Внесите модуль Nouveau в blacklist. В текстовом редакторе откройте (или создайте) файл /etc/modprobe.d/blacklist.conf, после чего добавьте в его конец строку:

    blacklist nouveau

  6. Обновите конфигурацию загрузчика, выполнив в Терминале команду:

    sudo grub2-mkconfig -o /boot/grub2/grub.cfg

  7. Обновите образ файловой системы, выполнив в Терминале команды:

    sudo mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r)-nouveau.img
    sudo dracut /boot/initramfs-$(uname -r).img $(uname -r)

  8. Если включен X server, отключите запуск графического интерфейса после перезагрузки:

    sudo systemctl isolate multi-user.target

  9. Перезапустите ОС:

    sudo reboot

  10. Перейдите в директорию с заранее скачанным пакетом драйверов.

  11. Предоставьте ранее скачанному пакету привилегии на выполнение:

    chmod a+x NVIDIA-Linux-x86_64-[версия_драйвера].run

    Где NVIDIA-Linux-x86_64-[версия_драйвера] — действительное имя пакета.

  12. Установите драйвера:

    sudo ./NVIDIA-Linux-x86_64-[версия_драйвера].run –kernel-source-path=/usr/src/kernels/{версия_ядра}

    Где NVIDIA-Linux-x86_64-[версия_драйвера] — действительное имя пакета, а {версия_ядра} — действительная версия ядра ОС.

  13. Повторно перезапустите ОС:

    sudo reboot

Macroscop Нейросети Standard для Linux поставляются в виде двух отдельных установочных пакетов:

  • macroscop-neural-networks-cpu — пакет нейросетей, предназначенный для выполнения анализа, используя только CPU.
  • macroscop-neural-networks-gpu — пакет нейросетей с возможностью использования GPU для выполнения анализа.

Доступный в репозитории пакет macroscop-neural-networks-gpu-optimized относится к набору Macroscop Нейросети Special. Это отдельный пакет нейросетей, установка которого не требуется при развёртывании пакета Macroscop Нейросети Standard.

Установка пакета Macroscop Нейросети Standard на Linux возможна в двух форматах:

  • Онлайн — установочный пакет запрашивается из репозитория Macroscop вместе со всеми пакетами зависимостей. Требует наличие на компьютере доступа к Интернету.
  • Оффлайн — установочный пакет необходимо самостоятельно загрузить заранее из репозитория Macroscop, пакеты зависимостей необходимо устанавливать вручную. Не требует наличие на компьютере доступа к Интернету.

Перед установкой пакета Macroscop Нейросети Standard убедитесь, что приложение Macroscop Сервер установлено на компьютере.

Установка онлайн

  1. Завершите работу приложения Macroscop Сервер:

    sudo systemctl stop macroscop

  2. Запустите установку нужного пакета нейросетей соответствующей командой:

    Astra Linux/Ubuntu/Debian, анализ только на CPU:

    sudo apt-get install macroscop-neural-networks-cpu

    Astra Linux/Ubuntu/Debian, анализ с использованием GPU:

    sudo apt-get install macroscop-neural-networks-gpu

    CentOS 7, анализ только на CPU:

    sudo yum install macroscop-neural-networks-cpu

    CentOS 7, анализ с использованием GPU:

    sudo yum install macroscop-neural-networks-gpu

  3. Дождитесь завершения установки.

  4. Возобновите работу приложения Macroscop Сервер:

    sudo systemctl start macroscop

Установка оффлайн

  1. Убедитесь, что все необходимые пакеты зависимостей установлены на компьютере:

    • 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

    В случае отсутствия или несоответствия версии пакета зависимости скачайте и установите недостающий пакет из репозитория.

    Astra Linux/Ubuntu/Debian:

    http://packages.macroscop.com/deb/public/pool/main/c/
    http://packages.macroscop.com/deb/public/pool/main/libc/
    http://packages.macroscop.com/deb/public/pool/main/libn/

    CentOS 7:

    http://packages.macroscop.com/rpm/

  2. Скачайте интересующий пакет нейросетей из репозитория.

    Astra Linux/Ubuntu/Debian, анализ только на CPU:

    http://packages.macroscop.com/deb/public/pool/main/m/macroscop-neural-networks-cpu/

    Astra Linux/Ubuntu/Debian, анализ с использованием GPU:

    http://packages.macroscop.com/deb/public/pool/main/m/macroscop-neural-networks-gpu/

    CentOS 7:

    http://packages.macroscop.com/rpm/

  3. Завершите работу приложения Macroscop Сервер:

    sudo systemctl stop macroscop

  4. Перейдите в директорию с ранее скачанным пакетом нейросетей и запустите установку.

    Astra Linux/Ubuntu/Debian:

    dpkg -i macroscop-neural-networks-[режим]_[версия]_amd64.deb

    CentOS 7:

    yum install macroscop-neural-networks-[режим]_[версия]_amd64.deb

    Где [режим] — режим анализа (cpu или gpu), а [версия] — актуальная версия пакета.

  5. Дождитесь завершения установки.

  6. Возобновите работу приложения Macroscop Сервер:

    sudo systemctl start macroscop