Установка Локального агента на 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. Заполнять не требуется — генерируется автоматически.
   • Описание — подробная информация (необязательное поле).
   • Включен — должен быть активирован (установлена галочка).
   • Компания — выбрать компанию, к которой будет привязан ключ.
4. Нажмите кнопку "Сохранить".
5. Ключ отобразится в таблице "Клиентские ключи".

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

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

3. Удалите файлы:

del *.shd
del *.spl

4. Запустите спулер:

net start spooler 

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

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