Linux

Агент SAYMON для Linux поставляется в виде установочного скрипта и пакетов для пакетных менеджеров Ubuntu/Debian и Red Hat/Fedora. Оба способа установки не требуют интернета.

В примерах к этой инструкции пакеты и установочные скрипты скачиваются отдельной командой с помощью wget. Чтобы установить агент на хост без доступа к интернету нужно скачать установщики агента заранее и вручную перенести его на нужный хост.

Оба способа установки поддерживают автоматическое обновление.

При установке агента в системе автоматически создаётся пользователь saymon, от имени которого будет работать агент.

Если в системе уже есть такой пользователь, то работа агента будет происходить от его имени.

После установки автоматически запускается сервис saymon-agent.

Установка с помощью скрипта

Для установки агента с помощью установочного скрипта нужно получить скрипт для нужной версии агента и запустить его на нужном устройстве:

$wget https://downloads.cpult.ru/agent/v5.1.1/saymon-agent-5.1.1-linux-x64-installer.sh
$sudo sh saymon-agent-5.1.1-linux-x64-installer.sh

Для каждой архитектуры системы существует свой установочный скрипт. При установке и обновлении скриптом неподходящей архитектуры агент будет перезаписан, но сервис не запустится. Исправить некорректную установку можно обновив агент скриптом для нужной архитектуры.

При запуске скрипта пользователю будет показано интерактивное меню, где он может выбрать способ конфигурации агента при установке или отменить установку:

Unpacking the distribution archive... OK
Please select how you want to configure SAYMON Agent:
1) Manual configuration.
2) Auto configuration.
3) Quit without installing.

Ручная конфигурация;
Автоматическая конфигурация;
Завершить работу скрипта без установки агента.

Если скрипт обнаружит установленного агента в папке /opt/saymon-agent, то предложит его обновить. Инструкцию по установке второй копии агента на эту же систему можно найти на странице Установка дополнительных агентов.

Ручная конфигурация

При установке агента с ручной конфигурацией скрипт предлагает пользователю ввести ID агента и адрес сервера, на котором нужно зарегистрировать агента. После этого он распаковывает архив с агентом в папку /opt/saymon-agent, создаёт группу saymon и пользователя saymon, включает сервис saymon-agent в systemd.

Вывод в консоль во время установки с ручной конфигурацией

Unpacking the distribution archive... OK
Please select how you want to configure SAYMON Agent:
1) Manual configuration.
2) Auto configuration.
3) Quit without installing.
Your choice: 1
Please enter agent ID (leave empty or enter 0 for agent ID auto registration): 5e21b752308c3c66d64e072c
SAYMON Agent ID set to '5e21b752308c3c66d64e072c'.
Please enter SAYMON Server address (IP or hostname): 192.168.1.45
SAYMON Server address set to '192.168.1.45'.
Created 'saymon' user group with GID 11813.
Created 'saymon' user with UID 11813.
SAYMON Agent installed to /opt/saymon-agent.
Systemd detected.
SAYMON Agent systemd service installed and enabled.
Start SAYMON Agent service.
SAYMON Agent installation completed.

Автоматическая конфигурация

При установке агента с автоматической конфигурацией скрипт распаковывает архив с агентом в папку /opt/saymon-agent, создаёт группу saymon и пользователя saymon, включает сервис saymon-agent в systemd, а также создаёт стандартный файл конфигурации, который включает автоматическую регистрацию агента на сервере, расположенном по адресу 127.0.0.1. Адрес сервера можно настроить после установки агента.

Unpacking the distribution archive... OK
Please select how you want to configure SAYMON Agent:
1) Manual configuration.
2) Auto configuration.
3) Quit without installing.
Your choice: 2
SAYMON Agent will be installed with agent ID auto registration enabled and default SAYMON server address.
Please edit /opt/saymon-agent/conf/agent.properties if you want to change these settings later.
SAYMON Agent ID set to '0'.
Created 'saymon' user group with GID 11813.
Created 'saymon' user with UID 11813.
SAYMON Agent installed to /opt/saymon-agent.
Systemd detected.
SAYMON Agent systemd service installed and enabled.
Start SAYMON Agent service.
SAYMON Agent installation completed.

При выборе автоматической конфигурации будет сгенерирован следующий файл конфигурации:

#
# SAYMON Agent configuration file.
#

# Value 0 means SAYMON Agent will attempt to register on server automatically.
agent.id=0

#  Secure connection to SAYMON Server. Enabled by default.
server.secure=false

# SAYMON Server address.
server.host=127.0.0.1
# server.port=9092

