# Сетевой агент

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

## Цель

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

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

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

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

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

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

### Онлайн-установка

Для установки сетевого агента Мониторинга выполните следующую команду:
```
sudo curl -L https://.printum.io/box/agent/install.sh | sudo IP_ADDRESS=<ip> TOKEN=<token> bash
```
где:
- **\<ip\>** — IP-адрес сервера, на котором установлен модуль Мониторинга;
- **\<token\>** — токен сетевого агента, сгенерированный в Личном кабинете на этапе подготовки.

После выполнения команды установочный скрипт автоматически:
- загрузит дистрибутив сетевого агента;
- выполнит установку;
- запустит сервис агента.

### Установка без интернета 

Скачайте дистрибутив агента и скрипт установки для Linux. Пондобятся:
- дистрибутив агента `agent-linux-x.x.x.tar.gz`, где `x.x.x` ­– версия агента.
- скрипт установки `install.sh`.

Ссылку на последнюю версию агента и скрипт установки предоставляет техподдержка по запросу. После перемещения скачанных файлов на сервер выполните следующие команды из директории на сервере с пермещенными файлами:
```
mv agent-linux-x.x.x.tar.gz /tmp/agent-linux-x.x.x.tar.gz
sudo AGENT_VERSION=x.x.x IP_ADDRESS=<ip> TOKEN=<token> bash ./install.sh 
```
где:
- **\<ip\>** — IP адрес сервера, на котором установлен Мониторинг;
- **\<token\>** — Токен сетевого агента, созднный ранее;
- **x.x.х** — номер устанавливаемой версии.

После запуска команды скрипт установит и запустит сетевого агента. 

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

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

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

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

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

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

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

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

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

- [Установка Сетевого агента на Windows](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-setevogo-agenta-na-windows)
- [Обновление Сетевого агента на 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)

# Установка Сетевого агента на 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)