Клиент ПМ

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

Цель

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

Предусловия

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

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

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

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

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

Шаг 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):

Для сохранения настроек в файле понадобятся права администратора. При указании правильных настроек служба самостоятельно запустится в течение одной минуты. Если этого не произошло, перезапустите службу Printum Optimize Service через компоненты services (Службы).

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

Зайдите в «Устройства и принтеры», нажмите «Свойства» принтера «Printum». В открывшемся окне выберите «Пробная печать». Документ должен попасть в локальную очередь печати и далее исчезнуть, когда будет обработан службой.

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

Если задание на сервере не появилось, проверьте, что на компьютере не запущены программы из списка конфликтующих программ.

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

Как проверить установку

Примечание

Следующие шаги

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

Ошибка Причина Решение
При установке появляется системное уведомление о сертификате драйвера Отсутствует или некорректна цепочка сертификатов 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

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

Установка Клиента ПМ на Windows — групповые политики

Цель

Автоматическая установка Клиента ПринтМенеджер на рабочие станции Windows через механизм групповых политик (GPO) без ручного вмешательства на каждый компьютер.

Предусловия

Создание политик

Политика 1. Установка сертификата и разрешение установки драйвера

Название политики: pm_client_pre-install

  1. Откройте "Управление групповой политикой" → "Объекты групповой политики", нажмите "Создать".
  2. Выберите созданную политику и нажмите "Изменить".
  3. Перейдите: "Конфигурация компьютера" → "Политики" → "Конфигурация Windows" → "Параметры безопасности" → "Политики открытого ключа" → "Доверенные издатели".
  4. В правой части окна нажмите правой кнопкой мыши и выберите "Импорт" — откроется мастер импорта сертификатов.
  5. Убедитесь, что "Расположение хранилища" выбрано как "Локальный компьютер". Нажмите "Далее".
  6. Укажите сетевой путь до сертификата printum_globalsign.cer. Нажмите "Далее".
  7. Убедитесь, что "Хранилище сертификатов" выбрано как "Доверенные издатели". Нажмите "Далее", затем "Готово".
  8. Перейдите: "Конфигурация компьютера" → "Политики" → "Административные шаблоны" → "Система" → "Установка драйвера".
  9. Откройте параметр "Разрешать пользователям, не являющимся администраторами, устанавливать драйверы для этих классов установки устройств". Переключите состояние в "Включено". В поле классов добавьте значение:
    • 4D36E979-E325-11CE-BFC1-08002BE10318
    • 4658EE7E-F050-11D1-B6BD-00C04FA372A7
  10. Эти последовательности задают класс драйверов для Printum XPS драйвера. Нажмите "ОК" → "ОК".

Политика 2. Установка MSI-пакета

Название политики: pm_client_install

  1. Откройте "Управление групповой политикой" → "Объекты групповой политики", нажмите "Создать".
  2. Выберите созданную политику и нажмите "Изменить".
  3. Перейдите: "Конфигурация компьютера" → "Политики" → "Конфигурация программ" → "Установка программ".
  4. В правой части нажмите правой кнопкой мыши: "Создать" → "Пакет". Укажите сетевой путь до файла MSI-пакета.
  5. Выберите метод развертывания программ — "Особый". Перейдите на вкладку "Развертывание" → "Дополнительные поля" и выберите "Не использовать языковые установки при развертывании". Нажмите "ОК".
  6. MSI-пакет должен соответствовать разрядности ОС целевых компьютеров.
  7. Создайте отдельные политики для 32-битных и 64-битных систем с привязкой к соответствующим OU.

Применение политик к OU

  1. Выберите OU с целевыми компьютерами, нажмите правой кнопкой мыши → "Связать существующий объект групповой политики".
  2. Выберите обе созданные политики и нажмите "ОК".
  3. Перейдите на вкладку "Связанные объекты групповой политики". Убедитесь в правильном порядке применения. Политики обрабатываются снизу вверх: политика с наименьшим "Порядком ссылок" выполняется последней (наивысший приоритет).

Порядок должен быть:

  1. pm_client_pre-install — выполняется первой (более высокий порядок ссылок)
  2. pm_client_install — выполняется второй (порядок ссылок = 1, наивысший приоритет)

Политики применятся автоматически в течение от нескольких минут до нескольких часов (зависит от инфраструктуры). Установка произойдёт при перезагрузке ПК и входе пользователя в Windows.

Для принудительного применнеия политики выполните из командной строки:

gpupdate /force

После перезагрузки убедитесь, что служба PrintumOptimizeService находится в состоянии "Выполняется".

Копирование настроек клиента через GPO

Для массового изменения настроек (адрес сервера, ключ доступа) из файла settings.yml создайте дополнительную политику.

  1. Перейдите: "Конфигурация компьютера" → "Настройка" → "Конфигурация Windows" → "Файлы". Создайте новый файл.
  2. Выберите действие "Заменить", в "Исходные файлы" укажите сетевой путь до файла settings.yml, в "Конечный файл" укажите путь, куда установлена программа. Обычно это C:\Program Files\printum\printmanager_client\settings.yml.
  3. Привяжите созданную политику к тем же компьютерам. Порядок ссылок должен быть 1 (выполняется после установки программы).

Обновление Клиента ПМ

Обновление выполняется аналогично установке по разделу "Политика 2. Установка MSI-пакета". Предварительно удалять предыдущую версию не нужно — установщик самостоятельно удалит предыдущие версии, сохранив настройки в файле settings.yml.

Диагностика и устранение неполадок