# Network hosts discovery.
agent.discoveryEnabled=false

# Allows SAYMON Agent to execute custom shell scripts.
agent.scriptsEnabled=true

# SNMP traps receiver.
agent.snmpTrapEnabled=false
# USM username, authentication and privacy password should be 8+ characters long.
# agent.snmpTrapUsmUser=
# agent.snmpTrapUsmAuthenticationPassword=
# agent.snmpTrapUsmPrivacyPassword=

Установка с помощью пакетного менеджера

Для установки агента через пакетные менеджеры нужно получить пакет с версией агента для своего пакетного менеджера (.deb для систем Debian/Ubuntu и .rpm для Red Hat/Fedora) и установить его на нужном устройстве:

$wget https://downloads.cpult.ru/agent/v5.1.1/saymon-agent_5.1.1-cd6973ea_amd64.deb
$sudo dpkg -i saymon-agent_5.1.1-cd6973ea_amd64.deb

$wget https://downloads.cpult.ru/agent/v5.1.1/saymon-agent-5.1.1-cd6973ea.x86_64.rpm
$sudo dnf install saymon-agent-5.1.1-cd6973ea.x86_64.rpm

При успешной установке пакетов, в консоль выведутся следующие сообщения:

Selecting previously unselected package saymon-agent.
(Reading database ... 37334 files and directories currently installed.)
Preparing to unpack saymon-agent_5.1.1-cd6973ea_amd64.deb ...
passwd: password changed.
Unpacking saymon-agent (5.1.1-cd6973ea) ...
Setting up saymon-agent (5.1.1-cd6973ea) ...
You can configure /opt/saymon-agent/conf/agent.properties
Backup directory /opt/saymon-agent.backup found. Also you can restore the configuration from there.
And restart the service
sudo systemctl restart saymon-agent
Start the service
Created symlink /etc/systemd/system/multi-user.target.wants/saymon-agent.service → /etc/systemd/system/saymon-agent.service.

Last metadata expiration check: 0:13:14 ago on Tue 06 Aug 2024 03:36:47 PM MSK.
Dependencies resolved.
==============================================================================================================================================================================
 Package                                   Architecture                        Version                                        Repository                                 Size
==============================================================================================================================================================================
Installing:
 saymon-agent                              x86_64                              5.1.1-cd6973ea                                 @commandline                               90 M

Transaction Summary
==============================================================================================================================================================================
Install  1 Package

Total size: 90 M
Installed size: 186 M
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
  Preparing        :                                                                                                                                                      1/1
  Running scriptlet: saymon-agent-5.1.1-cd6973ea.x86_64                                                                                                                   1/1
passwd: password changed.

  Installing       : saymon-agent-5.1.1-cd6973ea.x86_64                                                                                                                   1/1
  Running scriptlet: saymon-agent-5.1.1-cd6973ea.x86_64                                                                                                                   1/1
You can configure /opt/saymon-agent/conf/agent.properties
Backup directory /opt/saymon-agent.backup found. Also you can restore the configuration from there.
And restart the service
sudo systemctl restart saymon-agent
Start the service
Created symlink /etc/systemd/system/multi-user.target.wants/saymon-agent.service → /etc/systemd/system/saymon-agent.service.


Installed:
  saymon-agent-5.1.1-cd6973ea.x86_64

Complete!

Регистрация агента

При установке агента на хост, происходит регистрация агента. После регистрации агента на сервере создается новый объект класса Saymon Agent. Идентификатор созданного объекта (agentId) передается агенту. На хосте с агентом создается файл registration.json (/opt/saymon-agent/storage), в котором указан данный идентификатор.

Чтобы инициировать процедуру получения agentId повторно (например, если нужно подключить агента к другому серверу), нужно удалить файл registration.json и перезапустить службу агента.

Логирование

По умолчанию лог-файлы агента создаются в директории /var/log/saymon.

При необходимости можно включить централизованное логирование агента через SYSLOG в файле /opt/saymon-agent/conf/logback-upstart.xml.

Работа службы агента

Узнать состояние, запустить, перезапустить и остановить службу агента можно с помощью следующих команд:

$ sudo service saymon-agent status
$ sudo service saymon-agent start
$ sudo service saymon-agent restart
$ sudo service saymon-agent stop

Поддерживаемые версии Linux

Агент работает со следующими версиями ОС Linux:

Ubuntu Linux;
Red Hat Enterprise Linux;
CentOS Linux;
Debian 8 "Jessie" (для пользователей Raspberry Pi).