Клиент ПМ на Linux — установка и проверка
title: Клиент ПМ на Linux — установка и проверка slug: kak-ustanovit-klient-pm-na-linux tags: [клиент ПМ, Linux, Astra, Alt, RedOS, установка] domain: Installation type: Runbook audience: partner-engineer product_versions: "4.x" status: ready related_components: [Клиент ПМ, ПринтМенеджер] related_pages:
- kak-rabotaet-pm-client
- kak-diagnostirovat-problemy-pechati-po-etapam-puti-zadaniya
Клиент ПМ на Linux — установка и проверка
Когда использовать
Установка клиента ПМ на АРМ пользователя под управлением Linux для отложенной или прямой печати.
Поддерживаемые ОС
- Astra Linux Special Edition 1.7 Орёл
- Ред ОС 7.3 МУРОМ / Ред ОС 8
- ALT Linux Рабочая станция 10
Предусловия
- АРМ имеет сетевой доступ к серверу ПринтМенеджера (порт 8080).
- На АРМ нет других систем управления печатью (PrintXpert, SafeQ, PaperCut и др.).
- Получены у ТП: ссылка на дистрибутив клиента ПМ для Linux.
- Получен
PM_ACCESS_TOKEN: панель администратора ПринтМенеджера →https://<ip>:8080/config→ Администрирование → Системные настройки → Общие настройки →PM_ACCESS_TOKEN.
Установка
Шаг 0 (опционально). Если ПринтМенеджер использует собственный или самоподписанный SSL-сертификат — сначала выполните настройку проверки SSL-сертификата (см. раздел ниже), затем возвращайтесь к установке.
Шаг 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— токен, полученный на шаге предусловий.
Шаг 4. Проверьте статус службы после установки:
sudo systemctl status printum-printmanager-client.service
Норма: Active: active (running).
Примечание: Установщик отключает автоматическое обнаружение устройств через cups-browsed и Avahi — это исключает печать в обход ПринтМенеджера.
Настройка проверки SSL-сертификата
Если ПринтМенеджер использует собственный или самоподписанный сертификат:
# Остановить службу
systemctl stop printum-printmanager-client.service
# Добавить корневой сертификат в конец файла
cat /path/to/ca.crt >> /opt/printum/printmanager_client/venv/lib/python3.10/site-packages/certifi/cacert.pem
# Для старых версий заменить python3.10 на python3.8
# Перезапустить службу
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