Развёртывание приложения Macroscop Клиент на Linux

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

В процессе установки необходимо обеспечить доступ компьютеру к интернету.

Примечание

Приложение Macroscop Клиент для Linux можно устанавливать на Astra Linux Common Edition релиз «Орел» (начиная с версии 2.12.43). Инструкции по установке на другие ОС приведены в качестве примера, работа приложения на них не гарантируется.

Для работы приложения выбранная ОС должна иметь графическую оболочку.

Все действия в процессе установки, обновления и удаления приложения должны осуществляться только из графического интерфейса системы и под заранее созданным пользователем с правами администратора, в терминале с применением команды sudo.

Примечание

Оставить пожелания или сообщить о проблемах можно по адресу support@macroscop.com.

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

Astra Linux Common Edition

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

• Astra Linux Common Edition 2.12

Установка актуальной версии

1. Добавьте репозиторий Macroscop:

   wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-astra-ce-2.12.sh | bash
   

2. Установите приложение Macroscop Клиент:

   apt-get install macroscop-client
   

Примечание

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

Обновление с версии 4.1

Для обновления приложения Macroscop Клиент с версии 4.1 до последующей достаточно повторить шаги по добавлению репозитория Macroscop и установке приложения из инструкции для выбранной операционной системы.

Удаление

1. Удалите Macroscop Клиент:

   apt-get remove macroscop-client
   

2. Удалите Wine:

   apt-get remove macroscop-wine
   

3. Удалите окружение Wine:

   rm -rf /home/USER/.macroscopclient
   

   Где:

   • USER: Пользователь ОС, для которого устанавливалось приложение.

   Примечание

   При удалении окружения Wine также удалятся все ранее сделанные настройки приложения. Чтобы этого избежать, перед удалением окружения сохраните копию содержимого директории ~/.macroscopclient/drive_c/users/$USER/AppData/Local/Macroscop. После установки актуальной версии приложения разместите скопированные файлы по тому же пути.

Astra Linux Special Edition

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

• Astra Linux Special Edition 1.7

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

Приложение Macroscop Сервер работает на Astra Linux Special Edition 1.7 в режимах защиты «Орёл», «Воронеж» и «Смоленск». Обратите внимание, что Macroscop не будет работать при включённой ЗПС (Замкнутой программной среде), а при использовании МРД (Мандатное управление доступом) и МКЦ (Мандатный контроль целостности) его работа может быть некорректной!

Установка актуальной версии

1. Добавьте репозиторий Macroscop:

   wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-astra-se-1.7.sh | bash
   

2. Установите приложение Macroscop Клиент:

   apt-get install macroscop-client
   

Примечание

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

Обновление с версии 4.1

Для обновления приложения Macroscop Клиент с версии 4.1 до последующей достаточно повторить шаги по добавлению репозитория Macroscop и установке приложения из инструкции для выбранной операционной системы.

Удаление

1. Удалите Macroscop Клиент:

   apt-get remove macroscop-client
   

2. Удалите Wine:

   apt-get remove macroscop-wine
   

3. Удалите окружение Wine:

   rm -rf /home/USER/.macroscopclient
   

   Где:

   • USER: Пользователь ОС, для которого устанавливалось приложение.

   Примечание

   При удалении окружения Wine также удалятся все ранее сделанные настройки приложения. Чтобы этого избежать, перед удалением окружения сохраните копию содержимого директории ~/.macroscopclient/drive_c/users/$USER/AppData/Local/Macroscop. После установки актуальной версии приложения разместите скопированные файлы по тому же пути.

ALT Linux

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

• ALT Linux Workstation 10

• ALT Linux Workstation 10.1

Установка актуальной версии

1. Добавьте репозиторий Macroscop:

   wget -O - https://packages.macroscop.com/rpm/install/macroscop-deps-altlinux.sh | bash
   

2. Установите приложение Macroscop Клиент:

   apt-get install macroscop-client
   

Примечание

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

Обновление с версии 4.1

Для обновления приложения Macroscop Клиент с версии 4.1 до последующей достаточно повторить шаги по добавлению репозитория Macroscop и установке приложения из инструкции для выбранной операционной системы.

Удаление

1. Удалите Macroscop Клиент:

   apt-get remove macroscop-client
   

2. Удалите Wine:

   apt-get remove macroscop-wine
   

