Сетевой агент
- Установка Сетевого агента на Linux
- Установка Сетевого агента на Windows
- Обновление Сетевого агента на Linux
- Обновление Сетевого агента на Windows
Установка Сетевого агента на Linux
Цель
Установка дополнительного сетевого агента мониторинга на сервер под управлением ОС Linux.
Предусловия
- Установлен модуль Мониторинга
- Сгенерирован токен сетевого агента в Личном кабинете (раздел "Инвентаризация" → "Сетевые агенты").
Подготовка: получение токена сетевого агента
- Перейдите в Личном кабинете в "Интеграции" → "Сетевые агенты".
- Нажмите кнопку "Добавить".
- В открывшемся окне введите название сетевого агента и нажмите "Продолжить".
- Появиться запись с сетевым агентом. У агента отобразиться сгенерированный токен.
- Полученный токен используйте далее при установке сетевого агента.
Шаги установки
Онлайн-установка
Для установки сетевого агента Мониторинга выполните следующую команду:
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
- Обновление Сетевого агента на Linux
- Обновление Сетевого агента на Windows
Установка Сетевого агента на Windows
Цель
Установка дополнительного сетевого агента мониторинга на сервер под управлением ОС Windows.
Предусловия
- Установлен модуль Мониторинга
- Сгенерирован токен сетевого агента в Личном кабинете (раздел "Инвентаризация" → "Сетевые агенты").
Что потребуется
Дистрибутив агента для Windows agent-win-x.x.x.zip (ссылку предоставляет техподдержка по запросу).
Подготовка: получение токена сетевого агента
- Перейдите в Личном кабинете в "Интеграции" → "Сетевые агенты".
- Нажмите кнопку "Добавить".
- В открывшемся окне введите название сетевого агента и нажмите "Продолжить".
- Появиться запись с сетевым агентом. У агента отобразиться сгенерированный токен.
- Полученный токен используйте далее при установке сетевого агента.
Шаги установки
Шаг 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
- Обновление Сетевого агента на Linux
- Обновление Сетевого агента на 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
- Установка Сетевого агента на Windows
- Обновление Сетевого агента на 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
Ожидаемый результат
- Сетевой агент обновлён без ошибок.
- В Личном кабинете → "Интеграции" → "Сетевые агенты" обновлены данные по версии агента.
Как проверить установку
Зайдите в панель Личный кабинет → "Интеграции" → "Сетевые агенты. Для сетевого агента в поле Версия указана версия, на которую производилось обновление.