Настройка и управление программным агентом

Настройка агента

Настройка основновных параметров работы программного агента( в т.ч. и программного агента устанавливаемого на устройства Метротек), а именно: размер лог-файлов(для Linux), wiSlaUrl и аутентификация на портале  предлагается при установке пакетов с агентами. Если эти параметры в процессе установки не настроены пользователем, то будут использоваться значения по умолчанию.

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

• Для Linux: скрипт slamon-conf и скрипт slamon-update
• Для Windows: скрипт slamon-conf.bat(аналог скрипта slamon-conf для Linux), приложения: Slamon-Agent Account

Скрипт slamon-conf(slamon-conf.bat)

Предназначен для настройки агента из командной строки, либо получение данных о текущих настройках. При запуске скрипта без параметров он выдает подсказку. При запуске скрипта с параметром будет возвращено текущее значение этого параметра(настройки). При запуске скрипта с парметром и значение переданному параметру(настройке) будет присвоено переданное значение.

 Ниже приведен пример работы скрипта для Linux-агента X86_64. Для других агентов основной набор команд такой же, дополнительно могут присутствовать специфичные для устройства описание которых имеется в подсказке

При вызове slamon-conf без параметров он возвращает подсказку.

USAGE:
  /usr/local/bin/slamon-conf [option] [value]

Slamon configuration utility.

OPTIONS:
  agent-version                            print product version                                    
  has-hash-based-balancing-data-send       true in case hash based approach is used for choice server to send data and autoregistration request
  inter-life-time                          intermediate results storing duration: 60-3600 seconds. Only for sending results issues
  log-level                                logging level: 'error', 'warning', 'notice', 'information', 'debug', 'trace'
  log-url                                  FTP URL for log files saving: ftp://[user]:[password]@[ftp-server]/[path]
  name                                     agent name                                               
  send-period                              data sending period: 10-60 seconds                       
  smooth-start-tests                       keeps a minimal period between permanent test additions to work process. Possible values: "yes" or "no"
  source-ip                                autoregistration source IP                               
  update-url                               FTP or HTTP(S) URL for automatic update: [ftp | http(s)]://[user]:[password]@[server-address]/[path]
  url                                      autoregistration URL                                     
  url-addition                             additional autoregistration URL                          

Описание настроек

Настройка	Описание
agent-version	Возвращает текущую версию установленного программного агента. Эта настройка не можут быть изменена
has-hash-based-balancing-data-send	true если при отправке запросов авторегистрации или данных постоянно выбирается новый адрес из списка адресов(для авторегистрации или данных).  По умолчанию это значение установлено в false
inter-life-time	Время хранения в секундах промежуточных результатов(в реальном времени)  тестов для дальнейшей отправки,  если возникли проблемы при отправке. По умолчанию - 60 секунд
log-level	Уровень логирования: 'error', 'warning', 'notice', 'information', 'debug', 'trace'
log-url	Настройки досутпа ftp-серверу для сохранения логов агента по запросу с wiSla
name	Имя агента под которым он отображается на wiSla
send-period	Период между отправками данных по тестам в секундах(10 -  60). По умолчанию 60 секунд. В случае отсутствия данных по тестам на wiSla отправляется пустой набор данных т.к. этот механизм еще используется для получения от wiSla команды на внеплановую авторегистрацию для управления агента с wiSla.
smooth-start-tests	В случае 'yes' добавление теста разделено на два этапа сперва загрузка теста в агент, затем - через определнное время- его запуск. Это сделано для избежания проблемы долгого добавления большого количества тестов. Когда каждый тест  загружается и сразу запускается это влияет на длительность запуска всех тестов, а так-же на показатели уже работающих тестов. По умолчаниб значение 'no'
source-ip	Значение исходящего алреса для отправки запросов авторегистрации
update-url	Настройка доступа к серверу для обновления агента.  Для обновления можент использоваться как FTP так и HTTP протокол
url	Настройка wiSlaURL используемого для авторегистрации
url-addition	Настройка дополнительных wiSlaURL, которые будут использоваться в случае недоступности основного. В случае если  has-hash-based-balancing-data-send - true дополнительные wiSlaURL будут использоваться периодически наряду с основным.

Скрипт slamon-account

Скрипт используется для аутентификации агента на портале. При его запуске выдается подсказка

Usage: /usr/local/bin/slamon-account {show|set|del|help}

Параметр	Описание
show	Показывает текущие настройки аутентификации
set	Устанавливает настройки аутентификации с проверкой их корректности
del	Удаляет текущие настройки аутентификации
help	Выдает подсказку выше

 

Приложение Slamon-Agent Account

Приложение для аутентификации для Windows-агента. Входит в набор приложений для управления работы агента Windows.
С его помощью можно установить настройки аутентификации с проверкой их ворректности

Приложение NTP Configuration

Приложение для настройки используемых ntp-серверов не является непосредственным инструментом настройки самого агента, тем не менее входит в набор приложений для управления работы агента Windows. 
С его помощью можно добавлять серверы для ntp-синхронизации устройства на котором установлен агент.

Остановка и запуск работы агента

Остановка и запуск работы агента на OS симейства Linux

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

• Для запуска: update-service --add /etc/sv/slamond/
  
• Остановки: update-service --remove /etc/sv/slamond/

При этом необходимо предварительно открыть на запись корневой каталог: mount / -o remount,rw.
Вышеперечисленные дествия выполняются под пользователем root

Для остальных агентов используется ситандартная команда управления службами systemclt:

• Для запуска: systemctl start slamon
• Для остановки: systemctl stop slamon

Остановка и запуск работы  агента на Windows

Для остановки и запуска работы используется приложение Slamon-Agent Control, которое входит в набор приложений для управления работы агента Windows.

Удаление агента 

Для Linux используется стандартный механизм с использованием стандартных менеджеров управления устанорвочными пакетами: dpkg или rpm

Для Windows необходимо использовать приложение Uninstall входящее набор приложений для управления работы Windows-агента.