Клиент ПМ на 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:
Клиент ПМ на Linux — установка и проверка
Когда использовать
Установка клиента ПМ на АРМ пользователя под управлением Linux для отложенной или прямой печати.
Поддерживаемые ОС
- Astra Linux Special Edition 1.7 Орёл
- Ред ОС 7.3 МУРОМ / Ред ОС 8
- ALT Linux Рабочая станция 10
Предусловия
- АРМ имеет сетевой доступ к серверу ПринтМенеджера (порт
8080)8080 или 8010). - На АРМ нет других систем управления печатью (PrintXpert, SafeQ, PaperCut и др.).
- Получены у ТП: ссылка на дистрибутив клиента ПМ для Linux.
- Получен
:PM_ACCESS_TOKENPRINTMANAGER_ACCESS_TOKENпанельЛичныйадминистраторакабинетПринтМенеджераPrintum → Настройки → Интеграции → ПМ →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—токен,ключ доступа ПринтМенеджера, полученный на шаге предусловий.
Примечание: Установка с использованием шифрованного протокола (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
#
Шаг старых версий заменить python3.10 на python3.8
#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