Установка встроенного приложения на HP
Установка прошивки
Установите прошивку версии 5.2 или новее. Если для вашего МФУ нет 5-й версии, установите 4.11 или новее.
Для этого:
- Авторизуйтесь в веб-панели управления МФУ, нажав "Вход" в правом верхнем углу экрана. В появившемся окне выберите учётную запись "Администратор" и введите пароль, нажмите "Вход".
- Зайдите в панель управления МФУ, раздел "Общие" > "Обновление микропрограммы".
- Нажмите на кнопку "Поддержка продукта". Откроется страница поддержки вашего МФУ.
- Найдите ссылку на файл, содержащую слово "Firmware", и скачайте его.
- Вернитесь в панель управления МФУ, нажмите "Выберите файл", укажите скачанный файл, нажмите "Установить".
Сброс до заводских настроек
Авторизуйтесь в панели управления, как описано выше. Зайдите в раздел "Общие" > "Сброс до заводских настроек" и в разделе "Сброс параметров" нажмите кнопку "Сброс".
После перезапуска нужно ответить на несколько вопросов на экране МФУ или через удалённую панель. Обязательно выберите русский язык. Если выбрать язык в веб-панели администратора, то этот выбор повлияет на язык веб-панели, а не на язык экрана устройства.
В итоге МФУ должен быть настроен со следующими параметрами (см. скриншот в исходной документации).
Подключение к ПринтМенеджеру
Убедитесь, что МФУ подключён к ПринтМенеджеру, и произведите настройки, указанные ниже. Для этого:
- Откройте панель Мониторинга и перейдите в раздел "Настройки МФУ":
https://адрес_сервера:8001/config/printer/printersettings/ - Кликните на ID нужного устройства. Откроется окно с настройками.
Убедитесь, что заполнены следующие поля:
- Идентификатор в CUPS — заполняется автоматически при импорте МФУ в ПринтМенеджер;
- Название — заполняется автоматически при импорте МФУ в ПринтМенеджер;
- Хост — заполняется автоматически при импорте МФУ в ПринтМенеджер;
- Сервер печати — заполняется автоматически при импорте МФУ в ПринтМенеджер.
Обязательно нужно указать:
- Логин МФУ — admin
- Пароль МФУ — тот, по которому вы заходите в панель управления МФУ. По умолчанию у МФУ пустой пароль. Необходимо установить пароль.
- SNMP security username — укажите имя пользователя, заданное при установке SNMP.
- SNMP auth protocol — протокол авторизации по SNMP. Укажите SHA.
- SNMP privacy protocol — приватный протокол подключения по SNMP. Укажите AES.
- Настраиваемые атрибуты — в соответствии с подключённым к МФУ картридером. Обратитесь к разделу "Настройка поддержки разных типов картридеров". Если картридер отсутствует, укажите пустые атрибуты:
{}
Обязательно дождитесь синхронизации ПринтМенеджера и Мониторинга или запустите её вручную.
Настройка приложения для работы с картридерами
На текущий момент поддерживаются некоторые картридеры вендоров HP и Elatec, YSoft и совместимые с ними.
Для настройки работы с картридером в МФУ нужно указать VID, PID (параметры vendorId и productId соответственно), а также указать тип ридера в параметре reader_type. Поддерживаемые типы: hp, hp_2fg83a, elatec, ysoft_r3lf.
Эти параметры задаются в поле "Настраиваемые атрибуты" в формате JSON:
| Модель картридера | Настраиваемые атрибуты |
|---|---|
| HP X3D03A | {"accessories": [{"vendorId": 1008, "productId": 69}], "reader_type": "hp"} |
| HP Y7C05A | {"accessories": [{"vendorId": 3111, "productId": 15354}], "reader_type": "hp"} |
| Nicotech N5 (модель 702) | {"accessories": [{"vendorId": 3111, "productId": 15354}], "reader_type": "elatec"} |
| HP 2FG83A | {"accessories": [{"vendorId": 1008, "productId": 69}], "reader_type": "hp_2fg83a"} |
| Elatec TWN4 MultiTech 3 | {"accessories": [{"vendorId": 2520, "productId": 1040}], "reader_type": "elatec"} |
| YSoft USB Reader 3 LF | {"accessories": [{"vendorId": 8524, "productId": 777}], "reader_type": "ysoft_r3lf"} |
Параметр reader_type для картридеров HP Y7C05A и X3D03A допустимо не указывать. Для ридера HP 2FG83A укажите reader_type как показано выше.
Если подключена другая модель ридера, узнайте его VID и PID. Например, можно подключить картридер напрямую в компьютер с Windows, в "Диспетчере устройств" найдите картридер (обычно отображается как клавиатура). В разделе "Сведения" > "ИД оборудования" найдите VID_ и несколько цифр до знака & — переведите их из шестнадцатеричного в десятичный формат и внесите в параметр vendorId. Аналогично для PID_ → productId.
Если серийный номер карты считывается с неправильным порядком байтов (например, вместо 12ABDE34 записывается 34DEAB12), укажите параметр need_invert: true:
{"accessories": [{"vendorId": 2520, "productId": 1040}], "need_invert": "true"}
Если необходимо разрешить картридер только с определённым серийным номером:
{"accessories": [{"vendorId": 2520, "productId": 1040, "serialNumber": "QWERTY12345"}]}
После изменения параметров vendorId, productId, serialNumber приложение необходимо переустановить. При изменении need_invert или reader_type переустанавливать не нужно.
Настройка поддержки разных типов карт через HP Card Reader Configuration Utility
Если необходимо добавить поддержку новых типов карт через HP Configuration Utility, это нужно сделать до установки приложения, поскольку приложение блокирует доступ к картридеру для внешних программ.
Используйте приложение HP Card Reader Configuration Utility. Отключите брандмауэр Microsoft Defender или внесите в него исключение и запустите программу с правами администратора.
На вкладке "Connection Settings" настройте доступ к картридеру по сети: введите IP-адрес МФУ, имя и пароль администратора, или выберите подключение напрямую через USB, и нажмите Connect.
Для добавления поддержки новой карты на вкладке "Card Reader Global Settings" добавьте в один из четырёх Card Type нужный тип карты:
- Mifare: RDR-758X Equivalent (6F01)
- Deister: UID (F401)
- HID Prox: (EF04)
После выбора параметров нажмите "Write to Flash".
Для массовой настройки перейдите на вкладку Fleet Configuration, выберите файл printer_list.csv и файл настроек hpCardReaderConfiguration3cardtypes.json, укажите логин и пароль и нажмите "Configure".
Настройка ридера YSoft через программу YSoft Card Reader Tool
Для правильной работы необходимо:
- убедиться, что прошивка HP версии 4.6.0.1 или новее;
- выбрать режим ридера;
- установить подходящий для карт протокол.
Подсоедините ридер к компьютеру. Запустите программу. Во вкладке "Configuration" выберите картридер, нажмите "Configure". В разделе USB mode выберите "USB reader for HP MFP", нажмите "Configure", "Ok". Для выбора поддержки других типов карт выберите нужный протокол в разделе Configuration Options, нажмите "Configure", "Ok".
Установка приложения на серверы с хостнеймом
Воспользуйтесь инструкцией ниже, если ПринтМенеджер установлен на сервер с доменным именем.
- Откройте веб-интерфейс МФУ.
- Перейдите в раздел "Работа в сети".
- Откройте вкладку "TCP/IP" в боковом меню.
- Перейдите в подраздел "TCP/IP V4".
- Поменяйте способ конфигурации IP и введите DNS-адрес.
Установка приложения через Личный кабинет
Перейдите в раздел "Управление" → "Устройства", выберите МФУ, перейдите на вкладку "Настройки", нажмите кнопку "Приложение не установлено" → "Установить приложение".
Через техническую панель администратора (Мониторинг)
Перейдите в раздел "МФУ" → "Настройки МФУ", выберите МФУ и нажмите кнопку "Установить приложение".
Результат установки можно посмотреть в отчёте по событиям безопасности Личного кабинета — успешное окончание отображается в столбце "Результат".
Через командную строку
Зайдите на сервер по SSH и выполните:
cd /opt/printmanager
sudo docker-compose exec app python ./manage.py hp_install <printer_id>
где <printer_id> — "Идентификатор МФУ" на странице МФУ (/admin/web/printer/).
Отключение ограничения использования цвета
Для цветных моделей после установки приложения нужно включить использование цвета при печати. Иначе все задания будут распечатываться в монохромном режиме.
В веб-интерфейсе МФУ на вкладке "Копирование/Печать" выберите раздел "Ограничить использование цвета" и установите опцию "Основные настройки цветной печати" в состояние "Включить цвет".
Настройка главного экрана
В веб-интерфейсе устройства зайдите в "Общие" → "Настройки главного экрана". В разделе "Главный экран" перетащите все ненужные иконки в блок "Скрытые элементы". Должны остаться только Печать, Копирование и Сканирование. Приложения Printum отличаются от родных HP синим фоном. Обратите внимание, что экранов несколько — нужно очистить все, кроме указанных выше.
Удаление приложения
Через Личный кабинет
Перейдите в "Управление" → "Устройства", выберите МФУ, нажмите кнопку "Приложение установлено" → "Удалить приложение".
Через панель администратора
Перейдите в "МФУ" → "Настройки МФУ", выберите МФУ и нажмите кнопку "Удалить приложение".
Через командную строку
cd /opt/printmanager
sudo docker-compose exec app python ./manage.py hp_uninstall <printer_id>
Установка на устройства с маленьким экраном (режим Fast Release Only)
На устройствах с маленькими экранами функционал ограничен: нет клавиатуры, нельзя аутентифицироваться по ПИН-коду. Единственное доступное действие — печать всех заданий из очереди (режим Fast Release) после аутентификации по карте.
Чтобы ПринтМенеджер понимал, как работать с такими аппаратами, включите для них режим Fast Release Only. Это можно сделать до или после установки встроенного приложения. В поле "Настраиваемые атрибуты" в форме редактирования МФУ добавьте:
{"accessories": [{"vendorId": xxx, "productId": yyy}], "fastReleaseOnly": true}
Примечание: Fast Release Only и Fast Release — разные режимы. Fast Release Only предназначен для устройств с маленьким экраном. Включать оба режима одновременно не нужно.