# Установка Сетевого агента на Windows

## Цель

Установка дополнительного сетевого агента мониторинга на сервер под управлением ОС Windows. 

## Предусловия

- Установлен модуль Мониторинга 
- Сгенерирован токен сетевого агента в Личном кабинете (раздел "Инвентаризация" → "Сетевые агенты").

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

Дистрибутив агента для Windows `agent-win-x.x.x.zip` (ссылку предоставляет техподдержка по запросу).

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

1. Перейдите в Личном кабинете в "Интеграции" → "Сетевые агенты".
2. Нажмите кнопку "Добавить".
3. В открывшемся окне введите название сетевого агента и нажмите "Продолжить".
4. Появиться запись с сетевым агентом. У агента отобразиться сгенерированный токен.
5. Полученный токен используйте далее при установке сетевого агента.

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

### Шаг 1. Получение дистрибутива

Скачайте дистрибутив агента для Windows, запросив ссылку на последнюю версию у техподдержки.

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

Перед установкой необходимо распаковать архив. Перейдите в появившуюся папку и в файле `config.env` отредактируйте настройки:
- **BACKEND** — это адрес сервера мониторинга, к которому необходимо подключить сетевого агента (обязательный параметр). Адрес должен быть задан таким образом: `BACKEND=http://IP_M:8000/`.
- **TOKEN** — Токен сетевого агента, полученный ранее.

Остальные настройки являются техническими и не требуют изменений в общем случае.

### Шаг 3. Установка агента

Для запуска установки агента откройте командную строку от имени администратора, перейдите в папку, появившуюся при распаковке архива, и введите:
```
install.bat
```

Агент установится в директорию `С:\Program Files\printum\agent` как служба Windows и автоматически запустится.

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

- Агент установлен как служба Windows и автоматически запущен.
- В Личном кабинете → "Интеграции" → "Сетевые агенты" обновлены данные по агенту.

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

Зайдите в панель Личный кабинет → "Интеграции" → "Сетевые агенты. Для сетевого агента должны быть заполнены поля **IP-адрес** и **Версия**

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

Обнаружены не все печатающие устройства.

Причиной может быть:
- Неверно указан IP-адрес МФУ в локации.
- Агент не опрашивает локацию.
- SNMP отключён на устройстве.

Проверьте:
- IP-адрес в настройках локации (Личный кабинет → "Инвентаризация" → "Локации").
- Убедитесь, что локация указана в Личном кабинете → "Интеграции" → "Сетевые агенты" для нужного сетевого агента.
- Отдает ли принтер данные по SNMP: `snmpwalk -v 2c -c public <printer-ip>`.
  
---

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

- [Установка Сетевого агента на Linux](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-setevogo-agenta-na-linux)
- [Обновление Сетевого агента на Linux](https://wiki.printum.io/books/3-ustanovka/page/obnovlenie-setevogo-agenta-na-linux)
- [Обновление Сетевого агента на Windows](https://wiki.printum.io/books/3-ustanovka/page/obnovlenie-setevogo-agenta-na-windows)