====== Сети сканирования ======

Сеть сканирования в **EYEPRINT** — именованный **диапазон IP-адресов**, который служба ''eyeprint-core'' периодически обходит в поисках сетевых принтеров. Найденные устройства попадают в справочник принтеров: по ним собираются счётчики, расходники и состояние.

<WRAP info>
Сеть сканирования — это не очередь печати и не VLAN. Это только границы обхода: **начальный и конечный IP**. Формат CIDR (''192.168.1.0/24'') не используется.
</WRAP>

===== Как это работает =====

<code>
eyeprint-core  (планировщик)
        │  период из параметра «таймаут сканера сети»
        ▼
  Обход IP от начала до конца диапазона
        │  TCP: 9100, 631, 515
        │  SNMP: community public, версия 2c
        ▼
  Справочник принтеров
        — новое устройство добавляется
        — известное обновляется (IP, состояние)
        — не ответившее помечается как выключенное
</code>

  - Планировщик в **eyeprint-core** раз в заданный интервал запускает обход всех **активных** сетей.
  - Для каждого адреса проверяются порты печати: **9100** (JetDirect/raw), **631** (IPP), **515** (LPD). Таймаут на порт короткий (~110 мс).
  - Если порт открыт, система опрашивает устройство по **SNMP** (community **''public''**, SNMPv2c) и читает признаки принтера (модель, серийный номер, MAC, счётчик и др.).
  - Новое устройство появляется в списке принтеров. Уже известное обновляется; если в этом проходе устройство не ответило — оно отмечается как выключенное.
  - Очереди печати **сами не создаются**. После появления принтера его при необходимости привязывают к очереди: см. [[print_queues|Очереди печати]].

<WRAP important>
Автообнаружение использует только community **''public''**. Учётные данные SNMP из карточки принтера (в том числе SNMPv3) на обход диапазона не влияют — ими пользуются при **ручном** добавлении устройства.
</WRAP>

===== Службы и порты =====

^ Компонент ^ Роль ^
| ''eyeprint-core'' | Планировщик и сканер сети |
| ''eyeprint-web'' | Веб-интерфейс: раздел **«Сеть»** |
| ''eyeprint-ps'' | К сканированию сети не относится (это приём печати) |

^ Порт / протокол ^ Назначение ^
| TCP **9100**, **631**, **515** | Признаки «похоже на принтер» |
| UDP **161** | SNMP-опрос |
| **8080** | Веб-интерфейс администратора |

С хоста EYEPRINT до устройств в диапазоне должен быть разрешён доступ к этим портам. Файлы MIB принтера должны быть на сервере (в дистрибутиве обычно ''/opt/eyeprint/mibs/Printer-MIB'').

===== Лицензия и период =====

Нужна лицензия с функцией **мониторинга сети**. Если срок истёк или исчерпан лимит устройств, обход не выполняется.

Период сканирования задаётся параметром системы **«Период сканирования сети для поиска новых устройств»** (ключ ''eyeprint.net_scaner.timeout''). По умолчанию — **60 секунд**.

<WRAP info>
Большой диапазон (тысячи адресов) один проход может не успеть за минуту: на каждый IP проверяются три TCP-порта. Задавайте узкие рабочие подсети, а не весь ''10.0.0.0–10.255.255.255''.
</WRAP>

===== Администрирование в веб-интерфейсе =====

Войдите в веб-интерфейс (по умолчанию ''http://IP-сервера:8080'') и откройте раздел **«Сеть»**.

==== Поля диапазона ====

^ Поле ^ Смысл ^
| **Имя** | Название сети в списке (до 50 символов) |
| **Начало / конец** | Первый и последний IP включительно |
| **Группа по умолчанию** | Группа устройств, с которой связывают диапазон. Должна существовать (часто «Основная») |
| **Активен** | Выключенный диапазон не сканируется |

Пошаговое добавление: [[add_network|Добавление сети сканирования]].

==== После появления принтеров ====

  - Проверьте [[printers|список принтеров]]: модель, IP, серийный номер, состояние (в сети / выключен).
  - При необходимости назначьте группу вручную в карточке принтера.
  - Для печати создайте очередь и привяжите устройство: [[print_queues|Очереди печати]].

==== Типовые проблемы ====

^ Симптом ^ Что проверить ^
| Диапазоны есть, устройств нет | Флаг **Активен**; лицензия мониторинга сети; на принтерах community **''public''**; доступны ли 9100/631/515 и UDP 161 с сервера EYEPRINT |
| Устройства то появляются, то «выключаются» | Нестабильный SNMP/сеть; адрес выпал из диапазона; слишком редкий или слишком короткий проход |
| Принтер с нестандартным SNMP не находится | Задайте community/SNMPv3 и добавьте устройство **вручную** |
| Новый диапазон не виден в списке | Укажите существующую **группу по умолчанию** |
| Скан «не успевает» | Сократите диапазон или увеличьте период сканирования |
| Принтер найден, печатать нельзя | Нужна [[print_queues|очередь печати]] и [[add_printer|подключение с рабочей станции]] |

===== Связь с очередями и группами =====

  * **Сеть сканирования** находит и учитывает устройства.
  * **Группа устройств** нужна для организации справочника и прав в интерфейсе.
  * **Очередь печати** — отдельная сущность: без неё мониторинг работает, печать через EYEPRINT — нет.

Порядок внедрения: добавить диапазон → дождаться появления принтеров → при необходимости поправить карточки → создать очереди → подключить рабочие станции.