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

# Задания не распечатываются в отказоустойчивой конфигурации

Симптом В конфигурации с балансировщиком HAProxy пользователи авторизуются, но задания не выходят на печать. Диагностика Шаг 1. Проверить панель HAProxy Откройте панель администратора HAProxy. Проверьте, что все секции зелёные: ftp cups_1631 tcp_converter_7776 / tcp_converter_7777 admin_8010 / admin_8080 Красная строка сервера = сервер установлен некорректно или недоступен. Шаг 2. Проверить флаг use_cups_ssl в клиенте ПринтМенеджер Ошибка http.client.RemoteDisconnected: Remote end closed connection without response означает неверный флаг SSL. Перейдите в директорию клиента ПМ: C:\Program Files\printum\printmanager_client\ Откройте файл settings.yml с правами администратора. Установите: use_cups_ssl: true Шаг 3. Проверить NFS-хранилище Убедитесь, что NFS-хранилище доступно со всех серверов ПринтМенеджер. Недоступность NFS приводит к потере файлов заданий. Шаг 4. Проверить синхронизацию ПринтМенеджер с Мониторингом Запустите ручную синхронизацию: Управление → ПринтМенеджеры → «Синхронизировать». Связанные страницы Файл недоступен при отложенной печати в кластере Обновление в отказоустойчивой конфигурации

# Файл недоступен при отложенной печати в кластере

Симптом Пользователь авторизовался на МФУ, но задание недоступно или файл документа отсутствует в очереди. Причина Файлы заданий в кластерной конфигурации хранятся на NFS-хранилище. Если NFS недоступен или неправильно смонтирован на одном из серверов ПринтМенеджер — файлы заданий не видны этому серверу. Диагностика Шаг 1. Проверить монтирование NFS # На каждом сервере ПринтМенеджер: df -h | grep nfs mount | grep nfs Шаг 2. Проверить права доступа к папке NFS ls -la /scratch # Ожидаемые права: 777, владелец nobody Шаг 3. Проверить сетевую доступность NFS-сервера ping <NFS_ADDR> # Проверка экспортов NFS: showmount -e <NFS_ADDR> Шаг 4. Перемонтировать NFS при необходимости sudo umount /scratch sudo mount <NFS_ADDR>:<NFS_FOLDER_PATH> /scratch Связанные страницы Задания не распечатываются в отказоустойчивой конфигурации

# Как диагностировать проблемы NFS и DNS

# Как диагностировать проблемы NFS и DNS

## Назначение

DNS и NFS являются критическими зависимостями Printum.

Проблемы с ними могут вызывать:
- restart loop контейнеров;
- отказ ПринтМенеджер;
- ошибки синхронизации;
- недоступность очередей;
- проблемы Встроенное приложение.

---

# Как диагностировать проблемы DNS

## Проверка resolv.conf

Проверить:

```bash
cat /etc/resolv.conf
```

Убедиться:
- DNS-серверы доступны;
- нет ошибочных записей.

---

## Проверка hostname resolution

Проверить:

```bash
ping monitoring.local
```

Проверить:
- hostname резолвится;
- IP корректный.

---

## Типовые признаки DNS-проблем

| Симптом | Возможная причина |
|---|---|
| restart loop | hostname не резолвится |
| timeout | DNS unavailable |
| sync errors | неверный hostname |
| SSL errors | mismatch hostname |

---

# Как диагностировать проблемы NFS

## Проверка доступности порта

Проверить:

```bash
telnet nfs-server 2049
```

Проверить stunnel:

```bash
telnet nfs-server 20490
```

---

## Проверка mount

Проверить:

```bash
df -h
```

Проверить:
- volume mounted;
- нет stale mount;
- нет readonly mode.

---

## Проверка volumes

Проверить:

```bash
ls /var/lib/docker/volumes/
```

---

## Проверка сервисов NFS

На NFS server:

```bash
systemctl status nfs-server.service
```

```bash
systemctl status stunnel.service
```

---

## Перезапуск сервисов

```bash
systemctl restart nfs-server.service
```

```bash
systemctl restart stunnel.service
```

---

# Что делать при restart loop контейнеров

Проверить:
- DNS;
- NFS;
- network connectivity;
- mount points.

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

```bash
docker-compose down
docker-compose up -d
```

---

# Что важно помнить

- DNS — одна из самых частых причин отказов.
- NFS критичен для работы ПринтМенеджер.
- Большинство restart loop связано с инфраструктурными зависимостями.
- Проверка DNS и NFS должна быть первым шагом диагностики.