# Установка Клиента ПМ на Linux вручную

## Цель

Установить Клиент ПМ на рабочую станцию под управлением Windows вручную через командную строку.

## Предусловия

    Сервер ПринтМенеджера установлен и доступен по сети.
    Выполнено обновление системных компонентов операционной системы АРМ.
    Удалены или полностью отключены конфликтующие программы (см. раздел «Что потребуется»).
    Командная строка запущена от имени администратора.

## Что потребуется

- Архив дистрибутива: printmanager_client-linux-x.x.x.tar
- URL сервера ПринтМенеджера: `http://<адрес_сервера>:8010` или `https://<адрес_сервера>:8080`
- Токен доступа (`PRINTMANAGER_ACCESS_TOKEN`) из панели администратора ПринтМенеджера (`https://<адрес_сервера>:8080/config`): `Администрирование → Системные настройки → Общие настройки.`

## Конфликтующие программы

Программа может конфликтовать со сторонними продуктами по управлению печатью. Следует удалить или полностью отключить конфликтующую программу перед установкой:

    PrintXpert

Если программа не отключена, то клиент ПринтМенеджер может работать нестабильно, в том числе может терять задания печати.

## Шаги установки

**Шаг 1.** Установка сертификата сервера

Для обеспечения шифрованного соединения между клиентом ПМ на АРМ и сервером ПМ требуется установить CA-сертификат сервера ПМ.
В случае использования собственных сертификатов безопасности, CA-сертификат уже должен быть установлен на АРМ.
В случае использования автоматических сертификатов, скачайте сертификат с сервера ПМ, из каталога `/home/printum/certs/printum/printum_ca.crt`

**Шаг 2.** Запустить установку

В терминале АРМ, запущенным от администратора, перейдите в папку с дистрибутивом, распакуйте архив:
```
tar xvf printmanager_client-linux-x.y.z.tar
```

Далее введите команду:
```
sudo -E PRINTMANAGER_BASE_URL=http://<адрес_сервера>:8010 PRINTMANAGER_ACCESS_TOKEN=<токен_сервера_ПМ> bash ./install.sh
```

где:
- `PRINTMANAGER_BASE_URL` — ссылка на сервер ПМ, в зависимости от шифрования. Например: без шифрования - `http://<адрес_сервера>:8010`; с шифрованием - `https://<адрес_сервера>:8080`
- `PRINTMANAGER_ACCESS_TOKEN` — токен ПМ.

Путь для установки по умолчанию: `/opt/printum/printmanager_client`

**Шаг 3.** Проверить корректность установки тестовой печатью

Откройте любой "боевой" документ, нажмите сочетание клавиш CRTL+P, выберите принтер Printum.
Укажите желаемые настройки печати документа, после чего нажмите кнопку "Печать" - документ должен попасть в локальную очередь печати АРМ и далее исчезнуть, когда будет обработан службой клиента.

Зайдите в панели администратора ПМ, раздел «Администрирование» → «Очередь печати». В разделе отобразится задание пользователя, с компьютера которого осуществлялась печать.
Если задание на сервере не появилось, проверьте, что на компьютере не запущены программы из списка конфликтующих программ.

## Ожидаемый результат

1. Служба Printum Optimize Service запущена.
2. Виртуальный принтер «Printum» появился в «Устройства и принтеры».
3. Тестовое задание печати появляется в «Очередь печати» в панели администратора ПМ.

#### Примечание

Клиент ПМ создаёт на компьютере доступные пользователям принтеры для прямой печати. Для изменения названий этих принтеров обратитесь к разделу «Отображение названий МФУ на АРМ». Вручную на АРМ менять поля принтера не нужно.

## Типовые ошибки

| Ошибка                                                        | Причина                                                                  | Решение                                                                                                           |
| ------------------------------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| После отправки задания нет в очереди печати пользователя      | УЗ пользователя отсутствует в ПМ;<br>                                    | В панели администратора ПМ, в разделе «Сотрудники» проверить, что пользователь существует и имеет правильный SID. |
| После отправки задания возникает ошибка соединения с сервером | Между пользовательским АРМ и сервером ПМ отсутствует сетевое соединение. | Настроить сетевое соединение, проверить его с помощью повторной отправки задания.                                 |

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

- [Клиент ПМ — справка по компоненту](https://wiki.printum.io/books/2-komponenty-sistemy/page/klient-pm-spravka-po-komponentu-aX6)
- [Требования к рабочим станциям пользователей](https://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-rabocim-stanciiam-polzovatelei)