3. Удалите окружение Wine:

   rm -rf /home/USER/.macroscopclient
   

   Где:

   • USER: Пользователь ОС, для которого устанавливалось приложение.

   Примечание

   При удалении окружения Wine также удалятся все ранее сделанные настройки приложения. Чтобы этого избежать, перед удалением окружения сохраните копию содержимого директории ~/.macroscopclient/drive_c/users/$USER/AppData/Local/Macroscop. После установки актуальной версии приложения разместите скопированные файлы по тому же пути.

РЕД ОС

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

• РЕД ОС 7.3

• РЕД ОС 8

Установка актуальной версии

1. Если на устройстве установлены сторонние версии Wine и Winetricks, перед началом установки приложения Macroscop Клиент удалите их:

   yum remove 'wine*'
   

2. Добавьте репозиторий Macroscop:

   wget -O - https://packages.macroscop.com/rpm/install/macroscop-deps-redos.sh | bash
   

3. Установите приложение Macroscop Клиент:

   yum install macroscop-client
   

Примечание

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

Обновление с версии 4.1

Для обновления приложения Macroscop Клиент с версии 4.1 до последующей достаточно повторить шаги по добавлению репозитория Macroscop и установке приложения из инструкции для выбранной операционной системы.

Удаление

1. Удалите Macroscop Клиент:

   yum remove macroscop-client
   

2. Удалите Wine:

   yum remove macroscop-wine
   

3. Удалите окружение Wine:

   rm -rf /home/USER/.macroscopclient
   

   Где:

   • USER: Пользователь ОС, для которого устанавливалось приложение.

   Примечание

   При удалении окружения Wine также удалятся все ранее сделанные настройки приложения. Чтобы этого избежать, перед удалением окружения сохраните копию содержимого директории ~/.macroscopclient/drive_c/users/$USER/AppData/Local/Macroscop. После установки актуальной версии приложения разместите скопированные файлы по тому же пути.

Ubuntu

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

• Ubuntu 20.04

Установка актуальной версии

1. Если на устройстве установлены сторонние версии Wine и Winetricks, перед началом установки приложения Macroscop Клиент удалите их:

   apt-get remove 'wine*'
   

2. Добавьте репозиторий Macroscop:

   wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-ubuntu.sh | bash
   

3. Установите приложение Macroscop Клиент:

   apt-get install macroscop-client
   

Примечание

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

Обновление с версии 4.1

Для обновления приложения Macroscop Клиент с версии 4.1 до последующей достаточно повторить шаги по добавлению репозитория Macroscop и установке приложения из инструкции для выбранной операционной системы.

Удаление

1. Удалите Macroscop Клиент:

   apt-get remove macroscop-client
   

2. Удалите Wine:

   apt-get remove macroscop-wine
   

3. Удалите окружение Wine:

   rm -rf /home/USER/.macroscopclient
   

   Где:

   • USER: Пользователь ОС, для которого устанавливалось приложение.

   Примечание

   При удалении окружения Wine также удалятся все ранее сделанные настройки приложения. Чтобы этого избежать, перед удалением окружения сохраните копию содержимого директории ~/.macroscopclient/drive_c/users/$USER/AppData/Local/Macroscop. После установки актуальной версии приложения разместите скопированные файлы по тому же пути.

Запуск

Примечание

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

Примечание

В РЕД ОС и Ubuntu, прежде чем использовать созданные на рабочем столе ярлыки для запуска приложений, требуется разрешить их запуск. Сделать это можно через контекстное меню, открывающееся по нажатию ПКМ на ярлык.

По окончании установки можно будет запускать приложения Macroscop Клиент, Macroscop Конфигуратор и Macroscop Проигрыватель с рабочего стола или из списка приложений.

Примечание

В РЕД ОС и Ubuntu, прежде чем использовать созданные на рабочем столе ярлыки для запуска приложений, требуется разрешить их запуск. Сделать это можно через контекстное меню, открывающееся по нажатию ПКМ на ярлык.

Внешний вид приложений аналогичен этим же приложениям под Windows.

Также приложения можно запустить через терминал:

Macroscop Клиент:

env WINEPREFIX="/home/$USER/.macroscopclient" wine C:\\\\users\\\\$USER\\\\MacroscopClient\\\\MacroscopClient.exe

Macroscop Конфигуратор:

env WINEPREFIX="/home/$USER/.macroscopclient" wine C:\\\\users\\\\$USER\\\\MacroscopClient\\\\MacroscopConfigurator.exe

Macroscop Проигрыватель:

