Skip to main content

Установка Клиента ПМ на 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://<server-ip>: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

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

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

  • 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://<server-ip>: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

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

Back to top