Skip to main content

Клиент ПМ на 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

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

              Клиент ПМ — справка по компоненту Как диагностировать проблемы печати по этапам пути задания