====== Ресурсы ======

  * [[https://s3.fs.a0fs.ru/dist/config/zabbix/freebsd-template/aw.fbsd-mon-helper.tgz|Дистрибутив скриптов мониторинга]]
  * [[https://s3.fs.a0fs.ru/dist/config/zabbix/freebsd-template/zbx_export_templates.yaml|Шаблон для zabbix 7]]
  * [[https://repo.devel.a0fs.ru/ncc.zabbix_fbsd_templates/|Исходный код]]


====== Вопросы развёртывания ======
===== Установка =====
  - Убедиться что существует директория ''opt'': <code bash>mkdir -p /opt</code>
  - Выполнить распаковку архива: <code bash>
fetch -o - https://s3.fs.a0fs.ru/dist/config/zabbix/freebsd-template/aw.fbsd-mon-helper.tgz | tar -xvC /opt -f -
</code>
  - Активировать конфигурацию экземпляра: <code bash>cp /opt/aw.fbsd-mon-helper/config.dist.sh /opt/aw.fbsd-mon-helper/config.sh</code>
  - Прописать в ''crontab(5)'' запуск инструмента: <code bash>*/15  *   *    *     *  /bin/sh /opt/aw.fbsd-mon-helper/bin/lounch.sh</code> Естественно вместо ''${Случайное число от 0 до 59}'' требуется придумать число
  - Загрузить конфигурацию ''syslog'': <code bash>fetch -ao \
  /etc/syslog.d/warnmsg.conf \
  'https://s3.fs.a0fs.ru/dist/config/zabbix/freebsd-template/res/syslog_config/warnmsg.conf'</code>
  - Загрузить конфигурацию ''newsyslog'': <code bash>fetch -ao \
  /etc/newsyslog.conf.d/warnmsg.conf \
  'https://s3.fs.a0fs.ru/dist/config/zabbix/freebsd-template/res/newsyslogd_config/warnmsg.conf'</code>
  - Создать файл лога: <code bash>touch /var/log/warning_msg.log</code>
  - Перезапустить ''syslog'': <code>service syslogd reload</code>
  - Выполнить инициализацию данных по системе: <code bash>
/bin/sh /opt/aw.fbsd-mon-helper/bin/lounch.sh fast
</code>

===== Обновление =====
Для обновления следует удалить каталоги: 
  * ''/opt/aw.fbsd-mon-helper/bin''
  * ''/opt/aw.fbsd-mon-helper/lib''

для этого можно примерить команду: 
<code bash>
rm -fr /opt/aw.fbsd-mon-helper/bin /opt/aw.fbsd-mon-helper/lib
</code>
и распаковать дистрибутив поверх имеющегося экземпляра:
<code bash>
fetch -o - https://s3.fs.a0fs.ru/dist/config/zabbix/freebsd-template/aw.fbsd-mon-helper.tgz | tar -xvC /opt -f -
</code>

после чего обновить данные по системе
<code bash>
sh /opt/aw.fbsd-mon-helper/bin/lounch.sh fast
</code>

===== Конфигурирование =====
==== Базовая конфигурация ====
Предусмотрены следующие опции:
^ Опция ^ Описание ^
| ''ADMIN_MAIL'' | Адрес электронной почты администратора, на которую будут высылаться уведомления о состоянии обновления ОС |

Доступны следующие команды:
^ Команда ^ Аргумент ^ Описание ^
| ''add_pkg_mon'' | Имя пакета | Добавление пакета в список на детальный мониторинг. В качестве имени можно использовать всё, через что пакет может быть найден утилитой ''pkg'' |


==== Дополнительные возможности ====
Чтобы указать прокси-сервер, для закрытых контуров, необходимо в ''config.sh'' прописать следующее: 
<code bash>
export HTTP_PROXY="http://${proxy_ip}:3128"
export HTTPS_PROXY="$HTTP_PROXY"
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
</code>

где:
  * ''${proxy_ip}'' - IP прокси сервера
  * ''3128'' - порт HTTP прокси-сервсиа на данном сервере