Симптом Где проверять
МФУ не появился Установка драйвера — проверьте применение политики 1, наличие сертификата в Trusted Publishers
Служба не запустилась MSI-установка — проверьте применение политики 2, журнал событий
Драйвер заблокирован Сертификат в Trusted Publishers — откройте "Просмотр событий" (eventvwr), "Журналы Windows" → "Приложения", записи с источником Group Policy Files
GPO не применяется Привязка OU — убедитесь, что OU с компьютерами связана с обеими политиками и порядок применения корректен

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

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

Ошибка Причина Решение
Клиент ПМ не устанавливается через GPO. Некорректная цепочка сертификатов или ошибка применения политики. Проверить через eventvwr → "Журналы Windows" → "Приложения", записи с источником Group Policy Files. Изучить ошибки и при необходимости передать в техподдержку
Сертификат драйвера не установлен на целевом компьютере Политика pm_client_pre-install не применилась или применилась некорректно. В certlm.msc → "Доверенные издатели" проверить наличие сертификата "ООО Принтум". Проверить вкладку "Путь сертификации" — цепочка должна состоять из трёх ступеней и не содержать ошибок.

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

Установка Клиента ПМ на macOS

Цель

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

Предусловия

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

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

Шаг 1. Установить Python 3.10

Необходимо самостоятельно установить Python версии 3.10. Установщик можно найти на официальном сайте python.org: https://www.python.org/ftp/python/3.10.10/python-3.10.10-macos11.pkg

Шаг 2. Установить xcode-select

Необходимо установить xcode-select из терминала:

xcode-select --install

Шаг 3. (Рекомендуется) Установить GhostScript

Для корректной работы рекомендуется установить GhostScript. Для этого:

brew install GhostScript

Шаг 4. Скачать дистрибутив

Установка выполняется аналогично Linux, но с другим дистрибутивом.

Скачайте дистрибутив https://download.printum.io/distrib/printmanager-client/printmanager_client-macos-x.y.z.tar, где x.y.z — актуальная версия.

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

Выполните команды аналогично инструкции для Linux:

cd printmanager_client-macos-x.y.z
sudo PRINTMANAGER_BASE_URL=http://<server-ip>:8010 PRINTMANAGER_ACCESS_TOKEN=<токен с сервера> bash ./install.sh

Шаг 6. Проверить статус службы

Чтобы проверить, что служба запустилась, используйте команду:

sudo launchctl print system/io.printum.printmanager-client

В полученном ответе проверьте наличие поля pid, значение которого — число. Если поле отсутствует, значит служба не запустилась.

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

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

Удаление Клиента ПМ на Windows

Цель

Удалить Клиент ПМ с рабочей станции Windows.

Предусловия

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

Шаги удаления

Вариант 1. Удаление при наличии исходного MSI-файла

Запустите командную строку от имени администратора, перейдите в папку с MSI-файлом и выполните:

msiexec /x printmanager_client-a.b.c-win.msi /qn /L uninstall.log /norestart

где printmanager_client-a.b.c-win.msi — имя MSI файла.

Вариант 2. Удаление при утере исходного MSI-файла

Если исходный MSI был утерян, используйте команду:

msiexec /x {3ec25e07-2e29-43d1-af15-efacfedbaabf} /qn /L uninstall.log

где вместо последних символов указывается номер установленной версии.

Например, для удаления продукта с версией 1.2.3 запустите команду:

msiexec /x {3ec25e07-2e29-43d1-af15-efacfedba123} /qn /L uninstall.log

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

Как проверить удаление

Обновление Клиента ПМ на Windows

Цель

Обновить Клиент ПМ на рабочей станции Windows до актуальной версии.

Предусловия

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

Шаги обновления

Шаг 1. Получить и скачать актуальный дистрибутив

Обновление ПО осуществляется аналогично установке. Запросите у технической поддержки ссылку на актуальную версию дистрибутива и скачайте его на устройство.

Шаг 2. Запустить обновление

Запустите командную строку от имени администратора и выполните команду:

msiexec /i printmanager_client-a.b.c-win.msi /qn /L install.log

При обновлении менять стандартный путь установки не нужно. Предварительно удалять предыдущую версию не нужно. Установщик самостоятельно удалит предыдущие версии продукта, сохранив настройки в файле settings.yml.

Обновление через групповые политики

Обновление через групповые политики проходит так же, как и установка. Воспользуйтесь разделом "Установка MSI пакета" со страницы Установка клиента ПМ на Windows — групповые политики.

Предварительно удалять предыдущую версию не нужно. Установщик самостоятельно удалит предыдущие версии клиента, сохранив настройки в файле settings.yml.

Для обновления настроек проверки HTTPS-сертификата замените содержимое файла сертификатов в папке с программой:

C:\Program Files\printum\printmanager_client\lib\certifi\cacert.pem

Содержимое файла должно соответствовать описанному в разделе "Настройка проверки HTTPS-сертификата для службы в Windows" страницы Настройка SSL для служб Мониторинга.

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

Как проверить обновление

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

Удаление Клиента ПМ на Linux

Цель

Удалить Клиент ПМ с рабочей станции Windows.

Предусловия

Скрипт для удаления находится внутри дистрибутива.
Если вы его удалили, скачайте и распакуйте дистрибутив повторно.

Скачивание дистрибутива

curl -O https://s3.printum.io/distrib/printmanager-client/printmanager_client-linux-x.x.tar
tar xf printmanager_client-linux-x.x.tar

Запуск удаления

cd printmanager_client-linux-x.x
sudo ./uninstall.sh

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

Как проверить удаление

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

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

Цель

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

Предусловия

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

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

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

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

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

где:

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

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

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

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

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

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

Примечание

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

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

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

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