Клиент ПМ на Linux — установка и проверка
Когда использовать
Установка клиента ПМ на АРМ пользователя под управлением Linux для отложенной или прямой печати.
Поддерживаемые ОС
- Astra Linux Special Edition 1.7 Орёл
- Ред ОС 7.3 МУРОМ / Ред ОС 8
- ALT Linux Рабочая станция 10
Предусловия
- АРМ имеет сетевой доступ к серверу ПринтМенеджера (порт 8080 или 8010).
- На АРМ нет других систем управления печатью (PrintXpert, SafeQ, PaperCut и др.).
- Получены у ТП: ссылка на дистрибутив клиента ПМ для Linux.
- Получен
PRINTMANAGER_ACCESS_TOKEN: Личный кабинет Printum → Настройки → Интеграции → ПМ →Ключ доступа
Установка
Шаг 1. Войдите на АРМ от имени root (по SSH или локально).
Шаг 2. Скачайте дистрибутив (актуальную версию и ссылку уточните у ТП):
curl -O https://s3.printum.io/distrib/printmanager-client/printmanager_client-linux-x.y.z.tar
Шаг 3. Установите клиент ПМ:
tar xvf printmanager_client-linux-x.y.z.tar
cd printmanager_client-linux-x.y.z
sudo PRINTMANAGER_BASE_URL=https://<ip>:8080 PRINTMANAGER_ACCESS_TOKEN=<ключ доступа> bash ./install.sh
Значения переменных:
PRINTMANAGER_BASE_URL—http://адрес:8010(без SSL-сертификата) илиhttps://адрес:8080(с SSL-сертификатом).PRINTMANAGER_ACCESS_TOKEN— ключ доступа ПринтМенеджера, полученный на шаге предусловий.
Примечание: Установка с использованием шифрованного протокола (https и 8080) требует импорта сертификата ПринтМенеджера для Клиента ПМ, инструкция описана ниже. После установки клиент ПМ без импорта сертификата вызовет ошибку после старта службы.
Шаг 4. Проверьте статус службы после установки:
sudo systemctl status printum-printmanager-client.service
Норма: Active: active (running).
Примечание: Установщик отключает автоматическое обнаружение устройств через cups-browsed и Avahi — это исключает печать в обход ПринтМенеджера.
Настройка проверки SSL-сертификата
Если ПринтМенеджер использует собственный или самоподписанный сертификат:
Шаг 1. Остановить службу
systemctl stop printum-printmanager-client.service
Шаг 2. Добавить корневой сертификат сервера с ПринтМенеджером в конец файла
cat /path/to/ca.crt >> /opt/printum/printmanager_client/venv/lib/python3.10/site-packages/certifi/cacert.pem
Шаг 3. Перезапустить службу
systemctl start printum-printmanager-client.service
Проверка после установки
# Статус службы
sudo systemctl status printum-printmanager-client.service
# Логи последних событий
sudo journalctl -u printum-printmanager-client.service --since "5 minutes ago"
Лог службы: /var/log/printum/printmanager_client.log
Дополнительно проверить:
- Виртуальный принтер Printum появился на АРМ.
- Отправить тестовое задание — оно должно появиться в очереди ПринтМенеджера.
Если что-то не работает
- BrokenPipeError — задания не передаются из CUPS в ПринтМенеджер
- Error 401 — пользователь не найден в ПринтМенеджере
- MissingSchema — неверные адрес или токен ПринтМенеджера
- Клиент ПМ перестал работать после обновления Astra Linux