env WINEPREFIX="/home/$USER/.macroscopclient" wine C:\\\\users\\\\$USER\\\\MacroscopClient\\\\MacroscopPlayer.exe

Неподдерживаемые функции

• Электронная подпись экспортируемого видео и скриншотов.

• Автообновление клиентского приложения.

• Сквозная авторизация через Active Directory.

• Отображение видео в области обзора камеры на картах и планах.

• Отображение тепловых карт на планах.

• Автоматическое открытие экспортированного видеоролика.

• Автоматический поиск архивных директорий с помощью приложения Локальный просмотр и резервное копирование архива.

Требования, ограничения, рекомендации

• Macroscop Клиент официально поддерживает только Astra Linux Common Edition 2.12. Работа приложения на других ОС не гарантируется.

• При использовании Astra Linux Special Edition необходимо отключить Замкнутую программную среду в настройках ОС.

• Macroscop Клиент использует собственную версию Wine, несовместимую с другими версиями из сторонних репозиториев.

• Не рекомендуется использовать в качестве графической оболочки MATE с оконным менеджером marco из-за особенностей поведения этой комбинации. При запуске приложения Macroscop Клиент в полноэкранном режиме основное окно с ячейками камер по умолчанию всегда располагается поверх других окон (например, экспорта архива или настроек приложения). В качестве альтернативного решения рекомендуется использовать графическую оболочку cinnamon.

• При использовании для отображения видеокарт NVIDIA рекомендуется использовать проприетарные драйвера не ниже версии 470.

• Для PTZ-пультов поддерживается подключение только по USB. Работа пультов, подключенных иными способами, не гарантируется.

• При установке приложения на РЕД ОС возможно изменение внешнего вида сторонних приложений в связи с изменением настроек оконного менеджера ОС, необходимым для корректной работы приложения.

• Чтобы иметь возможность запускать приложения с помощью ярлыков на рабочем столе на РЕД ОС, необходимо сперва разрешить их запуск в свойствах.

Устранение неполадок

Проблема 1

Macroscop Клиент не устанавливается или не запускается без отображения каких-либо ошибок.

Причина 1.1

Установка не была завершена.

Решение 1.1

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

Причина 1.2

Конфликт приложений.

Решение 1.2

Убедитесь, что на устройстве установлен только macroscop-wine и нет других версий Wine из сторонних репозиториев.

Причина 1.3

Примечание

Только для Astra Linux.

На устройстве настроена Замкнутая программная среда.

Решение 1.3

Отключите её и перезагрузите устройство. В некоторых случаях может потребоваться переустановка приложения после отключения ЗПС.

Проблема 2

Macroscop Клиент не запускается с ошибкой GLXBadFBConfig.

Error of failed request: GLXBadFBConfig

Major opcode of failed request: 153 (GLX)

Minor opcode of failed request: 0 ()

Serial number of failed request: 1602

Current serial number in output stream: 1602

Причина 2

Wine не удаётся инициализировать OpenGL.

Решение 2

Перед запуском установите переменную среды:

export MESA_GL_VERSION_OVERRIDE=4.5

Проблема 3

Macroscop Клиент не запускается с ошибкой XVidMode.

Причина 3

Wine не удаётся инициализировать кодек XVid.

Решение 3

Отключите использование кодека, изменив параметр UseXVidMode:

WINEPREFIX="/home/$USER/.macroscopclient" wine reg.exe ADD "HKEY_CURRENT_USER\\Software\\Wine\\X11 Driver" "/v" "UseXVidMode" "/t" "REG_SZ" "/d" "N"'

Проблема 4

Не удаётся проверить сертификат при установке лицензии или попытке подключения к серверу по https.

Причина 4

Возникло несоответствие установленных сертификатов или в настоящий момент невозможно убедиться в их подлинности.

Решение 4

Отключите проверку сертификатов, добавив в команду запуска ключ -disablesslcertificatesvalidation.

Проблема 5

Второстепенные окна приложения (Экспорт архива, Настройки приложения и т.д.) не открываются или открываются в фоновом режиме.

Причина 5

Используется комбинация графической оболочки MATE с оконным менеджером marco, с которой приложения в полноэкранном режиме всегда размещаются поверх других окон.

Решение 5.1

Переключитесь на нужное окно с помощью комбинации клавиш Alt+Tab.

Решение 5.2

Смените графическую оболочку MATE на другую. Например, на cinnamon.