Установка Локального агента на 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"> http://127.0.0.1:8000/localprinter/ <setting name="PrintumClientKey" serializeAs="String"> cb074c67-30a3-43c2-9ffc-26753f6441c2 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


Revision #9
Created 2026-05-09 12:26:05 UTC by DD
Updated 2026-05-18 19:17:29 UTC by DD