Skip to main content

Установка Локального агента на Windows

Цель

Установить Локальный агент мониторинга на рабочую станцию Windows с подключённым локальным МФУ для учёта заданий печати.

Предусловия

  • Сервер Мониторинга установлен и доступен по сети.
  • Получен клиентский ключ из панели администратора Мониторинга (см. ниже "Подготовка: получить клиентский ключ").
  • Командная строка запущена от имени администратора.

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

  • Дистрибутив Локального агента, содержащий 5 файлов в одной директории:
    • установочный msi-пакет файл конфигурации в формате XML: Printum.JobTracking.WindowsService.exe.config.
    • скрипт установки: install.bat
    • скрипт удаления: uninstall.bat
    • файл редактирования реестра: word_hotfix.reg
  • IP-адрес (или имя) сервера Мониторинга и порт (8000 для http, 8001 для https).
  • Клиентский ключ из раздела "Клиентские ключи" в панели администратора Мониторинга.

Подготовка: получить клиентский ключ

  1. Войдите в панель администратора Мониторинга.
  2. Перейдите в раздел "Локальные принтеры" → "Клиентские ключи", нажмите кнопку «Добавить».
  3. Заполните поля:
  • Название — имя ключа (любое значение).
  • Ключ — произвольная строка формата UUID ( ********-****-****-****-************ ), например 5f17bc69-e37e-47ce-b025-60a57dcd20b1. Заполнять не требуется — генерируется автоматически.
  • Описание — подробная информация (необязательное поле).
  • Включен — должен быть активирован (установлена галочка).
  • Компания — выбрать компанию, к которой будет привязан ключ.
  1. Нажмите кнопку "Сохранить".
  2. Ключ отобразится в таблице "Клиентские ключи".

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

Шаг 1. Сохранить файлы дистрибутива

Сохраните на локальный диск компьютера, к которому подключено устройство, файлы локального агента. Все 5 файлов должны находиться в одной директории.

Шаг 2. Настроить конфигурационный файл

Откройте конфигурационный файл Printum.JobTracking.WindowsService.exe.config и отредактируйте параметры:

<setting name="PrintumURL" serializeAs="String">
<value>http://127.0.0.1:8000/localprinter/</value>
</setting>
<setting name="PrintumClientKey" serializeAs="String">
<value>cb074c67-30a3-43c2-9ffc-26753f6441c2</value>
</setting>
  • PrintumURL — замените http://127.0.0.1:8000 на IP-адрес (или имя) системы мониторинга и действующий порт. Порт может быть 8000 для http или 8001 для https схемы подключения.
  • PrintumClientKey — замените cb074c67-30a3-43c2-9ffc-26753f6441c2 на значение, полученное в разделе "Подготовка: получить локальный ключ".
  • SerialNumber — серийный номер МФУ, генерируется автоматически. Заполнять не нужно.

Для работы по протоколу и порту https-8001 добавьте CA-сертификат из сервера с Мониторингом. Текущий используемый CA-сертификат находится в директории /home/printum/certs/ca/printum_ca.crt . Сохраните файл.

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

Запустите от имени администратора установщик install.bat.

При успешном завершении установки в консоли появится сообщение:

Install finished. Msiexec log saved in install.log.

Шаг 4. Проверить работоспособность

Запустите печать любого документа на подключённом устройстве.

Зайдите в Личный кабинет, раздел "Управление" → "Устройства". В панели фильтров укажите период, в который попадает сегодняшний день. Проверьте, что устройство появилось в списке.

Зайдите в Личный кабинет, раздел "Аналитика" → "Отчеты по устройствам". Проверьте, что напечатанные страницы были учтены.

Устройства, подключённые по USB, в конце строки помечаются значком USB.

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

  • Установка завершается с сообщением Install finished.
  • Локальный МФУ отображается в Личном кабинете Мониторинга с отметкой USB.
  • Задания печати учитываются.

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

Распечатать тестовый документ и убедиться, что устройство появилось в Личном кабинете → "Управление" → "Устройства", задание появилось в Личном кабинете → "Управление" - "Задания".

Примечание: В некоторых версиях MS Word (например, v.14, MS Office 10 32-bit) неправильно прописывается число копий, отправленных на печать. Microsoft рекомендует устанавливать последние сервис-паки, либо самостоятельно добавлять ключ в реестр Windows. Для этого в состав пакета установки включён файл правки реестра word_hotfix.reg — необходимо отредактировать его в соответствии с установленной версией MS Word и запустить от имени администратора. После этого перезапустить MS Word.

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

Локальные принтеры меняют своё название после печати документов. Проблема связана с неактуальными заданиями печати в спулере рабочей станции, на которой работает локальный агент.

Для исправления:

  1. Откройте командную строку с правами администратора, передите в C:\Windows\System32\spool\PRINTERS.
  2. Остановите спулер:
net stop spooler
  1. Удалите файлы:
del *.shd
del *.spl
  1. Запустите спулер:
net start spooler

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

Back to top