# Установка Клиента ПМ на Windows вручную ## Цель Установить Клиент ПМ на рабочую станцию под управлением Windows вручную через командную строку. ## Предусловия - Сервер ПринтМенеджера установлен и доступен по сети. - Установлен пакет «Microsoft Visual C++ Redistributable packages for Visual Studio 2015» или новее. - Удалены или полностью отключены конфликтующие программы (см. раздел «Что потребуется»). - Командная строка запущена от имени администратора. ## Что потребуется - MSI-файл дистрибутива: `printmanager_client-a.b.c-win.msi`. - URL сервера ПринтМенеджера: `https://IP_ADDRESS:8080`. - Токен доступа (`PM_ACCESS_TOKEN`) из технической панели администратора (`https://:8080/config`): Администрирование → Системные настройки → Общие настройки. - Пакет Microsoft Visual C++ Redistributable packages for Visual Studio 2015 или новее (x86-версия). Скачать: [https://docs.microsoft.com/ru-RU/cpp/windows/latest-supported-vc-redist?view=msvc-170](https://docs.microsoft.com/ru-RU/cpp/windows/latest-supported-vc-redist?view=msvc-170) ## Конфликтующие программы Программа может конфликтовать со сторонними продуктами по управлению печатью. Следует удалить или полностью отключить конфликтующую программу перед установкой: - PrintXpert - Ysoft SafeQ Local Monitor - Ysoft SafeQ Flexispooler - HP Access Control - LPD, LPR, PDF24 (конфликт возможен в момент установки) - PaperCut Print Logger (конфликт возможен в момент установки) Если программы из списка не отключены, то при установке они могут быть закрыты принудительно. Если данные программы не были отключены, то клиент ПринтМенеджер может работать нестабильно, в том числе может терять задания печати. ## Шаги установки ### Шаг 1. (Опционально) Установить сертификат для драйвера Если это требуется по внутренним правилам организации — выполните инструкцию из раздела «Установка сертификата для драйвера» перед установкой MSI. Если сертификат не был установлен, в ходе установки появится окно с предложением установить сертификат — нажмите «Установить». ### Шаг 2. Установить Microsoft Visual C++ Redistributable Установите пакет _Microsoft Visual C++ Redistributable packages for Visual Studio 2015_ или новее. При скачивании необходимо выбрать x86 (`vc_redist.x86.exe`) версию пакета, независимо от разрядности операционной системы. После установки пакета перезагрузите компьютер. ### Шаг 3. Запустить установку MSI В `cmd` консоли, запущенной от администратора, перейдите в папку с дистрибутивом и введите: msiexec /i printmanager_client-a.b.c-win.msi /qn /L install.log /norestart где `printmanager_client-a.b.c-win.msi` — имя MSI файла. Путь для установки по умолчанию: `C:\Program Files\printum\printmanager_client` — и для `x86`, и для `x64` разрядных систем. Дополнительно для x64 допустима установка в `C:\Program Files (x86)\printum\printmanager_client`. Установка в другие папки недопустима. Установка обычно занимает около минуты. ### Шаг 4. Настроить файл settings.yml После установки MSI укажите следующие настройки в файле `settings.yml` в папке установки (путь по умолчанию: `C:\Program Files\printum\printmanager_client\settings.yml`): - `printmanager_base_url` — базовый URL-адрес системы управления печатью. Формат: `https://IP_ADDRESS:8080`, где `IP_ADDRESS` — адрес сервера. Слеш в конце адреса недопустим. - `access_token` — ключ доступа, который используется клиентом ПринтМенеджер для авторизации на сервере. Ключ находится в технической панели администратора Управления печатью по адресу `https://:8080/config`, в Администрирование → Системные настройки → Общие настройки → `PM_ACCESS_TOKEN`. - `verify_SSL_cert` — флаг проверки службой SSL-сертификата сервера (установите `False`, если проверка не требуется, иначе `True`). - `use_gs_conversion` — (необязательно) тип конвертации документов. По умолчанию `True`. Установите `False` при наличии проблем с разметкой или для ускорения печати. - `use_pdf_color_analysis` — (необязательно) анализ PDF на цветность. Установите `true`, если из отдельных программ цветные документы печатаются в ЧБ. - `use_cups_ssl` — (необязательно) шифрование при печати по ipp/ipps. По умолчанию `True`. - `verify_cups_ssl` — (необязательно) проверка SSL-сертификата сервера. По умолчанию `False`. - `max_server_timeout` — (необязательно) максимальное время ожидания ответа от сервера в секундах. По умолчанию 30 секунд. Для сохранения настроек в файле понадобятся права администратора. При указании правильных настроек служба самостоятельно запустится в течение одной минуты. Если этого не произошло, перезапустите службу `Printum Optimize Service` через компоненты services (Службы). ### Шаг 5. Проверить установку тестовой печатью Зайдите в «Устройства и принтеры», нажмите «Свойства» принтера «Printum». В открывшемся окне выберите «Пробная печать». Документ должен попасть в локальную очередь печати и далее исчезнуть, когда будет обработан службой. Зайдите в раздел «Администрирование» → «Очередь печати». В разделе отобразится задание для пользователя, с компьютера которого осуществлялась печать. Если задание на сервере не появилось, проверьте, что на компьютере не запущены программы из списка конфликтующих программ. ## Ожидаемый результат - Служба `Printum Optimize Service` запущена. - Виртуальный принтер «Printum» появился в «Устройства и принтеры». - Тестовое задание печати появляется в «Очередь печати» в панели администратора. ## Как проверить установку - Открыть «Устройства и принтеры» → убедиться в наличии принтера «Printum». - Открыть «Службы» → убедиться, что `Printum Optimize Service` в состоянии «Выполняется». - Выполнить тестовую печать и убедиться, что задание появляется в панели администратора ПМ. ## Примечание - Клиент ПМ создаёт на компьютере доступные пользователям принтеры для прямой печати. Для изменения названий этих принтеров обратитесь к разделу «Отображение названий МФУ на АРМ». Вручную на АРМ менять поля принтера не нужно. ## Следующие шаги - «Обновление Клиента ПринтМенеджер на Windows» - «Удаление Клиента ПринтМенеджер на Windows» --- ## Типовые ошибки |Ошибка|Причина|Решение| |:---|:---|:---| |При установке появляется системное уведомление о сертификате драйвера|Отсутствует или некорректна цепочка сертификатов GlobalSign|Запустить certlm.msc → Доверенные издатели — должен быть сертификат «ООО Принтум». Установить GlobalSign GCC R45 EV CodeSigning CA 2020 в промежуточные ЦС, GlobalSign Code Signing Root R45 — в доверенные корневые ЦС| |No user {'имя'} is authorized, removing all printers.|Пользователь не авторизован в системе управления печатью|В разделе «Сотрудники» проверить, что пользователь существует и имеет правильный SID. Проверить корректность токена access_token| |Error in VirtualPrintersUpdater: HTTPSConnectionPool: Max retries exceeded|Программа не смогла подключиться к серверу ПринтМенеджера|Убедиться, что сервер доступен по указанному адресу и порту 8080 с данного компьютера| |AssertionError: Adding printer Printum means critical error. Reinstall this printer manually or application entirely.|Принтер Printum с драйвером Printum XPS не найден при старте службы|Удалить принтер вручную, переустановить Клиент ПМ| |При пробной печати ошибка «Невозможно завершить операцию (ошибка 0x00000077)»|Проблемы с обновлениями Windows 10/11|Обратиться к системному администратору — решение находится за рамками системы Printum| --- ## Связанные страницы - [Клиент ПМ — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/klient-pm-spravka-po-komponentu-aX6) - [Требования к рабочим станциям пользователей](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-rabocim-stanciiam-polzovatelei)