Установка пакета Macroscop Нейросети Standard

Предупреждение

Если используется модуль Распознавание лиц (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

• РЕД ОС 7.3

Работоспособность, в особенности анализ на 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 CE

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

Astra Linux SE

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

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

Поддерживаемые дистрибутивы:

• 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. Перезапустите ОС:

   sudo reboot
   

9. Если включен X server (графический интерфейс), то отключите его через терминал:

   sudo init 3
   

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
    

РЕД ОС

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

Установка пакета нейросетей

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:

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

   CentOS 7:

   https://packages.macroscop.com/rpm/
   

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

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

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

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

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

   CentOS 7:

   https://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