# Клиент ПМ на 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 для отложенной или прямой печати.

---

### Поддерживаемые ОС

- 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.** Скачайте дистрибутив (актуальную версию и ссылку уточните у ТП):

```bash
curl -O https://s3.printum.io/distrib/printmanager-client/printmanager_client-linux-x.y.z.tar
```

**Шаг 3.** Установите клиент ПМ:

```bash
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.** Проверьте статус службы после установки:

```bash
sudo systemctl status printum-printmanager-client.service
```

Норма: `Active: active (running)`.

> **Примечание:** Установщик отключает автоматическое обнаружение устройств через cups-browsed и Avahi — это исключает печать в обход ПринтМенеджера.
---

### Настройка проверки SSL-сертификата

Если ПринтМенеджер использует собственный или самоподписанный сертификат:

**Шаг 1.** Остановить службу
```bash
systemctl stop printum-printmanager-client.service
```
**Шаг 2.** Добавить корневой сертификат сервера с ПринтМенеджером в конец файла
```bash
cat /path/to/ca.crt >> /opt/printum/printmanager_client/venv/lib/python3.10/site-packages/certifi/cacert.pem
```
**Шаг 3.** Перезапустить службу
```bash
systemctl start printum-printmanager-client.service
```

---

### Проверка после установки

```bash
# Статус службы
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 в ПринтМенеджер](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/brokenpipeerror-zadaniia-ne-peredaiutsia-iz-cups-v-pm-linux)
- [Error 401 — пользователь не найден в ПринтМенеджере](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/error-401-polzovatel-ne-naiden-v-pm-klient-pm-linux)
- [MissingSchema — неверные адрес или токен ПринтМенеджера](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/missingschema-nevernye-adres-ili-token-pm-klient-pm-linux)
- [Клиент ПМ перестал работать после обновления Astra Linux](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/klient-pm-perestal-rabotat-posle-obnovleniia-astra-linux)

---

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

- [Клиент ПМ — справка по компоненту](https://wiki.printum.io/books/2-komponenty-sistemy/page/klient-pm-spravka-po-komponentu-aX6)
- [Как диагностировать проблемы печати по этапам пути задания](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/kak-diagnostirovat-problemy-pecati-po-etapam)