Вы можете включить предварительный просмотр файлов в Kopano WebApp без установки отдельного пакета «FileViewer» в описанной конфигурации, но MDM — это отдельный плагин, который необходимо установить и подключить к Z-Push. Это различие важно: в руководстве администратора WebApp предварительный просмотр описывается через ENABLE_FILE_PREVIEWER, а в руководстве MDM — через отдельный пакет, файл конфигурации и зависимости. Установка неправильного дополнения «Files» не включит предварительный просмотр.
Это руководство предназначено для администраторов существующей системы развертывания веб-приложения Kopano. Опубликованные Kopano руководства по веб-приложениям и MDM являются документацией устаревшей версии, поэтому перед внесением изменений в рабочую среду убедитесь, что имена пакетов и настройки точно соответствуют версиям веб-приложения, PHP, Z-Push и операционной системы, которые вы используете. Ниже описаны шаги, описывающие указанный путь и способы его безопасной проверки.
Используйте встроенную настройку предварительного просмотра файлов, когда пользователям необходимо просмотреть поддерживаемые вложения файлов в веб-приложении. Документированная административная опция — это ENABLE_FILE_PREVIEWER[название опции]; она определяет, предлагается ли пользователям настройка предварительного просмотра. В руководстве по веб-приложению это не описывается как отдельный пакет FileViewer, устанавливаемый с помощью менеджера пакетов.
Kopano Files отличается. Он добавляет область «Файлы» для просмотра и управления учетными записями внешнего хранилища, такими как WebDAV или другие настроенные бэкэнды. Для его использования могут потребоваться отдельные пакеты и конфигурация бэкэнда. Если ваша цель — предварительный просмотр вложений, начните с настроек предварительного просмотра, а не с Kopano Files. Если цель — подключение общего хранилища к веб-приложению, следуйте отдельному руководству по Files, ссылка на которое приведена в конце.
Плагин управления мобильными устройствами Kopano предоставляет информацию и возможности для мобильных устройств, синхронизирующихся с Kopano через Z-Push. В зависимости от развертывания, пользователи могут просматривать сведения об устройстве и выполнять такие действия, как повторная синхронизация, удаление, обновление или очистка. Это полезно, когда пользователям или администраторам необходимы такие элементы управления устройствами в веб-приложении; он не заменяет Z-Push и сам по себе не обеспечивает синхронизацию мобильных устройств.
В руководстве Kopano MDM в качестве зависимостей указаны Z-Push 2.0 или выше и поддержка PHP SOAP. Если Z-Push работает на другом хосте, отличном от WebApp, конфигурация MDM должна указывать на этот сервер Z-Push. Перед установкой чего-либо убедитесь в совместимости конечной точки Z-Push, установленной среды выполнения PHP и пакетов с вашей средой.
Сначала найдите активное веб-приложение, config.phpиспользуемое вашей установкой. При развертывании на основе пакетов оно обычно находится в папке /etc/kopano/webapp/, но контейнеры и пользовательские установки могут монтировать конфигурацию в другом месте. Перед редактированием сделайте резервную копию самого файла и избегайте создания второго определения, если параметр уже существует.
В активной конфигурации найдите ENABLE_FILE_PREVIEWER. В руководстве администратора веб-приложения Kopano указано true, что пользователям доступна опция включения предварительного просмотра файлов в настройках, а falseтакже что эта опция скрыта, и предварительный просмотр отключен для всех пользователей. Например:
define("ENABLE_FILE_PREVIEWER", true);Если такая строка уже существует, измените её значение, а не добавляйте дубликат define(). Сохраняйте окружающий синтаксис PHP без изменений. Если такой строки нет, используйте шаблон или руководство по настройке, соответствующее установленному пакету веб-приложения, вместо того, чтобы копировать весь пример конфигурации в рабочий файл.
После сохранения проверьте наличие синтаксических ошибок PHP, используя интерпретатор PHP, обслуживающий веб-приложение. Например, если файл конфигурации находится по стандартному пути пакета:
php -l /etc/kopano/webapp/config.phpПроверка синтаксиса подтверждает только корректность PHP-кода; она не подтверждает загрузку параметра работающим сайтом. Войдите в систему как тестовый пользователь, откройте настройки веб-приложения и убедитесь, что опция предварительного просмотра файлов доступна. Включите её, примените изменения, а затем откройте вложение того типа, который поддерживает ваше веб-приложение. Если элемент управления отсутствует, убедитесь, что вы отредактировали активную конфигурацию, что плагины и настройки веб-приложения доступны и что обновление пакета или монтирование контейнера не предоставляет другой файл конфигурации.
Используйте пакет MDM, собранный для того же выпуска и дистрибутива Kopano WebApp, что и сервер. В руководстве по Kopano MDM описан пакет семейства Debian с именем kopano-webapp-plugins-mdmи пакет RPM для дистрибутивов на основе RPM. Ниже показана схема установки Debian; замените заполнитель на реальную версию пакета, полученную из вашего надежного, совместимого источника пакетов:
sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.debНе следует вводить заполнитель в угловых скобках буквально. Если при установке пакета сообщается о неразрешенных зависимостях, используйте стандартный процесс управления пакетами вашего дистрибутива для их разрешения из доверенных репозиториев, а затем убедитесь, что установленный пакет MDM и версия веб-приложения предназначены для совместной работы. Избегайте загрузки случайной сборки пакета или смешивания релизов для удовлетворения зависимости.
Убедитесь, что расширение PHP SOAP включено в среде PHP, используемой веб-приложением. Быстрая проверка:
php -m | grep -i '^soap$'Если вывод отсутствует, установите и включите расширение SOAP, соответствующее версии PHP и среде выполнения веб-сервера, используемой веб-приложением. Проверка PHP через командную строку может отличаться от проверки PHP-FPM или модуля PHP Apache, поэтому сравните конфигурацию веб-сервера, если команда показывает наличие SOAP, но MDM по-прежнему сообщает об отсутствии функции SOAP.
В опубликованном руководстве по MDM настройки указаны в файле /etc/kopano/webapp/config-mdm.php. Создайте резервную копию этого файла, затем проверьте указанные в нем параметры:
PLUGIN_MDM_USER_DEFAULT_ENABLE_MDMЭтот параметр определяет, включен ли плагин по умолчанию для пользователей; в руководстве указано значение по умолчанию как false.PLUGIN_MDM_SERVERОпределяет сервер Z-Push; значение по умолчанию, указанное в документации, — localhost.PLUGIN_MDM_SERVER_SSLЭтот параметр следует установить, trueесли соединение использует SSL/TLS; значение по умолчанию, указанное в документации, — false.Если WebApp и Z-Push находятся на разных хостах, замените настройку сервера по умолчанию на фактическое местоположение Z-Push, необходимое для вашей конфигурации. Используйте правильный протокол и имя хоста, а также включите опцию SSL, если эта конечная точка использует HTTPS. Не делайте конечную точку общедоступной только для того, чтобы плагин отвечал; обеспечьте ее доступность по указанному сетевому пути и с действительным сертификатом. Сохраните синтаксис PHP, используемый в установленном файле.
Настройки по умолчанию не обязательно являются правильным выбором для каждой организации. Вы можете разрешить пользователям включать MDM самостоятельно или включить его по умолчанию, если это позволяет ваша политика. Если конфигурация вашего веб-приложения глобально отключает плагины или блокирует плагин MDM, сначала урегулируйте эту центральную настройку; изменение только настроек по умолчанию для MDM не отменит плагин, явно отключенный на уровне веб-приложения.
После установки и настройки пакета войдите в WebApp и откройте «Настройки», затем вкладку «Плагины». Выберите MDM и примените изменения. В руководстве по MDM указано, что обзор устройств отображается на отдельной вкладке MDM в «Настройках» и включает информацию об устройстве, дату последней синхронизации и идентификатор устройства. Если плагин отсутствует в списке, сначала убедитесь, что файлы пакета установлены в активном каталоге плагинов WebApp и что глобальные настройки плагина не скрывают и не отключают его.
Проведите тестирование с учетной записью, в которой уже синхронизируется устройство через Z-Push. Если список устройств пуст, проверьте, есть ли в этой учетной записи устройство Z-Push, указывает ли настройка MDM-сервера на правильную службу Z-Push и доступен ли PHP SOAP для процесса веб-приложения. Перед изменением несвязанных настроек сервера просмотрите журналы веб-приложения и Z-Push, относящиеся к тестовому запросу.
Рассматривайте действия MDM как элементы управления процессом, а не как безобидные кнопки обновления. В руководстве по MDM от Kopano предупреждается, что Wipe удаляет все данные с устройства, и рекомендуется проявлять осторожность. Протестируйте интерфейс на некритичном устройстве и ознакомьтесь с процессом восстановления в организации, прежде чем предоставлять Wipe пользователям. Перед запуском подтвердите идентификатор целевого устройства и пользователя.
Удаление также имеет последствия: в руководстве отмечается, что удаление устройства из списка означает, что пользователю необходимо удалить и повторно подключить учетную запись на телефоне, чтобы оно снова появилось. Повторная синхронизация запрашивает еще одну синхронизацию; обновление обновляет отображаемый список устройств. Не используйте функцию «Очистка» в качестве общего шага по устранению неполадок для устройства, которое просто медленно синхронизируется.
Для предварительного просмотра файлов убедитесь, что пользователь может видеть и включить эту настройку, а затем откройте поддерживаемое вложение, не загружая его предварительно. Для MDM убедитесь, что тестовый пользователь может видеть ожидаемую информацию об устройстве и что сведения о последней синхронизации соответствуют устройству, которое, как известно, синхронизируется через Z-Push. Сначала протестируйте действия с меньшим риском, такие как «Обновить» или «Повторно синхронизировать». Оставьте функцию «Очистка» отключенной или ограниченной в соответствии с политикой вашей организации, пока не подтвердите ее влияние.
Если элементы управления предварительного просмотра отсутствуют, перепроверьте активную конфигурацию веб-приложения и пользовательские настройки. Если MDM отсутствует или не отображает устройства, проверьте совместимость пакетов, PHP SOAP, путь к конфигурации MDM, хост Z-Push и глобальные ограничения плагинов. В опубликованных руководствах Kopano описаны названия параметров и шаблоны пакетов, но они не гарантируют совместимость со всеми текущими дистрибутивами и версиями PHP; используйте документацию по пакетам для конкретной сборки сервера в качестве окончательного источника информации.
Диагностика скачков загрузки ЦП в браузере Jitsi Meet и снижение нагрузки на клиентское приложение путем проверки видеофайлов, эффектов камеры, графики браузера и настроек хоста.
Отслеживайте состояние Jitsi Videobridge, загрузку конференций и трафик с помощью встроенной точки доступа Prometheus, а затем анализируйте и отображайте данные в виде графиков в Grafana.
Настройте собственный домен для Jitsi Meet Docker с указанием DNS, PUBLIC_URL, HTTPS, Let's Encrypt, портов брандмауэра, настроек NAT и сквозной проверки.
Fix Zimbra Admin Console 404 errors after SSL renewal by checking the correct URL and port, proxy routing, service status, deployed certificates, and logs.
Узнайте, как диагностировать и устранять предупреждение Nextcloud о конфигурации PHP OPcache, проверив активные параметры PHP SAPI, ограничения размера, комментарии и настройки повторной проверки.
Для устранения неполадок, возникающих при миграции базы данных Kopano после обновления MySQL или MariaDB, проверьте резервные копии, версии серверов, режимы SQL, кодировку, состояние схемы и журналы.
Подключите Nextcloud к LDAP или Active Directory с помощью защищенного канала связи, фильтров пользователей и групп, атрибутов входа в систему и проверенной процедуры развертывания.
Исправление проблем с уведомлениями Element Android на телефонах без привязки к Google путем настройки UnifiedPush, разрешений Android, параметров батареи и надежных тестов проверки.
Удалите предупреждение Nextcloud об отсутствии индексов в базе данных с помощью официальной команды occ. Сначала сделайте резервную копию, просмотрите изменения, выполните восстановление и проверьте результат.
Настройте единый вход Keycloak для Element Web, подключив OIDC к Synapse, задав точный URL-адрес обратного вызова, сопоставив данные пользователя и протестировав выход из системы.
