Установка и настройка

Важно

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

Режим суперпользователя:

sudo -i

Важно

Установка производится на управляющий узел.

Установка

Установите модуль TIONIX.PointMeter из репозитория RPM-пакетов:

yum -y install python3-tionix_point_meter

Настройка

  1. Выполните первичную настройку модуля:

    openstack tnx configure -n tnx_point_meter
    
  2. Создайте каталог для лог-файлов с нужными правами:

    mkdir -p /var/log/tionix/pointmeter
    chown -R tionix:tionix /var/log/tionix/pointmeter
    
  3. Скопируйте образец конфигурационного файла, при использовании нестандартных параметров отредактируйте их (подробнее см. Файл конфигурации):

    cp /etc/tionix/point_meter.yaml.example /etc/tionix/point_meter.yaml
    
  4. Настройте параметр POINT_METER_API_URL в конфигурационном файле TIONIX.Dashboard (подробнее см. Файл конфигурации):

    echo "POINT_METER_API_URL: http://127.0.0.1:9367/" >> /etc/tionix/dashboard.yaml
    

    Где: http://127.0.0.1:9367/ - адрес узла с TIONIX.PointMeter.

  5. Включите и запустите службы systemd:

    systemctl daemon-reload
    systemctl enable tionix-point-meter-api.service
    systemctl start tionix-point-meter-api.service
    
  6. Перезапустите службы TIONIX:

    systemctl restart tionix-*
    

Файл конфигурации

Примечание

По умолчанию в файле point_meter.yaml.example строки с уровнем логирования нет, она указывается при необходимости. Уровень логирования по умолчанию выставлен в общем конфигурационном файле. Подробнее ознакомиться с файлами конфигурации можно в соответствующем разделе.

Конфигурационный файл представлен в yaml формате и состоит из следующих секций и параметров:

Параметр Описание Значение по умолчанию
DEBUG Логирование модуля с уровнем DEBUG. False
MAIL_SERVER Адрес почтового сервера. Для корректной отправки отчета необходимо, чтобы на почтовом сервере был включен доступ по протоколу IMAP или POP3. smtp.yandex.ru
MAIL_PORT Порт почтового сервера. 587
MAIL_USE_TLS Использование протокола TLS. True
MAIL_USE_SSL Использование протокола SSL. False
MAIL_USERNAME Учетная запись электронной почты, с которой будут автоматически отправляться отчеты. test@yandex.ru
MAIL_DEFAULT_SENDER Адрес электронной почты, с которой будут автоматически отправляться отчеты. test@yandex.ru
MAIL_PASSWORD Пароль от учетной записи почтового ящика, с которого будет автоматически отправляться отчет. *******
MAIL_ASCII_ATTACHMENTS Режим конвертации содержимого письма в формат ASCII. True
TIONIX_MAIL Адрес электронной почты, на который будут отправляться отчеты. Рекомендуется не менять. points@tionix.ru
TIONIX_CLIENTS Адрес электронной почты клиента, на который будут отправляться отчеты (в копии). Может быть несколько, разделенные через ;.  
CRON_SCHEDULE Расписание отправки отчета в формате Cron. С подробным описанием оформления можно ознакомиться на сайте документации Cron. 0 3 1 */1 *
TIME_ZONE Часовой пояс. Europe/Moscow

Важно

При изменении параметров файла конфигурации, для вступления их в силу необходимо произвести процедуру, описанную в разделе «Обновление файла конфигурации».