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

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

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

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

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

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

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

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

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

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

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

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


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

- [Конфликт адресов Docker при установке](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/konflikt-adresov-docker-pri-ustanovke-lBz)
- [Ошибки при установке ПринтМенеджера](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/osibki-pri-ustanovke-printmenedzera)

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

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

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

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

**Решение:**

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

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

**Проверьте:**

- Адрес Мониторинга доступен с сервера ПМ.
- Порты 8000, 8001 открыты в firewall.
- Сертификаты сервера актуальны.

### 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

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


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

- [Ошибки при установке Мониторинга](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/osibki-pri-ustanovke-monitoringa)
- [Конфликт адресов Docker при установке](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/konflikt-adresov-docker-pri-ustanovke-lBz)

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

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

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

### Решение

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

[![image348.png](https://wiki.printum.io/uploads/images/gallery/2026-05/scaled-1680-/image348.png)](https://wiki.printum.io/uploads/images/gallery/2026-05/image348.png)

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

[![image41.png](https://wiki.printum.io/uploads/images/gallery/2026-05/scaled-1680-/dTlimage41.png)](https://wiki.printum.io/uploads/images/gallery/2026-05/dTlimage41.png)

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

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


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

- [Ошибка сертификата при установке Клиента ПМ](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/osibka-sertifikata-pri-ustanovke-klienta-pm)
- [Принтеры не появляются на рабочей станции](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/printery-ne-poiavliaiutsia-na-rabocei-stancii)

# Конфликт адресов 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`
- Описание сценария и шагов воспроизведения
- ОС сервера

## Решение

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

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

```
cd /opt/printum
docker-compose down
```

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

```
cd /opt/printmanager
docker-compose down
```

2. **Проверьте наличие файла конфигурации Docker**

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

```
sudo nano /etc/docker/daemon.json
```

3. **Укажите новый пул IP-адресов Docker**

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

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

- `"base"` — выделенный диапазон IP-адресов, который не пересекается с локальной сетью.
- `"size": 26` — размер подсети (изменять не требуется).

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

4. **Перезапустите службу Docker**

```
sudo systemctl restart docker
```

5. **Запустите контейнеры Принтум**

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

```
cd /opt/printum
docker-compose up -d
```

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

```
cd /opt/printmanager
docker-compose up -d
```

6. **Проверьте адреса контейнеров**

```
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).