Проблемы интеграций

Синхронизация Мониторинга и ПринтМенеджера не выполняется

Симптом

Изменения, сделанные в Мониторинге, не применяются на ПринтМенеджерах (пользователи, правила, принтеры не синхронизируются).

Как работает синхронизация

Мониторинг — центральный сервер, ПринтМенеджеры работают в подчинённом режиме. По умолчанию синхронизация выполняется 1 раз в час. Изменения вступают в силу не мгновенно.

Диагностика

Шаг 1. Проверить доступность ПринтМенеджера с Мониторингом

Шаг 2. Запустить синхронизацию вручную

Нажмите «Синхронизировать» в карточке нужного ПринтМенеджера или иконку синхронизации в таблице.

Шаг 3. Проверить Docker-контейнеры

cd /opt/printum && sudo docker-compose ps
cd /opt/printmanager && sudo docker-compose ps

Все контейнеры должны быть в статусе Up.

Связанные страницы

Ошибка подключения к почтовому серверу

Симптом

Уведомления не приходят по почте, тестовое письмо не отправляется, пользователи не могут восстановить пароль.

Диагностика

Шаг 1. Отправить тестовое письмо

Перейдите в Настройки → Интеграции → Почта. Введите адрес в поле «Почта для тестового письма» и нажмите «Отправить тестовое письмо».

Шаг 2. Проверить параметры подключения

Параметр Что проверить
SMTP-сервер Адрес доступен с сервера Мониторинга
Порт Порт открыт в firewall (25, 465, 587)
Логин/Пароль Учётные данные корректны
Адрес отправителя Должен совпадать с логином (требование большинства SMTP-серверов)
TLS/SSL Соответствует конфигурации сервера

Что проверить перед эскалацией

Связанные страницы

Лицензия истекла — что происходит и что делать

Симптомы

Что происходит при истечении лицензии

Годовые лицензии: после истечения срока ПО перестаёт функционировать. Необходимо срочное продление.

Бессрочные лицензии: включают 1 год гарантийной технической поддержки. После истечения поддержки система продолжает работать, но обновления и обращения в ТП становятся недоступны. Для восстановления поддержки — приобрести продление.

Примечание: Уведомления об истечении отправляются заблаговременно — реагировать нужно до истечения, а не после.

Что делать

Продлить лицензию по стандартной процедуре. Обратится на sales@printum.io

Важно про перерыв в продлении

Если продление оформлено с перерывом, новый срок технической поддержки исчисляется с момента окончания предыдущего периода — а не с даты оформления. То есть перерыв не «сдвигает» начало нового периода.

Как проверить результат

ЛК → Настройки → Общие → Организации: в списке лицензий отображается обновлённый срок действия.

Когда эскалировать

Обратиться напрямую: support@printum.io — указать название организации и идентификатор, а так же описать какие действия уже были проделаны.

Связанные страницы

Как обновить SSL-сертификаты Printum

Когда использовать

Основные приципы

Обновление сертификатов системы производится путём запуска обновления Мониторинга и ПринтМенеджера. При обновлении требуется указать переменные, содержащие ссылки на локальные файлы сертификатов:

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

Singlenode: обновление сертификатов Мониторинга

Офлайн метод:

tar xvf printum-x.x.x.tar.gz
cd printum-x.x.x
sudo -E SSL_CERT=/path/cert.crt \
       SSL_KEY=/path/cert.key \
       SSL_CERT_CA=/path/ca.crt ./install.sh

Онлайн метод:

sudo curl -L https://s3.printum.io/box/monitoring/install.sh | \
  sudo -E SSL_CERT=/path/cert.crt \
       SSL_KEY=/path/cert.key \
       SSL_CERT_CA=/path/ca.crt bash

Singlenode: обновление сертификатов ПринтМенеджер

Офлайн метод:

tar xvf printmanager-x.x.x.tar.gz
cd printmanager-x.x.x
sudo -E SSL_CERT=/path/cert.crt \
       SSL_KEY=/path/cert.key \
       SSL_CERT_CA=/path/ca.crt ./install.sh

Онлайн метод:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | \
  sudo -E SSL_CERT=/path/cert.crt \
       SSL_KEY=/path/cert.key \
       SSL_CERT_CA=/path/ca.crt bash

Балансировщик: обновление собственных сертификатов через скрипт автоматической установки

В файле config.ini обновить пути к новым сертификатам:

[General]
SSL_CERT_CA = /path/to/new/ca.crt

[Balancer]
SSL_CERT = /path/to/balancer/cert.crt
SSL_KEY  = /path/to/balancer/cert.key

[Monitoring]
SSL_CERT = /path/to/monitoring/cert.crt
SSL_KEY  = /path/to/monitoring/cert.key

[PrintManager_1]
SSL_CERT = /path/to/pm1/cert.crt
SSL_KEY  = /path/to/pm1/cert.key

# [PrintManager_2], [PrintManager_3] — аналогично

Запустить скрипт:

sudo ./install_all_offline.sh

Балансировщик: перевыпуск автоматических сертификатов для установки балансировщика вручную

Выполнять на сервере балансировщика раз в год:

# Удалить все сертификаты
sudo rm -fr /opt/printum_balancer/certificates

# Выпустить новый корневой сертификат
sudo /opt/printum_balancer/scripts/generate_ca_cert.sh

# Перевыпустить сертификаты для всех серверов
cd /opt/printum_balancer/scripts
sudo ./regenerate_all_certs.sh \
  -balancer <BALANCER_ADR> \
  -pm <PM_1> \
  -pm <PM_2> \
  -pm <PM_3>

Где <BALANCER_ADR>, <PM_1>, <PM_2>, <PM_3> — те же адреса, что использовались при первоначальной установке.

Проверка после обновления

# Проверить срок действия нового сертификата М
openssl s_client -connect <адрес_М>:8001 </dev/null 2>/dev/null \
  | openssl x509 -noout -dates

# Проверить синхронизацию М–ПМ
cd /opt/printmanager
sudo docker-compose logs printmanager-celery-print-queue --tail=50 | grep -i ssl

Ошибок SSL нет. Синхронизация завершается успешно.

Когда эскалировать

Связанные страницы