SAYMON

From Wiren Board
This is the approved revision of this page, as well as being the most recent.

SAYMON - отечественная платформа для сбора данных с устройств, мониторинга их состояния и управления.

В данной статье описаны инструкции по установке SAYMON Agent и конфигурации MQTT-брокера на примере контроллера Wiren Board 6.


Установка SAYMON Agent

Введение

Установка SAYMON Agent на контроллер Wiren Board может потребоваться для сбора основных параметров о работе устройства, например, количестве свободного места, памяти, или для выполнения каких-либо пользовательских скриптов.

Установка

Скачиваем архив с агентом по ссылке и распаковываем его в папку

/opt/saymon-agent/

Скачиваем архив с JDK по ссылке (попросит регистрации на сайте), распаковываем архив в папку temp и из неё полностью копируем директорию jre в папку

/opt/saymon-agent/

Затем выполняем следующие команды:

useradd -M -r -s /bin/false -K MAIL_DIR=/dev/null saymon
chown -R saymon:saymon /opt/saymon-agent
cp /opt/saymon-agent/systemd/* /etc/systemd/system
systemctl enable saymon-agent
service saymon-agent start

Конфигурация агента

При необходимости отредактируйте файл настроек агента:

/opt/saymon-agent/conf/agent.properties

Лог-файлы

Логи агента пишутся в директорию

/var/log/saymon

При необходимости логирование отключается в файле

/opt/saymon-agent/conf/logback-upstart.xml

Для этого достаточно поменять содержимое секции

<root level="INFO">
<appender-ref ref="FILE-INFO"/>
<!--<appender-ref ref="FILE-DEBUG"/>-->
<!--<appender-ref ref="SYSLOG"/>-->
</root>

на

<root level="INFO">
<!--<appender-ref ref="FILE-INFO"/>-->
<!--<appender-ref ref="FILE-DEBUG"/>-->
<!--<appender-ref ref="SYSLOG"/>-->
</root>

Работа сервиса

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

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

Настройка MQTT-моста (MQTT-bridge)

Подробности о работе MQTT на контроллерах Wiren Board можно узнать в соответствующей статье - MQTT. Здесь же мы приведем пример конфигурации моста для отправки данных на сервер SAYMON и управления устройствами со стороны сервера.

На контроллере в конец файла

/etc/mosquitto/mosquitto.conf

необходимо добавить следующие строки:

connection saymon
address your.saymonserver.com:1883
remote_username login
remote_password password
clientid your_name
try_private false
start_type automatic
topic # both ABCDEFG

где:

  • saymon - имя подключения
  • your.saymonserver.com:1883 - адрес вашего сервера SAYMON и порт MQTT-брокера
  • login - логин пользователя в MQTT-брокере
  • password - пароль пользователя в MQTT-брокере
  • your_name - ваше имя
  • # both ABCDEFG
    • # - все топики
    • both - отправляются на сервер и принимаются от сервера
    • ABCDEFG - с префиксом ABCDEFG (серийным номером контроллера)

С подробным описанием всех доступных опций конфигурирования можно ознакомиться в документации MQTT-брокера Mosquitto

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

service mosquitto restart

Вопросы и поддержка

После прочтения данной статьи у вас могли остаться какие-то вопросы, получить ответы на которые вы можете, обратившись в службу технической поддержки команды SAYMON - care@saymon.info.