Главная / Документация

Документация

Установка, первая настройка и работа с Принтаксисом. Полная инструкция администратора входит в поставку.

Что это за программа

Принтаксис собирает показания счётчиков принтеров и МФУ, считает отпечатки в четырёх категориях (А4 и А3, ч/б и цвет), следит за тонером и ошибками и сверяет затраты на печать со счётом интегратора по тарифам договора.

Программа состоит из трёх частей:

  • Сервер — веб-интерфейс, приём показаний, отчёты. Хранит данные в PostgreSQL.
  • Сборщик — опрашивает аппараты в подсетях по SNMP и через их веб-страницы, раз в час. Ставится вместе с сервером; на удалённые площадки — отдельно.
  • Агент для Windows — учитывает печать на USB-принтерах и печать по сотрудникам.

Все части работают в сети заказчика. Внешних подключений нет. Сборщик только читает данные аппаратов и ничего в них не меняет.

Требования

ЧтоТребование
ОС сервераAstra Linux SE 1.7 и 1.8, РЕД ОС 7.3 и 8, другие Linux x86_64 с systemd (проверены Debian 12, Rocky Linux 9)
База данныхPostgreSQL 12 и новее — на том же сервере или отдельном
РесурсыОдна виртуальная машина выдерживает 5 000 аппаратов и 3 000 сотрудников с историей за год (база ≈ 720 МБ)
СетьСборщику — доступ к аппаратам по SNMP (UDP 161) и HTTP; аппаратам и пользователям — к серверу по HTTPS (443)
АгентWindows 10/11, Windows Server 2016 и новее; встроенный PowerShell 5.1
БраузерЛюбой современный браузер; ставить на рабочие места ничего не нужно

Интернет для установки и работы не нужен: в поставке есть всё, включая Python и библиотеки.

Установка сервера

Распакуйте поставку и запустите установщик от root:

tar xzf printaxis-*-linux-x86_64.tar.gz
cd printaxis-*-linux-x86_64
sudo ./install.sh --admin-email it@организация.ru

Установщик создаст базу в локальной PostgreSQL, службы systemd, пользователя printaxis и включит HTTPS. Если база на другом сервере:

sudo ./install.sh --dsn postgresql://user:pass@db-host:5432/printaxis

После установки веб доступен по адресу https://имя-сервера; запросы по http:// перенаправляются на HTTPS.

Сертификат HTTPS

  • Лучше — сертификат вашего центра сертификации: --tls-cert сервер.crt --tls-key сервер.key.
  • Без него установщик выпустит свой ЦС и сертификат на имена и адреса сервера. Корневой сертификат /etc/printaxis/tls/ca.crt раздайте групповой политикой в доверенные корневые — тогда браузеры и агенты будут доверять серверу без предупреждений.
  • Сервер за nginx или балансировщиком: --no-tls --port 8800.

Особенности отечественных ОС

РЕД ОС. Установщик сам инициализирует кластер PostgreSQL, включает вход по паролю, восстанавливает метки SELinux и открывает порты в firewalld.

Astra Linux с замкнутой программной средой. Встроенный в поставку Python нужно подписать ключом, доверенным для ЗПС на вашем сервере, — установщик это определит и подскажет. Подпись ключом разработчика появится после прохождения программы «Ready for Astra».

Первая настройка

  1. Войдите в веб под администратором, адрес почты которого указали при установке.
  2. Установите файл лицензии: Настройки → Лицензия или sudo printaxis-admin license-install файл.lic. Без файла действует пробный период — 30 дней на 25 аппаратов.
  3. Укажите подсети для опроса в /etc/printaxis/collector.env. Первый обход начнётся по таймеру, дальше — каждый час.
  4. Заполните места: здания, этажи, кабинеты. Аппараты можно привязать по подсетям, загрузить из файла или указать вручную.
  5. Если нужна сверка — заведите договор с тарифами по четырём категориям в разделе Сверка.
  6. Если есть старые показания — загрузите их из Excel или CSV в разделе Настройки → Перенос истории, чтобы расход считался от них.

Сборщики на площадках

Если аппараты в сетях, которые сервер не видит, поставьте на площадке отдельный сборщик. Получите токен на сервере:

sudo printaxis-admin collector-create "Организация" "Площадка"

и установите сборщик на площадке из той же поставки:

sudo ./install.sh --mode collector \
  --server https://printaxis.организация.ru \
  --token pxc_… --subnets "10.1.0.0/24 10.1.1.0/24"

