Skip to main content

Клиент ПМ на 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)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_URLhttp://адрес: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 появился на АРМ.
    • Отправить тестовое задание — оно должно появиться в очереди ПринтМенеджера.

    Если что-то не работает


    Связанные страницы