Проблемы установки Ошибки при установке Мониторинга Типовые ошибки и решения Ошибка: «E: Невозможно исправить ошибки: У вас зафиксированы сломанные пакеты» Причина: прерывание установки пакетов (например, выключение сервера во время установки). Решение: обратитесь к документации ОС. Если не помогло — удалите и переустановите пакеты вручную. Ошибка: «Timeout error. Check docker logs. Then restart the installation.» Причина: неверно указана переменная MON_HOSTNAME . Решение: проверьте корректность IP-адреса или доменного имени. Запустите установку повторно с верными значениями. Конфликт адресов Docker (разрыв SSH после установки) Причина: внутренняя сеть Docker ( 10.28.32.0/26 ) пересекается с адресным пространством инфраструктуры. Решение: выделите другой пул адресов для Docker. Подробнее — см. страницу «Конфликт адресов Docker при установке». Логи и диагностические данные Где смотреть логи printum_nginx — HTTP-сервер и обратный прокси — первый контейнер, запускаемый при старте cd /opt/printum && docker-compose logs -f --tail=200 printum_nginx printum_backend — API мониторинга — основной контейнер приложения cd /opt/printum && docker-compose logs -f --tail=200 printum_backend Что искать в логах Выявить ошибки запуска контейнеров при установке. Выявить коды ошибок при инициализации приложения. Определить, на каком этапе запуска происходит сбой. Что приложить к обращению в поддержку Вывод команды bash /opt/printum/logs.sh Версию: cat /opt/printum/.version Описание сценария и шагов воспроизведения ОС сервера Диагностика через Docker logs cd /opt/printum sudo docker-compose logs --tail=100 Связанные страницы Конфликт адресов Docker при установке Ошибки при установке ПринтМенеджера Ошибки при установке ПринтМенеджера Типовые ошибки и решения Установка завершается с ошибкой при включённом шифровании Причина: не указана переменная ENV_VAULT_PASSWORD . Решение: sudo ENV_VAULT_PASSWORD= -E ./install.sh ПринтМенеджер не подключается к Мониторингу после установки Проверьте: Адрес Мониторинга доступен с сервера ПринтМенеджер. Порты 8000, 8001 открыты в firewall. Сертификаты сервера актуальны. Диагностика cd /opt/printmanager sudo docker-compose logs --tail=100 sudo docker-compose ps Логи и диагностические данные Где смотреть логи printmanager_web — Nginx ПринтМенеджера — первый контейнер, запускаемый при старте cd /opt/printmanager && docker-compose logs -f --tail=200 printmanager_web printmanager-app — Основной контейнер ПринтМенеджер — проверка подключения к Мониторингу при старте cd /opt/printmanager && docker-compose logs -f --tail=200 printmanager-app Что искать в логах Выявить ошибки запуска контейнеров при установке. Выявить ошибки подключения к Мониторингу. Определить, на каком этапе запуска происходит сбой. Что приложить к обращению в поддержку Вывод команды bash /opt/printmanager/logs.sh Версию: cat /opt/printmanager/.version Описание сценария и шагов воспроизведения ОС сервера Связанные страницы Ошибки при установке Мониторинга Конфликт адресов Docker при установке Ошибки при установке Клиента ПМ на Windows Симптом При установке клиента ПринтМенеджер на Windows появляется предупреждение о сертификате или установка завершается с ошибкой. Ошибка: предупреждение о сертификате драйвера Диагностика Запустите оснастку certlm.msc . Проверьте раздел «Доверенные издатели» — должен присутствовать сертификат «ООО Принтум» . Нажмите ПКМ на сертификате → Открыть → Путь сертификации . Цепочка должна состоять из 3 ступеней. Сертификаты с ошибкой помечены жёлтым/красным. Решение GlobalSign GCC R45 EV CodeSigning CA 2020 → установить в Промежуточные центры сертификации . GlobalSign Code Signing Root R45 → установить в Доверенные корневые центры сертификации . Ошибка при пробной печати: «Невозможно завершить операцию (ошибка 0x00000077)» Причина: проблема обновления Windows 10/11. Решение вне системы Printum — обратитесь к системному администратору. Логи и диагностические данные Где смотреть логи Клиент ПМ Windows — Установка и запуск службы на ОС Windows Логи установки: C:\Program Files\printum\service_install_*.log , driver_install_*.log Логи работы службы: eventvwr → Журналы Windows → Приложение → источник Print Manager Client Что искать в логах Выявить ошибки запуска службы клиента ПМ после установки. Выявить ошибки установки драйвера. Что приложить к обращению в поддержку Логи клиента ПМ: Windows — Просмотр событий ( eventvwr ) → Журналы Windows → Приложение → источник Print Manager Client ; Linux — sudo journalctl -u printum-printmanager-client.service Версию ПринтМенеджера: cat /opt/printmanager/.version Описание сценария и шагов воспроизведения ОС рабочей станции и сервера Связанные страницы Ошибка сертификата при установке Клиента ПМ Принтеры не появляются на рабочей станции Конфликт адресов Docker при установке Симптомы После установки системы Принтум происходит разрыв соединения с сервером. Подключение по SSH становится недоступным сразу после установки или при первом запуске контейнеров. Возможные причины Конфликт IP-адресов между внутренней сетью Docker и реальной локальной сетью. Для работы Принтум используется внутренняя сеть Docker с пулом адресов: 10.28.32.0/26 Если данный диапазон пересекается с адресным пространством инфраструктуры — необходимо выделить другой пул адресов для Docker. Когда может возникнуть проблема Во время установки системы. Сразу после установки. При первом запуске контейнеров. Диагностика Если подключение по SSH недоступно — подключитесь к серверу через консоль гипервизора (vSphere / Proxmox / Hyper-V и т.д.). Логи и диагностические данные Где смотреть логи printum_nginx — Nginx Мониторинга — если конфликт возник при установке Мониторинга cd /opt/printum && docker-compose logs -f --tail=200 printum_nginx printmanager_web — Nginx ПринтМенеджера — если конфликт возник при установке ПринтМенеджер cd /opt/printmanager && docker-compose logs -f --tail=200 printmanager_web Что искать в логах Выявить ошибки запуска контейнеров после изменения пула адресов. Проверить, что контейнеры успешно запустились после перенастройки сети Docker. Что приложить к обращению в поддержку Вывод команды bash /opt/printum/logs.sh (Мониторинг) или bash /opt/printmanager/logs.sh (ПринтМенеджер) Версию: cat /opt/printum/.version или cat /opt/printmanager/.version Описание сценария и шагов воспроизведения ОС сервера Решение Остановите контейнеры Принтум Если установлен Мониторинг: cd /opt/printum docker-compose down Если установлен ПринтМенеджер: cd /opt/printmanager docker-compose down Проверьте наличие файла конфигурации Docker Проверьте, существует ли файл /etc/docker/daemon.json . Если файла нет — создайте его: sudo nano /etc/docker/daemon.json Укажите новый пул IP-адресов Docker Добавьте или отредактируйте содержимое файла: { "default-address-pools": [ { "base": "x.x.x.x/x", "size": 26 } ] } "base" — выделенный диапазон IP-адресов, который не пересекается с локальной сетью. "size": 26 — размер подсети (изменять не требуется). Используйте только свободный диапазон, согласованный с сетевым администратором. Сохраните файл и выйдите из редактора. Перезапустите службу Docker sudo systemctl restart docker Запустите контейнеры Принтум Если установлен Мониторинг: cd /opt/printum docker-compose up -d Если установлен ПринтМенеджер: cd /opt/printmanager docker-compose up -d Проверьте адреса контейнеров sudo docker ps -q | sudo xargs -n 1 docker inspect -f '{{ .Name }}: {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' Ошибка при запуске контейнеров ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network Причина: выбранный диапазон адресов также пересекается с существующими сетями. Решение: вернитесь к шагу 3 и укажите другой диапазон IP-адресов. Если конфликт известен до установки Если известно, что адресное пространство 10.28.32.0/26 конфликтует с вашей сетью до установки системы — выполните инструкцию, игнорируя шаги 1 и 5 (остановку и повторный запуск контейнеров). Настройка пула выполняется до первого запуска системы. Что проверить перед эскалацией Выбранный диапазон не пересекается с другими подсетями (проверить с сетевым администратором). Файл /etc/docker/daemon.json сохранён корректно (валидный JSON). Служба Docker перезапущена после изменения конфигурации. IP-адреса контейнеров принадлежат новому пулу (шаг 6).