Проблемы установки

Ошибки при установке Мониторинга

Типовые ошибки и решения

Ошибка: «E: Невозможно исправить ошибки: У вас зафиксированы сломанные пакеты»

Причина: прерывание установки пакетов (например, выключение сервера во время установки).

Решение: обратитесь к документации ОС. Если не помогло — удалите и переустановите пакеты вручную.

Ошибка: «Timeout error. Check docker logs. Then restart the installation.»

Причина: неверно указана переменная MON_HOSTNAME.

Решение: проверьте корректность IP-адреса или доменного имени. Запустите установку повторно с верными значениями.

Конфликт адресов Docker (разрыв SSH после установки)

Причина: внутренняя сеть Docker (10.28.32.0/26) пересекается с адресным пространством инфраструктуры.

Решение: выделите другой пул адресов для Docker. Подробнее — см. страницу «Конфликт адресов Docker при установке».

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

Ошибки при установке ПринтМенеджера

Типовые ошибки и решения

Установка завершается с ошибкой при включённом шифровании

Причина: не указана переменная ENV_VAULT_PASSWORD.

Решение:

sudo ENV_VAULT_PASSWORD=<password> -E ./install.sh

ПМ не подключается к Мониторингу после установки

Проверьте:

E: Unable to acquire the dpkg frontend lock (/var/lib/dpkg/lock-frontend), is another process using it.

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

"msg": "An unexpected requests error occurred when docker-py tried to talk to the docker daemon: UnixHTTPConnectionPool(host='localhost', port=None): Read timed out. (read timeout=60)"

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

docker.errors.DockerException: Error while fetching server API version: UnixHTTPConnectionPool(host='localhost', port=None): Read timed out. (read timeout=60)

Ошибка Docker-а. Попробуйте повторить установку. Если со второго раза не помогает, перезагрузите весь сервер.

_rpm.error: package not installed

Выполните:

dnf update

и повторите установку.

Ошибка: проверка транзакции на разрешение зависимостей”, “Вероятно у вас повреждена RPMDB”

Такая ошибка может возникнуть в РедОС. Выполните обновление системных компонентов при помощи команд:

sudo yum update -y
sudo yum install rpm

и повторите установку.

AttributeError: module 'lib' has no attribute 'X509_V_FLAG_NOTIFY_POLICY'

Ошибка связана с неверной версией пакета python3-pyOpenSSL в системе RedOS. Выполните обновление системных компонентов при помощи команды:

dnf update

и повторите установку.

ERROR: Configuration for volume media specifies "o" driver_opt addr=10.0.10.10,nolock,soft,rw,nfsvers=4, but a volume with the same name uses a different "o" driver_opt (addr=10.0.132.44,nolock,soft,rw). If you wish to use the new configuration, please remove the existing volume "printmanager_media" first:

Выполните команду:

docker volume rm printmanager_media

Попробуйте запустить ПринтМенеджер еще раз.

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

Ошибки при установке Клиента ПМ на Windows

Ошибка: предупреждение о сертификате драйвера

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

Решение

Для проверки, запустите оснастку Windows certlm.msc и посмотрите раздел “Доверенные издатели”, внутри должен находиться сертификат “ООО Принтум”:

image348.png

Для проверки установленной цепочки сертификатов нажмите правой кнопкой мыши на сертификате - Открыть - Путь сертификации:

image41.png

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

Сертификаты с ошибкой необходимо установить в соответствующие разделы:

  1. Сертификат GlobalSign GCC R45 EV CodeSigning CA 2020 - в Промежуточные центры сертификации
  2. Сертификат GlobalSign Code Signing Root R45 - в Доверительные корневые центры сертификации. Если цепочка сертификатов не состоит из 3-х ступеней, то сертификаты необходимо установить вручную выполнив действия из пункта 1 и 2.

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

Конфликт адресов Docker при установке

Симптомы

Возможные причины

Конфликт IP-адресов между внутренней сетью Docker и реальной локальной сетью. Для работы Принтум используется внутренняя сеть Docker с пулом адресов:

10.28.32.0/26

Если данный диапазон пересекается с адресным пространством инфраструктуры — необходимо выделить другой пул адресов для Docker.

Когда может возникнуть проблема

Диагностика

Если подключение по SSH недоступно — подключитесь к серверу через консоль гипервизора (vSphere / Proxmox / Hyper-V и т.д.).

Логи и диагностические данные

Где смотреть логи

Что искать в логах

Что приложить к обращению в поддержку

Решение

  1. Остановите контейнеры Принтум

Если установлен Мониторинг:

cd /opt/printum
docker-compose down

Если установлен ПринтМенеджер:

cd /opt/printmanager
docker-compose down
  1. Проверьте наличие файла конфигурации Docker

Проверьте, существует ли файл /etc/docker/daemon.json. Если файла нет — создайте его:

sudo nano /etc/docker/daemon.json
  1. Укажите новый пул IP-адресов Docker

Добавьте или отредактируйте содержимое файла:

{
  "default-address-pools": [
    {
      "base": "x.x.x.x/x",
      "size": 26
    }
  ]
}

Используйте только свободный диапазон, согласованный с сетевым администратором. Сохраните файл и выйдите из редактора.

  1. Перезапустите службу Docker
sudo systemctl restart docker
  1. Запустите контейнеры Принтум

Если установлен Мониторинг:

cd /opt/printum
docker-compose up -d

Если установлен ПринтМенеджер:

cd /opt/printmanager
docker-compose up -d
  1. Проверьте адреса контейнеров
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 (остановку и повторный запуск контейнеров). Настройка пула выполняется до первого запуска системы.

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