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).
  • Клиентский ключ из раздела «Клиентские ключи» в панели администратора Мониторинга.

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

Войдите в панель администратора Мониторинга. В разделе «Локальные принтеры» найдите пункт «Клиентские ключи», нажмите кнопку «Добавить».

Заполните поля:

  • Название — имя ключа (любое значение).
  • Ключ — произвольная строка формата UUID (********-****-****-****-************), например 5f17bc69-e37e-47ce-b025-60a57dcd20b1. Заполнять не требуется — генерируется автоматически.
  • Описание — подробная информация, необязательное поле.
  • Включен — должен быть активирован (установлена галочка).
  • Компания — выбрать компанию, к которой будет привязан ключ.

Нажмите кнопку «Сохранить». Ключ отобразится в таблице «Клиентские ключи».

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

Шаг 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/current/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.

Next steps

  • «Обновление Локального агента на Windows»
  • «Удаление Локального агента на Windows»

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

ОшибкаПричинаРешение
Локальные принтеры меняют своё название после печати документов Неактуальные задания печати в спулере рабочей станции, на которой работает локальный агент 1. Открыть командную строку с правами администратора, перейти в C:\Windows\System32\spool\PRINTERS. 2. Остановить спулер: net stop spooler. 3. Удалить файлы: del *.shd и del *.spl. 4. Запустить спулер: net start spooler

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

  • Локальный агент — справка по компоненту
  • Установка Локального агента на Windows — групповые политики
  • Обновление Локального агента на Windows
  • Удаление Локального агента на Windows
Back to top