Развёртывание приложения Macroscop Клиент на Linux с помощью Flatpak🔗

Примечание

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

Вся установка должна осуществляться под заранее созданным пользователем с правами администратора (используя sudo).

Без использования sudo Macroscop Клиент будет установлен только для текущего пользователя, при этом во время установки компонентов может быть запрошено повышение прав.

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

Примечание

Все команды по установке, обновлению и удалению приложения Macroscop Клиент необходимо выполнять в терминале.

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

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

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

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

Рекомендуемые среды рабочего стола: GNOME и KDE. При использовании MATE и оконного менеджера Marco могут некорректно работать модальные окна и выпадающие списки.

Установка актуальной версии Macroscop Клиент
  1. Установите Flatpak и добавьте Flatpak-репозиторий Macroscop:

    wget -O - https://packages.macroscop.com/flatpak/install/macroscop.sh | bash
    

    Примечание

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

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

    sudo flatpak install macroscop com.macroscop.client//latest
    
  3. После этого необходимо перезайти в графическую оболочку или перезагрузить ПК, чтобы в меню приложений появились ярлыки Macroscop Клиент.

Запуск приложений

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

../_images/flatpak-ubuntu.png ../_images/flatpak-rosa.png

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

../_images/flatpak-language.png

После этого начнётся инициализации приложения, которая может занят 5-10 минут.

Интерфейс приложений под Linux аналогичен интерфейсу этих приложений под Windows.

../_images/flatpak-example.png

Приложения можно запустить не только из меню приложений, но и из терминала:

Macroscop Клиент

flatpak run com.macroscop.client
Обновление минорной версии уже установленного приложения Macroscop Клиент

Для обновления минорной версии нужно выполнить следующую команду:

sudo flatpak update com.macroscop.client
Установка других версий Macroscop Клиент

Например, если вы хотите перейти с версии 4.1 на 4.2, то сначала нужно установить 4.2:

sudo flatpak install com.macroscop.client//4.2

а затем перейти на версию 4.2 с помощью команды:

sudo flatpak make-current com.macroscop.client//4.2

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

При запуске Macroscop Клиент снова произойдёт процесс инициализации, который займет 5-10 минут.

Увидеть список текущих версий Macroscop Клиент можно при помощи команды:

sudo flatpak remote-ls | grep macroscop
Удаление Macroscop Клиент

Для удаления используйте команду:

sudo flatpak uninstall com.macroscop.client
Автоматическое подключение Macroscop Клиент

Чтобы настроить автоматическое подключение Macroscop Клиент при запуске из ярлыка в меню приложений необходимо указать ip-адрес (или доменное имя) сервера, порт, имя пользователя и пароль в файле /var/lib/flatpak/app/com.macroscop.client/current/active/files/bin/runclient.sh после "${WINE}" "${CLIENTPATH}/${brand^}Client.exe"

Пример:

"${WINE}" "${CLIENTPATH}/${brand^}Client.exe" -server office.server.com -port 8080 -user root -password qwerty
../_images/flatpak-autostart.png

Для подключения по SSL необходимо указывать порт при помощи параметра -ssl-port вместо -port, а также использовать параметр -connectionprotocol со значением 1 для установки HTTPS-соединения. Место вставки параметра -connectionprotocol значения не имеет.

Пример:

"${WINE}" "${CLIENTPATH}/${brand^}Client.exe" -server office.server.com -sslport 18080 -connectionprotocol 1 -user root -password qwerty

При необходимости отключения проверки надежности SSL-сертификатов можно воспользоваться параметром -disablesslcertificatesvalidation.

Пример:

"${WINE}" "${CLIENTPATH}/${brand^}Client.exe" -server office.server.com -port 8081 -disablesslcertificatesvalidation -user root -password qwerty
Неподдерживаемые возможности
  • Электронная подпись экспортируемого видео и скриншотов.

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

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

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

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

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

  • Работа утилиты Локальный просмотр и резервное копирование архива.

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

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

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

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

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

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

Причина 1.1

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

Решение 1.1

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

Причина 1.2

Примечание

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

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

Решение 1.2

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

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

Причина

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

Решение 2.1

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

Решение 2.2

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

При установке появляется ошибка "GPG verification enabled, but no summary found (check that the configured URL in remote config is correct)"

Причина

Изменился мета-данные репозитория.

Решение 3.1

удалить flatpak-репозиторий Macroscop и добавить заново:

sudo flatpak remote-delete macroscop

wget -O - https://packages.macroscop.com/flatpak/install/macroscop.sh | bash

Примечание

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