# Установка Локального агента на 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 
```

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

- [Локальный агент — справка по компоненту](https://wiki.printum.io/books/2-komponenty-sistemy/page/lokalnyi-agent-spravka-po-komponentu)
- [Установка Локального агента на Windows — групповые политики](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-lokalnogo-agenta-na-windows-gruppovye-politiki)
- [Обновление Локального агента на Windows](https://wiki.printum.io/books/3-ustanovka/page/obnovlenie-lokalnogo-agenta-na-windows)
- [Удаление Локального агента на Windows](https://wiki.printum.io/books/3-ustanovka/page/udalenie-lokalnogo-agenta-na-windows)