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

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

# Обновление Сетевого агента на Linux

## Цель

Офлайн-обновление сетевого агента мониторинга на сервере под управлением ОС Linux.

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

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

## Шаги обновления

### Шаг 1. Скачайте дистрибутив

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

### Шаг 2. Выполните обновление

После скачивания дистрибутива `agent-linux-x.x.tar.gz` (где `x.x` – актуальная версия агента) выполните команды:
```
tar xf agent-linux-x.x.tar.gz
cd printum-agent
sudo bash ./update.sh

```

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

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

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

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

---

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

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

---

# Обновление Сетевого агента на Windows

## Цель

Офлайн-обновление сетевого агента мониторинга на сервере под управлением ОС Windows.

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

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

## Шаги обновления

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

Запросите ссылку на архив стабильной версии сетевого агента у специалистов технической поддержки Printum. Скачайте архив `agent-win-x.x.x.zip` (где `x.x.x` – актуальная версия агента).

### Шаг 2. Распакуйте архив

Распакуйте архив в удобную директорию, например в `C:\Printum\agent-win-x.x.x`.

### Шаг 3. Сконфигурируйте файл config.env

Перейдите в директорию с распакованным агентом.

Откройте файл `config.env` в текстовом редакторе и укажите следующие параметры:

```
TOKEN=<token>
BACKEND=http://<address_mon>:8000
```
где:

- **TOKEN** — уникальный идентификатор агента. Получить его можно в Личном кабинете → "Интеграции" → "Сетевые агенты".
- **BACKEND** — IP-адрес сервера мониторинга. Важно указывать слэш (/) в конце пути: `http://<IP_M>:8000/`.

### Шаг 4. Запустите установку агента

Откройте командную строку от имени администратора, перейдите в директорию агента:
```
cd C:\Printum\agent-win-x.x.x
```

Выполните команду:
```
install.bat
```

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

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

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

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


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

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