Для шифрованного опроса включите SNMPv3 в /etc/printaxis/collector.env (PRINTAXIS_SNMP_VERSIONS=3 или 3,2c для смешанного парка). Пароли SNMPv3 хранятся только в этом файле.

Агент для Windows

Агент нужен для USB-принтеров и для учёта печати по сотрудникам. Он читает журнал печати Windows, определяет формат и цветность задания, берёт отдел из Active Directory и отправляет задания на сервер раз в 5 минут. Если сервер недоступен — копит их на диске.

powershell -ExecutionPolicy Bypass -File install-agent.ps1 `
  -Server https://printaxis.организация.ru -Token pxc_…

Массовая установка — тем же скриптом через групповую политику. Имена документов агент по умолчанию не передаёт.

Работа в интерфейсе

РазделЧто там
СводкаЧисло аппаратов, страницы за день и за 30 дней, график печати, состояние парка и список «Требуют внимания»: ошибки, мало тонера, нет связи, аппараты без места
АппаратыСписок с поиском и фильтрами: место, тип, счётчик, точность разбивки, тонер, состояние, дата показания. В карточке аппарата — история показаний
МестаЗдания, этажи, кабинеты, ответственные; журнал перемещений
ОтпечаткиРасход за период по четырём категориям — по аппаратам, моделям, этажам; выгрузка в Excel
СотрудникиПечать по людям и отделам (нужен агент)
КвотыЛимиты печати лично, на отдел или каждому; уведомления при приближении к лимиту
СверкаДоговоры с тарифами, загрузка счёта интегратора, расхождения по категориям и по аппаратам, выгрузка в Excel
НастройкиПользователи, вход через AD, Service Desk, перенос истории, лицензия, журнал действий

Точность показаний

У каждого аппарата видно, насколько можно доверять разбивке:

  • точно — категории сняты с аппарата;
  • выведено — аппарат ч/б и только А4, поэтому весь счётчик — «А4 ч/б»;
  • общий — аппарат отдаёт только общий счётчик; в сверке такие страницы помечаются как оценка;
  • по заданиям — USB-аппарат, страницы посчитаны агентом.

Безопасность

  • Вход через Active Directory — Настройки → Вход через AD: контроллеры по ldaps:// или со StartTLS, служебная учётка только на чтение, две группы — администраторы и просмотр. Кнопка «Проверить вход» показывает каждый шаг. Местные учётки остаются для аварийного входа.
  • Журнал действий — входы (в том числе неудачные), изменения и выгрузки с адресом пользователя. Записи нельзя изменить или удалить даже в базе. Очистка старых записей по политике ИБ: printaxis-admin audit-purge --older-than-days 365.
  • Службы работают от отдельного пользователя без прав root; cookie сессии — только по HTTPS; включены HSTS и CSP.
  • Права — пользователь видит только свою организацию; пользователи сервисной компании видят все.

Резервирование

Для работы без единой точки отказа ставятся два сервера и два узла PostgreSQL с потоковой репликацией:

sudo ./install.sh --dsn postgresql://u:p@db1:5432,db2:5432/printaxis

Сборщикам и агентам указывается список серверов. При отказе сервера они переходят на второй; при отказе базы копят показания в очереди и досылают после переключения. Схема и порядок переключения — docs/ha.md в поставке.

Обновление и удаление

Обновление. Распакуйте новую поставку и снова запустите sudo ./install.sh. Настройки и данные сохраняются, схема базы обновляется сама. Обновления базы профилей моделей приходят тем же способом.

Удаление. sudo ./uninstall.sh удаляет программу и оставляет данные и настройки; с ключом --purge — удаляет и настройки. Базу данных удаляет администратор вручную.

Где что лежит

Программа/opt/printaxis
Настройки сервера/etc/printaxis/printaxis.env
Настройки сборщика/etc/printaxis/collector.env
Службыprintaxis-web, printaxis-collector.timer, printaxis-events.timer
Журналыjournalctl -u printaxis-web -u printaxis-collector

Лицензия

Лицензия — файл с цифровой подписью. В нём указано, кому она выдана, на сколько аппаратов, какие модули и до какой даты действует поддержка. Файл проверяется на сервере без связи с нами.

  • В лимит входят аппараты, которые давали показания за последние 30 дней.
  • Сбор показаний не останавливается никогда — даже если лицензия закончилась. Без действующей лицензии закрываются сверка и выгрузки.
  • Пробный период — 30 дней на 25 аппаратов, без файла лицензии.

Цены и модули — на главной странице, условия поддержки — на странице «Поддержка».