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